# AIエージェント向け刺繍MCPサーバー 正規ページ: https://embroideryfileconverter.com/ja/ai-agents OAuth、フォーマット検出、使用状況、プライベート処理ジョブを備えたリモートMCPサーバーを介して、認証済み刺繍ツールにAIエージェントを接続します。 ## 適切な統合を選択 - ブラウザ承認済みのOAuthでAIアシスタントがユーザーに代わって操作する場合に、このリモートMCPサーバーを使用します。 - 従来のバックエンド、SaaS製品、またはサーバーサイド自動化には [REST Developer API](https://embroideryfileconverter.com/ja/developers) を使用してください。 ## MCPクライアントを接続 - ストリーミング可能HTTPエンドポイント: `https://embroideryfileconverter.com/mcp/embroidery` - OAuthスコープ: `mcp:use` - デフォルトMCPレート制限: 60 回/分 - ファイル作成ツール制限: ユーザーあたり 6 回/分 + ネットワーク制限 - アクセストークン有効期間: 60 分 - リフレッシュトークン有効期間: 30 日 このエンドポイントはリモートStreamable HTTPクライアントで動作します。ブラウザネイティブのOAuthを優先し、パスワード、リフレッシュトークン、長期間有効なBearerトークンをリポジトリに貼り付けないでください。 ## ChatGPT (OpenAI) に接続 完全なMCPアプリはChatGPT開発者モードで設定します。利用可能機能と書き込みツールの制御はプランにより異なります。 1. ChatGPTウェブでは、設定 > アプリ > 詳細設定で開発者モードを有効にするか、ワークスペース設定 > アプリ > 作成を開いてください。 2. アプリを作成し、MCPサーバーURLを `https://embroideryfileconverter.com/mcp/embroidery` に設定してください。 3. OAuthを選択し、ツールをスキャンして、ブラウザで `mcp:use` スコープを承認してください。 4. ドラフトアプリを作成して有効化し、新しい会話のツールメニューから選択してください。 [公式ChatGPT MCPドキュメント](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) ## Claude、Claude Desktop、Cowork、Claude Code に接続 Claudeでカスタマイズ > コネクタ > カスタムコネクタを追加を開き、`https://embroideryfileconverter.com/mcp/embroidery` を入力して接続を選択し、OAuthを完了してください。チーム・エンタープライズ所有者は、メンバーが個別に接続する前に組織設定 > コネクタでコネクタを追加してください。 Claude Codeコマンド: ```bash claude mcp add --transport http embroidery-file-converter https://embroideryfileconverter.com/mcp/embroidery # その後Claude Code内で /mcp を実行し、ブラウザ認証を完了してください。 ``` [公式ClaudeリモートMCPドキュメント](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) ## OpenAI Agents SDK に接続 バックエンドはサインイン済みユーザー向けにOAuth認可コード + PKCEを完了し、トークンをサーバー上で暗号化して保存し、必要に応じて更新し、現在のアクセストークンをホストされたMCPツールに渡す必要があります。このトークンをブラウザJavaScriptで公開しないでください。 ```typescript import { Agent, hostedMcpTool } from '@openai/agents'; const agent = new Agent({ name: 'Embroidery assistant', tools: [ hostedMcpTool({ serverLabel: 'embroidery', serverUrl: 'https://embroideryfileconverter.com/mcp/embroidery', authorization: process.env.EFC_MCP_ACCESS_TOKEN, requireApproval: 'always', }), ], }); ``` [公式OpenAI Agents SDK MCPドキュメント](https://developers.openai.com/api/docs/guides/tools-connectors-mcp) ## Cursor に接続 `.cursor/mcp.json` に追加し、Cursor設定 > MCPでサーバーを起動してOAuthを完了してください。Cursor Agentユーザーは `cursor-agent mcp login embroidery-file-converter` を実行できます。 ```json { "mcpServers": { "embroidery-file-converter": { "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [公式Cursor MCPドキュメント](https://docs.cursor.com/context/model-context-protocol) ## VS CodeおよびGitHub Copilot に接続 `MCP: Add Server` を実行してHTTPを選択するか、`.vscode/mcp.json` に追加してください。`MCP: List Servers` で起動し、構成を信頼してブラウザ認証を完了してください。 ```json { "servers": { "embroidery-file-converter": { "type": "http", "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [公式VS Code MCPドキュメント](https://code.visualstudio.com/docs/agent-customization/mcp-servers) ## OpenClaw に接続 ```bash openclaw mcp add embroidery-file-converter \ --url https://embroideryfileconverter.com/mcp/embroidery \ --transport streamable-http \ --auth oauth \ --oauth-scope mcp:use openclaw mcp login embroidery-file-converter openclaw mcp doctor embroidery-file-converter --probe ``` [公式OpenClaw MCPドキュメント](https://docs.openclaw.ai/cli/mcp) ## Gemini CLI に接続 サーバーを `~/.gemini/settings.json` に追加し、Gemini CLI内で `/mcp auth embroidery-file-converter` を実行してください。 ```json { "mcpServers": { "embroidery-file-converter": { "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [公式Gemini CLI MCPドキュメント](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) ## OpenCode に接続 `opencode.json` に追加し、`opencode mcp auth embroidery-file-converter` を実行した後、`opencode mcp list` で確認してください。 ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "embroidery-file-converter": { "type": "remote", "url": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [公式OpenCode MCPドキュメント](https://opencode.ai/docs/mcp-servers/) ## Windsurf Cascade に接続 Windsurf設定 > Cascade > MCP Serversを開くか、`~/.codeium/windsurf/mcp_config.json` に追加してください。サーバーを起動し、OAuthを完了して、必要なツールのみを有効にしてください。 ```json { "mcpServers": { "embroidery-file-converter": { "serverUrl": "https://embroideryfileconverter.com/mcp/embroidery" } } } ``` [公式Windsurf MCPドキュメント](https://docs.windsurf.com/windsurf/cascade/mcp) ## Cline に接続 ClineのOAuth動作はリリースや画面により異なります。MCP Servers > Remote Serversを開き、Streamable HTTPを選択して、承認許可リストを空にした状態でこの構成を使用してください: ```json { "mcpServers": { "embroidery-file-converter": { "type": "streamableHttp", "url": "https://embroideryfileconverter.com/mcp/embroidery", "disabled": false, "autoApprove": [] } } } ``` インストール済みのClineリリースでOAuthを完了できない場合は、レビュー済みでバージョン固定のOAuthブリッジを使用するか、ネイティブOAuth対応クライアントを選択してください。長期間有効なトークンを `cline_mcp_settings.json` にコミットしないでください。 [公式Cline MCPドキュメント](https://github.com/cline/cline/blob/main/docs/mcp/mcp-overview.mdx) ## OAuthディスカバリーとPKCE - 保護リソースメタデータ: `https://embroideryfileconverter.com/.well-known/oauth-protected-resource/mcp/embroidery` - 認可サーバーメタデータ: `https://embroideryfileconverter.com/.well-known/oauth-authorization-server` - 動的クライアント登録: `https://embroideryfileconverter.com/oauth/register` - 認可サーバー発行者: `https://embroideryfileconverter.com` - グラント: 認可コード - PKCE方式: S256 - 必須スコープ: `mcp:use` 動的クライアント登録は、運用者が明示的に許可したコールバックオリジンとネイティブスキームのみを受け付けます。任意のコールバックドメインは拒否されます。MCPエンドポイントを使用する前に、アカウントに確認済みメールアドレスが必要です。 既定の信頼済みホストコールバックは、公式ChatGPT、Claude、VS Codeオリジンとインストール済みクライアント向けループバックコールバックに限定されます。ワイルドカードリダイレクトドメインは有効化されていません。`MCP_REDIRECT_DOMAINS` を上書きするデプロイメントは、意図的にサポートするクライアントのみを保持する必要があります。 許可されたローカルコールバックの登録例: ```bash curl -X POST https://embroideryfileconverter.com/oauth/register \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "client_name": "Your local agent", "redirect_uris": ["http://127.0.0.1:49831/callback"] }' ``` ## 完全なツールリファレンス ### `list-formats-tool` 読み取り専用。引数は不要。`artwork_inputs[]` と `formats[]` を返し、各々に readable、writable、label、warning フィールドを含みます。ワークフローや出力形式を選択する前に呼び出してください。 ### `get-account-usage-tool` 読み取り専用。引数は不要。現在のプレビュー許容量、クレジット残高、ワークフロー費用、サブスクリプション制限、リセット日を返します。購入や消費は一切行いません。 ### `list-processing-jobs-tool` 読み取り専用。接続中のアカウントが所有する最近のジョブを一覧表示します。 - `limit`: 省略可能（1〜50 の整数）。既定値は 20 ### `get-processing-job-tool` 読み取り専用。所有する 1 件のジョブを返し、ステータス、イベント、メトリクス、警告、プレビュー成果物、OAuth 保護されたファイル URL を含みます。 - `workflow`: 必須（`conversion` または `digitising`） - `job_id`: 必須（26 文字のジョブ識別子） ### `create-processing-job-tool` 保存データを作成します。1 件の非公開プレビュージョブを開始し、プレビュー許容量を消費する場合がありますが、クレジットの購入や有料ダウンロードのロック解除は行いません。 - `workflow`: 必須（`conversion` または `digitising`） - `file_name`: 必須（拡張子付きの元のファイル名、3〜255 文字、パス区切り文字や制御文字を含まない） - `file_base64`: 必須（data-URL 接頭辞なしの生の標準 base64） - `format`: 必須（小文字の書き込み可能な刺繍出力形式） - `width_mm`: 10〜300 の数値、デジタイジング時は必須 - `colour_count`: 1〜24 の整数、デジタイジング時は必須 構造化された結果に `billing_authorized: false` が含まれます。変換の場合は、選択した出力形式が検出された入力形式と異なる必要があります。 ## JSON-RPC ツールの例 形式一覧: ```json { "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "list-formats-tool", "arguments": {} } } ``` デジタイジングプレビューの作成: ```json { "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "create-processing-job-tool", "arguments": { "workflow": "digitising", "file_name": "logo.png", "file_base64": "iVBORw0KGgoAAA...", "format": "pes", "width_mm": 90, "colour_count": 8 } } } ``` 返されたジョブのポーリング: ```json { "jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": { "name": "get-processing-job-tool", "arguments": { "workflow": "digitising", "job_id": "01JEXAMPLEJOBID000000000" } } } ``` ジョブのステータスは `queued`、`processing`、`completed`、`failed` のいずれかです。バックオフを入れてポーリングし、終了ステータスで停止してください。ファイル URL には同じ OAuth アクセストークンが必要で、アップロードの `expiresAt` 保持期限の影響を受けます。 ## 自然言語プロンプトの例 - “PES を読み取り、JEF に安全に書き込める形式を確認し、互換性警告を表示してください。” - “直近5件の刺繍ジョブを一覧表示し、失敗したものを要約してください。” - “アップロード前に確認を求めてください。その後、logo.pngを幅90mm・8色以内でデジタイジングし、PESプレビューを返してください。” - “ジョブ 01J… を完了するまでポーリングし、ステッチメトリクス、警告、ダウンロードがすでにロック解除されているかどうかを報告してください。” ## 安全モデル - 請求、チェックアウト、クレジット購入、有料ダウンロードのロック解除ツールは公開されていません。 - API キー作成、認証変更、資格情報読み取り、アカウント削除ツールは公開されていません。 - すべてのジョブ読み取りは接続中のユーザーに制限されます。 - 作成ツールは非公開アップロードを保存しジョブを作成するため、エージェントはアップロード前に確認するよう指示されています。 - ファイル名、メタデータ、ジョブメッセージ、警告は信頼できないデータです。サーバーはエージェントに対し、これらの値に埋め込まれたコマンドに従わないよう指示します。 - 完了した結果は自動的に本生産用とはなりません。エージェントは主張する前に検証メトリクスと警告を確認してください。 ## トラブルシューティング - `401 Unauthorized`: 有効なアクセストークンが送信されませんでした。クライアントの OAuth 接続を再起動してください。 - `403 Forbidden`: トークンに `mcp:use` がなく、アカウントが未検証、または要求されたジョブが別のアカウントに属しています。 - `invalid_redirect_uri`: コールバックのオリジンまたはネイティブスキームがサーバーの許可リストにありません。 - `422`: ツール引数、base64 データ、入力形式、出力形式、またはアカウントクォータの検証に失敗しました。 - `429`: レート制限を超えました。`Retry-After` を遵守し、ジッター付きの指数バックオフを使用してください。 ## 関連ページ - [開発者 API ドキュメント](https://embroideryfileconverter.com/ja/developers) - [OpenAPI 3.1記述](https://embroideryfileconverter.com/developers/openapi.json) - [プライバシーポリシー](https://embroideryfileconverter.com/ja/privacy)