Pular para o conteúdo

Renderizar ZPL do seu assistente de IA

OpenZPL fala o Protocolo de Contexto do Modelo. Conecte Claude, Cursor ou qualquer cliente MCP e ele pode transformar um rótulo ZPL em um PNG ou PDF — diretamente no chat. Sem chave, sem conta.

https://api.openzpl.com/mcp

Adicione ao seu assistente

O servidor é remoto e sem estado, via HTTP. Adicione-o da mesma forma que seu cliente adiciona um servidor MCP remoto:

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

Então pergunte: “renderize este ZPL e me mostre o rótulo”.

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

Adicione isso à configuração MCP do seu cliente, como a do Cursor ~/.cursor/mcp.json.

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

Para um cliente que executa apenas servidores locais (stdio), esta ponte o conecta ao ponto de extremidade remoto.

O que ele pode fazer

Três ferramentas apenas para renderização, apoiadas pelo mesmo motor que a API e o visualizador. Ela rende o ZPL que você fornece; não projeta o rótulo para você.

FerramentaO que faz
render_zplRenderiza um rótulo para uma imagem PNG e a exibe.
zpl_to_pdfRenderiza o ZPL para um PDF, uma página por rótulo.
preview_urlConstrói um link compartilhável que rende o rótulo quando aberto em um navegador.

Cada ferramenta aceita o zpl, e opcionalmente dpmm (6, 8, 12 ou 24), width_in / height_in em polegadas e rotation.

Experimente com cURL

O ponto de extremidade é um JSON-RPC 2.0 simples, então você pode chamá-lo sem um assistente também:

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"}}}'

Gratuito, com uma marca d'água

Renderizações sobre MCP são anônimas e gratuitas, portanto cada uma carrega uma pequena caixa openzpl.com · free plan em um canto e conta contra o mesmo limite diário que a API, por endereço IP. Para renderizações limpas e limites maiores, veja pricing; um plano pago sobre MCP está a caminho.

Perguntas

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.

Meu ZPL está armazenado?

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

Veja também o HTTP API docs e comparison with mylabelmaker.

Feedback