Vectorize

Vectorize — MCP のセットアップ

AI アシスタントを Vectorize に接続します。ラスター画像（PNG、JPG、…）をトレースして、ベクター描画（SVG、PDF、EPS、DXF）に変換できます。接続には、ホスト型の Model Context Protocol（MCP） サーバーを使用します。dudko.dev アカウントで一度サインインすれば、API キーを貼り付ける必要はありません。

このサーバーは Vectorize HTTP API への入り口であり、トレーサーではありません。画像がモデルやサーバーを経由することはありません。アシスタントがリクエストを取得し、画像がある場所で実行します。

• サーバー： vectorize
• トランスポート： ストリーミング可能な HTTP
• URL： https://vectorize.dudko.dev/mcp
• 認証： auth.dudko.dev 経由の OAuth 2.1 — サインインを求められます。

できること

3 つのツールをすべて無料で利用できます。

ツール	説明
api_access	Vectorize API の仕組みを確認できます。
trace_options	プリセット（写真、ポスター、白黒）、オプション、制限を確認できます。
api_request	トレースオプションを確認し、正確なリクエスト（URL、ヘッダー、curl コマンド）を、アカウント用の 15 分間有効な認証情報とともに返します。出力形式：svg、pdf、eps、dxf、json。

---

Claude Code にインストールする（プラグイン）

/plugin marketplace add dudko-dev/vectorize-mcp-setup
/plugin install vectorize@vectorize
/reload-plugins

次に /mcp を実行し、プロンプトが表示されたらサインインを完了します。

マーケットプレイスを使わない場合は、サーバーを直接追加できます。

claude mcp add --transport http vectorize https://vectorize.dudko.dev/mcp

---

他のクライアントから接続する

リモート URL とサインイン方法は同じです。異なるのは設定ファイルの場所だけです。

Claude Desktop / claude.ai コネクター

1. Settings → Connectors → Add custom connector を開きます。
2. 名前：Vectorize
3. URL：https://vectorize.dudko.dev/mcp
4. 保存し、接続して、プロンプトが表示されたらサインインします。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）：

{
  "mcpServers": {
    "vectorize": {
      "url": "https://vectorize.dudko.dev/mcp"
    }
  }
}

VS Code（GitHub Copilot / MCP）およびその他のクライアント

{
  "servers": {
    "vectorize": {
      "type": "http",
      "url": "https://vectorize.dudko.dev/mcp"
    }
  }
}

---

認証

このサーバーは OAuth 2.1 リソースサーバーです。最初の呼び出しでは、保護されたリソースのメタデータを示す WWW-Authenticate ヘッダーとともに 401 が返されます。

• https://vectorize.dudko.dev/.well-known/oauth-protected-resource/mcp

このメタデータでは、認可サーバーとして https://auth.dudko.dev が指定されています（スコープ：usage）。準拠した MCP クライアントであれば、これを自動的に検出します。サーバー URL だけを指定すればよく、dudko.dev アカウントでサインインします。トークンは https://vectorize.dudko.dev/mcp を対象として発行され、それ以外の場所では拒否されます。

サーバー自体には ファイルもコンテンツもありません。そのツールは、サインインに使用したアカウント用の短期間有効な認証情報（15 分間有効、この API 専用）を含む、実行可能な HTTP リクエストを返します。アシスタントはファイルがある場所でそのリクエストを実行し、API は呼び出し元に直接応答します。各リクエストは他の API 呼び出しと同様にアカウントのプラン使用量に計上されます。MCP ツール自体は無料です。

---

トラブルシューティング

• 401 / 再度サインインを求められる — トークンの有効期限が切れています。クライアントで再接続してください。
• 「plan used up」 / 402 — アカウントのトレース割り当て量を使い切っています。再試行しても解決しません。https://auth.dudko.dev/account をご覧ください。
• ツールが表示されない — クライアントでサインインが完了していることを確認してください（Claude Code では /mcp に connected と表示されます）。

サポート

• ウェブサイト：https://vectorize.dudko.dev
• API ドキュメント：https://vectorize.dudko.dev/api
• エージェント向け：https://vectorize.dudko.dev/llms.txt
• お問い合わせ：[email protected]