내용으로 건너뛰기

AI 도우미로부터 ZPL 렌더링

OpenZPL은 모델 컨텍스트 프로토콜을 사용합니다. Claude, Cursor 또는 모든 MCP 클라이언트를 연결하면 ZPL 레이블을 PNG 또는 PDF로 변환할 수 있습니다 — 채팅 내에서. 키나 계정이 필요 없습니다.

https://api.openzpl.com/mcp

도우미에 추가하세요

서버는 원격이며 상태가 없는 HTTP를 사용합니다. 클라이언트가 원격 MCP 서버를 추가하는 방식으로 추가하세요:

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

그럼 물어보세요: “이 ZPL을 렌더링하고 레이블을 보여줘.”

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

이것을 고객의 MCP 구성에 추가하세요, 예: Cursor의 ~/.cursor/mcp.json.

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

로컬 (stdio) 서버만 실행하는 클라이언트를 위해, 이 브릿지는 원격 엔드포인트에 연결합니다.

할 수 있는 기능

렌더 전용 도구 3개가 API 및 뷰어와 동일한 엔진으로 지원됩니다. 주어진 ZPL을 렌더링하지만 레이블을 디자인하지는 않습니다.

도구그 기능
render_zpl레이블을 PNG 이미지로 렌더링하고 표시합니다.
zpl_to_pdfZPL을 PDF로 렌더링하며, 레이블당 한 페이지로 출력됩니다.
preview_url브라우저에서 열면 레이블을 렌더링하는 공유 가능한 링크를 생성합니다.

각 도구는 zpl과 선택적 dpmm (6, 8, 12 또는 24), 인치 단위의 width_in / height_in 및 rotation을 사용합니다.

curl로 시도해 보세요

엔드포인트는 일반 JSON-RPC 2.0이므로 도우미 없이도 호출할 수 있습니다:

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

무료, 워터마크 포함

MCP에서의 렌더링은 익명이며 무료로 제공되므로, 각 렌더링에는 모서리에 작은 openzpl.com · free plan 박스가 있으며, IP 주소별로 API의 동일한 일일 허용량에 포함됩니다. 깨끗한 렌더링과 더 높은 한도를 원하시면 pricing를 참조하세요; MCP에 대한 유료 플랜이 곧 출시됩니다.

질문

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이 저장되었나요?

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

HTTP API docs 및 comparison with mylabelmaker도 참조하세요.

피드백