MCP・API
Claude CodeなどのAIやプログラムから、図面を読む・探す・描く・直す・変換する。zumen-gateと同じ変換エンジンを、MCPサーバーとAPIで使えます。
できること
- 読む: 図面の形式・用紙と縮尺・画層ごとの要素の数・文字などの概要を、AIに渡せる形で返します
- 探す: 画層・種類・文字・範囲で要素を絞り込み、長さや面積を実寸で返します(数量の拾いなど)
- 描く: 指定した範囲を画像にして返します。AIが自分の作業の結果を目で確かめられます
- 変換する: DXF・PDF・SVGに加えて、JWW・DWG・SXFへの書き出し。読める形式はWeb版と同じです
- 直す: 図面を中間の形(IR)で手元に置き、文字の置き換えや画層・色の変更をしてから、JWWなどの元の形式に戻せます
使い方
- Web・デスクトップ・スマホのClaudeからは、コネクタとして追加するだけで使えます(インストール不要。「Claude」のタブ)
- MCPに対応したAI(Claude Code・Claude Desktop・Cursorなど)からは、MCPサーバー zumen-gate-mcp で使えます。同じことができるコマンドラインツール(zumen-gate)も入っています。どちらも手元のPCで動き、読み取りと変換はzumen-gateのサーバーで行います(「MCPサーバー」のタブ)
- プログラムからはREST API(https://api.zumen-gate.com)で使えます。APIキーは無料の登録で、アカウント画面から発行できます(「REST API」のタブ)
- サーバーでは生成AIを使いません。どの呼び出しにも、変換エンジンが決まった計算で答えます
Claude(Web・デスクトップ・スマホ)から使う
claude.aiにコネクタとして追加すると、インストールなしで、ブラウザやスマホのClaudeから図面を読む・探す・描く・直す・変換できます。
- 「Claudeに追加」を押すと、claude.aiのコネクタの追加の画面が、名前(zumen-gate)とURLが入った状態で開きます。「続ける」を押し、次の画面は設定を変えずに「追加」を押します
- 「連携」を押すとzumen-gateの画面が開きます。メールに届く6桁のコードでログインして、許可します(アカウントが無ければ、その場で作れます)
- チャットで「図面をアップロードしたい」と頼むと、アップロードのリンクが出ます。図面を送ったら、Claudeに「アップロードした」と伝えます
- あとは「壁の線の長さを拾って」「この文字を直してJWWで書き出して」のように頼みます。出力はダウンロードのリンクで受け取ります
手で追加するときのURL(認証はOAuthで、ほかの設定は要りません):
https://api.zumen-gate.com/mcp- Claudeの無料プランでも使えます(カスタムコネクタは1つまで)。スマホのアプリでも使えますが、追加はWebかデスクトップのアプリで行ってください
- チャットに添付したファイルはコネクタに渡りません。図面はアップロードのリンクから送ってください
- 受け取った図面は受け取りから24時間で使えなくなり、その後自動で削除されます。「図面を消して」と頼めば、すぐに消せます
- 回数はAPIキーと同じく、アカウントの残りから引きます(読む・探す・描く・変換は1回、JWW・DWG・SXF・STEPへの書き出しは10回分。直すのは初回だけ1回)
- 接続はアカウント画面の「API・MCP」からいつでも切れます。Team・Enterpriseでは、組織のオーナーがコネクタを追加してから、各自がつなぎます
MCPサーバーの入れ方
# Claude Code(zg_live_… は発行したキー)
claude mcp add zumen-gate -e ZUMEN_GATE_API_KEY=zg_live_… -- uvx zumen-gate-mcp --root .
# Claude Desktop(claude_desktop_config.json)・Cursor(.cursor/mcp.json)など
{
"mcpServers": {
"zumen-gate": {
"command": "uvx",
"args": ["zumen-gate-mcp", "--root", "C:/Users/me/図面"],
"env": { "ZUMEN_GATE_API_KEY": "zg_live_…" }
}
}
}- uv(Pythonのツールを動かす道具)が要ります。uvxが必要なものを取り寄せて起動します
- --rootは図面のフォルダです。読むのはこの中のファイルだけで、出力はその中のzumen-gate-outに書きます。元の図面は書き換えません
- ツールは8つです。概要・探す・描く・直す・変換に加えて、対応形式の一覧・長い変換の状態・残りの回数。直すのは手元で行い、回数を使いません(初回だけ、図面を取り寄せる1回)
- 同じことはコマンドラインツールでもできます(例: zumen-gate convert *.jww --to dxf)
Codex・VS Codeなどの入れ方と、詳しい使い方はGitHubのREADMEをご覧ください。
REST API
POST /v1/inspect | 概要(形式・用紙と縮尺・座標の単位・画層ごとの数・文字の見本・読めなかったもの) | 1回 |
POST /v1/query | 画層・種類・文字・範囲・IDで絞った要素の一覧と、長さ・面積の合計(実寸のmm) | 1回 |
POST /v1/render | 範囲・画層・強調する要素を指定したPNGと、画素と図面の座標の対応 | 1回 |
POST /v1/convert | 変換。出力はGET /v1/files/…から取ります。中間の形(ir)も選べます | 1回(JWW・DWG・SXF・STEPは10回分) |
GET /v1/usage | 残りの回数と期限、今月の利用 | 0回 |
GET /v1/formats | 対応形式の一覧(キー不要) | 0回 |
export ZUMEN_GATE_API_KEY=zg_live_… # アカウント画面で発行
# 概要
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww https://api.zumen-gate.com/v1/inspect
# 画層「壁」の線を探す(長さの合計は実寸の mm でも返る)
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww -F 'params={"layer":"壁","kind":"LINE"}' \
https://api.zumen-gate.com/v1/query
# DXF に変換して、出力を取る
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" \
-F file=@plan.jww -F target_format=dxf https://api.zumen-gate.com/v1/convert
curl -H "Authorization: Bearer $ZUMEN_GATE_API_KEY" -o plan.dxf \
-L https://api.zumen-gate.com/v1/files/<job_id>/plan.dxf- 送るのはmultipartで、図面ファイル(file)か中間の形(ir)のどちらか1つと、呼び出しごとの欄(paramsはJSON)です
- 応答には毎回、今回数えた回数と残り(usage)が入ります
- 同じアカウントで同時に動かせる呼び出しは1本です(2本目は429)。失敗した呼び出しは数えません
- 呼び出しの速さにも上限があります。1つのアカウントで1分あたり120回まで、出力の受け取りなども含めた同時の接続は2本まで、誤ったAPIキーは同じ接続元から1分あたり10回までです
- 429と503のときは、Retry-Afterの秒数だけ待ってから送り直してください。それ以外の失敗は、同じ内容で送り直しても結果は変わりません。自動で送り直さないでください
- 長い変換は stream=1 で、進み具合を流しながら最長300秒まで待てます
- PDFへの変換に pdf_paper=1 を付けると、JWW・SFC・P21では1ページ目が図面の用紙の実寸になります(倍率100%で印刷すると縮尺どおり)。付けなければ、図面全体を1ページに収めます
- 出力のファイル(GET /v1/files/…)は、保存先の一時的なURLへの転送(307)で返ります。curlでは -L を付けてください。転送先にAPIキーは要りません
- SLA(稼働の約束)はなく、無保証で提供します。変換結果の正確性は保証されないため、重要な用途では結果を確かめてください(利用規約第2条)
見本の図面で試す
手元に図面が無くても、自作の見本で試せます。住宅の1階平面図です(Jw_cadのJWW、縮尺1/100、A3、37KB)。
- Claudeでは、アップロードのリンクからこの図面を送り、「縮尺と部屋の一覧を教えて」「開き戸の数と幅を、根拠つきの表にして」「開き戸を強調した画像を見せて」のように頼んでみてください
- MCPサーバーなら--rootのフォルダに置き、REST APIなら「REST API」のタブの例のplan.jwwの代わりに送ります
- 自作の図面で、実在の建物やお客様の図面ではありません
料金
| 無料(登録が必要) | 月300回。読む・探す・描く・DXF/PDF/SVGへの変換 |
|---|---|
| 追加の枠 | ¥980 / 1,000回(買い切り・購入から180日間) |
| 単発パス(¥480) | 24時間で1,500回分を含みます |
| Pro(月額) | 月3,000回分を含みます |
- 数えるのはAPIの呼び出しの回数です。対応形式の一覧・残りの確認・失敗した呼び出しは数えません
- JWW・DWG・SXF・STEPへの書き出しは1回で10回分です。月の無料の回数からは引かず、追加の枠・単発パス・Proの分から引きます。Web版と同じく、結果のプレビューとロスレポートは先に見られます
- 10MBを超える図面は、追加の枠・単発パス・Proの分でお使いいただけます
- 金額は税込です。月の無料の回数は毎月1日(日本時間)に戻ります。追加の枠は、お支払いの確認後すぐに付与します
データの扱い
- MCPサーバー・コマンドラインツール・APIで送られた図面は、プランにかかわらず機械学習には使いません
- 入力ファイルは処理の後に保存しません。出力ファイルは有償プランと同じく、短い期間の後に自動で削除します
- Claudeなどのコネクタ(リモートのMCP)で受け取った図面と、その編集の作業用のコピーは、続けて使えるようにzumen-gateのサーバーに置きます。受け取りから24時間で使えなくなり、その後おおむね1日以内に自動で削除します。いつでも削除できます
- AIに渡るのは、MCPサーバーが返す概要・絞り込んだ要素・画像だけです。図面ファイルそのものをAIのサービスに送る必要はありません
通常の変換のデータの扱いはデータの取り扱いをご覧ください。
AIの導入支援(法人向け)
MCPを含めて、図面を扱う業務にAIを取り入れるお手伝いをします。数量の拾い、図面の一括の整理、取引先の形式での返却などが例です。
- 相談(30分): 無料
- 試行(2〜4週間): ¥300,000〜。お客様の図面で、AIに任せたい業務を実際に試し、結果をご報告します
- 導入: ¥600,000〜¥1,200,000。手順書と、AIに渡す指示(スキル)を業務に合わせて整えて納めます
- 同時にお受けするのは1件まで、返信は2営業日以内です
- 常駐、システム開発一式、図面のトレース代行は含みません
金額は目安で、内容を伺ってから個別にお見積りします。自社のサービスや社内システムに変換を組み込みたい場合(年額・請求書払い)も、こちらからご相談ください。