リモートMCP · v1.0OAuth 2.1 + PKCE

AIエージェントに 刺繍ツールを提供。

アシスタントを形式検出、アカウント使用状況、非公開処理ジョブに接続します。ユーザーに代わり、ブラウザ承認のみで課金や認証情報ツールは提供しません。

ストリーミング可能HTTPエンドポイント

https://embroideryfileconverter.com/mcp/embroidery

ツール

5

スコープ

mcp:use

読み取りレート

60/min

ユーザーはブラウザでサインイン、メール確認、アクセス承認を行います。エージェントはスコープ付きトークンを受け取り、ユーザーのパスワードやAPIキーは受け取りません。

クライアント互換性

使用するエージェントを選択し、セットアップをコピーしてください。

以下のガイドをChatGPT、Claude、OpenAI Agents SDK、Cursor、VS Code、OpenClaw、Gemini CLI、OpenCode、Windsurf、Cline向けに使用してください。各ガイドはOAuthがネイティブか、開発者管理か、または審査済みブリッジが必要かを示しています。

OpenAI logo
ネイティブOAuthChatGPT web · 設定 → アプリ

ChatGPT を接続

ChatGPT開発者モードでカスタムMCPアプリを作成し、ChatGPTにツールとOAuthメタデータを検出させます。

  1. 1設定 → アプリ → 詳細設定で開発者モードを有効にするか、ワークスペース設定 → アプリ → 作成を開きます。
  2. 2アプリを作成し、MCPエンドポイントを貼り付け、OAuth認証を選択します。
  3. 3ツールをスキャンし、ブラウザでアクセスを承認してから、下書きアプリを作成して有効にします。
公式 ChatGPT MCPドキュメント
ChatGPT の設定 · 接続値
MCP server URL: https://embroideryfileconverter.com/mcp/embroidery
Authentication: OAuth
Required scope: mcp:use

ブラウザOAuthを使用し、次のスコープのみを要求 mcp:use. パスワード、リフレッシュトークン、または長期間有効なbearerトークンをリポジトリに配置しないでください。

完全な書き込みツールサポートはChatGPT BusinessおよびEnterprise/Eduワークスペース向けです。利用可能性と管理制御はプランにより異なります。

Streamable HTTPOAuth認可コード + PKCEユーザーごとの非公開データ

クライアントがOAuthを開けない場合

リモートStreamable HTTP MCPサーバーと保護リソース検出をサポートしていることを確認してください。ローカルのstdio専用クライアントは、互換性のあるブリッジなしではこのホストエンドポイントに接続できません。

認可

OAuth認可コード + PKCE。

サーバーは標準ベースのメタデータを公開し、S256 PKCEを要求し、1つの最小権限スコープを提供します。動的登録はオペレーターが許可したコールバック起点とネイティブスキームでのみ利用可能です。

保護リソース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
必須スコープmcp:use
プロトコルレベル例 · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "Your agent",
      "version": "1.0.0"
    }
  }
}

短期間アクセス

アクセストークンは60分で期限切れ、リフレッシュトークンは30日で期限切れになり、失効可能です。

認証済みアカウントが必要

有効なトークンには mcp:use, が含まれ、接続されたユーザーはメールアドレスを確認済みである必要があります。

ツール一覧

5つのツールと明確な境界。

list-formats-tool

読み取り可能な刺繍ソース、書き込み可能なマシン出力、アートワーク入力タイプ、互換性警告を一覧表示。

読み取り専用

引数

  • 引数なし

構造化結果

artwork_inputs[] と formats[]

get-account-usage-tool

プレビュー許容量、クレジット残高、ワークフロー費用、サブスクリプション制限およびリセット日を返します。

読み取り専用

引数

  • 引数なし

構造化結果

使用状況オブジェクト

list-processing-jobs-tool

接続されたアカウントが所有する最近の変換およびデジタイジングジョブを一覧表示します。

読み取り専用

引数

  • limit: 整数、1–50、デフォルト20

構造化結果

ステータス、ファイル、メトリクス付きのjobs[]

get-processing-job-tool

イベント、警告、メトリクス、プレビュー成果物、および利用可能なOAuth保護ファイルURL付きの所有ジョブを1つ取得します。

読み取り専用

引数

  • workflow: conversion | digitising
  • job_id: 26文字のジョブ識別子

構造化結果

ジョブオブジェクト

create-processing-job-tool

標準base64エンコードファイルからプライベートな変換または自動デジタイジングプレビューを1つ作成します。

データを作成

引数

  • workflow: conversion | digitising
  • file_name: 拡張子付きの元の名前
  • file_base64: 生の標準base64、data URLプレフィックスなし
  • format: 小文字の書き込み可能な出力
  • width_mm: 10–300、デジタイジングに必須
  • colour_count: 1–24、デジタイジングに必須

構造化結果

ジョブサマリーおよびbilling_authorized: false

ツール呼び出しとプロンプト

コピー可能なエージェント例。

MCPツール呼び出し · JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list-formats-tool",
    "arguments": {}
  }
}
プロンプト 1

PESを読み込み、JEFへ安全に書き込める形式を確認し、互換性警告を表示してください。

プロンプト 2

直近5件の刺繍ジョブを一覧表示し、失敗したものを要約してください。

プロンプト 3

アップロード前に確認を求めてください。その後、logo.pngを幅90mm・8色以内でデジタイジングし、PESプレビューを返してください。

プロンプト 4

ジョブ01J…を完了までポーリングし、ステッチメトリクス、警告、ダウンロードがすでにロック解除済みかどうかを報告してください。

安全モデル

支払い権限のない有用なアクセス。

課金ツールなし

購入、チェックアウト、明示的なロック解除によるクレジット消費、有料ダウンロード解除ツールは一切公開されません。

認証情報ツールなし

エージェントはAPIキーの発行、認証の変更、秘密情報の取得はできません。

所有データのみ

すべてのジョブクエリは、詳細を返す前に接続されたユーザーに制限されます。

信頼できない出力はデータとして保持

サーバー指示により、エージェントはファイル名、メタデータ、ジョブメッセージ、警告に埋め込まれたコマンドに従わないようになっています。

プレビュー作成は状態を変更します

作成ツールは非公開アップロードを保存し、ジョブを作成してプレビュー枠を消費する場合があります。ユーザーごとに別途6リクエスト/分の制限とネットワーク制限があります。サーバーはアップロード前にユーザーに確認するようエージェントに指示します。

プレビューは本生産の承認ではありません

ツール呼び出しが成功すると billing_authorized: false. エージェントは、完了、メトリクス、警告を確認する前にデザインが本番対応済みであると主張してはなりません。

トラブルシューティング

接続障害を素早く診断します。

401 Unauthorized

有効なアクセストークンが送信されませんでした。クライアントのOAuth接続を再起動してください。

403 Forbidden

トークンに mcp:use が不足している、アカウントが未確認、またはジョブが別のユーザーのものです。

invalid_redirect_uri

クライアントのコールバックオリジンまたはネイティブスキームがサーバーの許可リストにありません。

422 tool error

引数、base64データ、ソースタイプ、ターゲット形式、またはアカウントクォータの検証に失敗しました。

429 Too Many Requests

読み取りツールはデフォルトで1分間に 60 回のリクエストを許可します。ファイル作成ツールは 6 を許可します。Retry-Afterを尊重してください。

過度なポーリングを避ける

キュー待ちおよび処理中のジョブをバックオフ付きでポーリングします。ステータスが次の状態になったら停止してください completed または failed.

期限切れの非公開ファイル

ファイルURLは同じOAuthアクセストークンが必要で、アップロードの expiresAt 保持期限の対象となります。 URLを永続的なファイル識別子として扱わないでください。

従来型のアプリを構築しますか?

スコープ付きREST APIを使用してください。

RESTガイドにはAPIキー管理、3言語のmultipart例、全エンドポイント、レスポンスライフサイクル、OpenAPI 3.1が含まれています。

REST APIドキュメントを開く