İçeriğe atla

AI asistanınızdan ZPL render edin

OpenZPL Model Bağlam Protokolü ile iletişim kurar. Claude, Cursor veya herhangi bir MCP istemcisi ile bağlandığınızda, ZPL etiketini bir PNG veya PDF'ye dönüştürebilir — tam olarak sohbet içinde. Anahtar yok, hesap yok.

https://api.openzpl.com/mcp

Asistana ekle

Sunucu uzakta ve durumsuzdur, HTTP üzerinden. Bunu istemcinizin uzaktaki bir MCP sunucusunu eklediği gibi ekleyin:

claude mcp add --transport http openzpl https://api.openzpl.com/mcp

Sonra şunu sorabilirsiniz: “bu ZPL'yi render et ve bana etiketi göster”.

{
  "mcpServers": {
    "openzpl": { "url": "https://api.openzpl.com/mcp" }
  }
}

Bunu müşterinizin MCP yapılandırmasına ekleyin, örneğin Cursor'ın ~/.cursor/mcp.json gibi.

npx -y mcp-remote https://api.openzpl.com/mcp

Yalnızca yerel (stdio) sunucuları çalıştıran bir istemci için bu köprü onu uzaktaki uç noktaya bağlar.

Ne yapabilir

Yalnızca render yapan üç araç, API ve görüntüleyici ile aynı motor tarafından desteklenmektedir. Size verilen ZPL'yi render eder; sizin için etiketi tasarlamaz.

AraçNe yaptığı
render_zplBir etiketi PNG görüntüsüne render eder ve gösterir.
zpl_to_pdfZPL'yi bir PDF'ye render eder, her etiket için bir sayfa.
preview_urlBir tarayıcıda açıldığında etiketi render eden paylaşılebilir bir bağlantı oluşturur.

Her araç zpl alır ve isteğe bağlı dpmm (6, 8, 12 veya 24), width_in / height_in inç ve rotation alır.

Bunu curl ile deneyin

Uç nokta düz JSON-RPC 2.0'dır, bu nedenle onu bir asistansız da arayabilirsiniz:

curl -s https://api.openzpl.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"render_zpl",
                 "arguments":{"zpl":"^XA^FO50,50^ADN,36,20^FDHi^FS^XZ"}}}'

Ücretsiz, bir filigran ile

MCP üzerinden renderlar anonim ve ücretsizdir, bu nedenle her biri köşede küçük bir openzpl.com · free plan kutusu taşır ve API ile aynı günlük kota üzerinden sayılır, IP adresi başına. Temiz renderlar ve daha yüksek limitler için pricing'e bakın; MCP üzerinde bir ücretli plan geliyor.

Sorular

Do I need an API key or an account?

No. The MCP server is free and needs no account. Renders use the free plan, so they carry a small openzpl.com mark and count against the same daily allowance as the API, per IP address.

Which assistants can use it?

Any client that speaks the Model Context Protocol over HTTP, such as Claude or Cursor. Point it at https://api.openzpl.com/mcp; for a client that only runs local servers, bridge it with npx mcp-remote https://api.openzpl.com/mcp.

What can it do?

Three tools: render a label to a PNG image, render it to a PDF, or build a shareable preview link. It renders the ZPL you give it; it doesn't design the label for you.

ZPL'im saklanıyor mu?

No. The label is rendered and returned; the server doesn't keep the ZPL.

Ayrıca HTTP API docs ve comparison with mylabelmaker'ye de bakın.

Geri bildirim