Submitator

Submitator MCP サーバー

Claude、ChatGPT、Cursor、または VS Code から、クライアントの製品をそれぞれ最大 100 件のディレクトリに掲載できます。

この MCP サーバーは、Submitator のホワイトラベルプランを利用する代理店向けです。アシスタントは URL からクライアントのプロジェクトを作成し、掲載先となるディレクトリを表示します。承認を受けてから掲載を開始し、掲載が公開されるまで追跡します。バッジ、レポート、クライアントページには、代理店のブランドが表示されます。Submitator API を代理店のキーで呼び出し、API が行わないことは一切実行しません。

必要なもの

• 代理店アカウント：app.submitator.com/agency/start。
• 代理店コンソールの Developers から取得した API キー。claude.ai または ChatGPT では、サインイン時にキーが作成されます（リモートサーバーを参照）。
  • sbm_test_ キーは、代理店を作成した日から無料で利用できます。テストモードで動作し、プロジェクトと掲載情報はテストデータです。何も送信されず、テストでの掲載開始は購入済みの掲載開始回数には含まれません。
  • sbm_live_ キーは、初回購入時に利用できるようになります。launch_project を実行するたびに、掲載開始回数が 1 回消費されます。

インストール

このパッケージは npx（Node.js 20 以降）を使って、お使いのマシン上で実行します。キーはユーザーレベルの設定に保存し、リポジトリ内のファイルには絶対に保存しないでください。

Claude Code（ユーザースコープ。キーがプロジェクトの .mcp.json に保存されません）

claude mcp add --scope user submitator --env SUBMITATOR_API_KEY=sbm_test_... -- npx -y submitator-mcp

Cursor（~/.cursor/mcp.json、ユーザーレベルのファイル）

{
  "mcpServers": {
    "submitator": {
      "command": "npx",
      "args": ["-y", "submitator-mcp"],
      "env": { "SUBMITATOR_API_KEY": "sbm_test_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code がキーの入力を求め、ファイルには保存しません。

{
  "inputs": [
    { "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
  ],
  "servers": {
    "submitator": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "submitator-mcp"],
      "env": { "SUBMITATOR_API_KEY": "${input:submitator-key}" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：Cursor と同じブロックを mcpServers の下に設定します。Claude Desktop はディスクのルートでサーバーを起動するため、ローカル画像をアップロードする場合は env に "SUBMITATOR_FILES_DIR": "/path/to/client/images" を追加してください。

Devin Desktop（旧 Windsurf）、Cline、その他の MCP クライアント：SUBMITATOR_API_KEY を環境変数に設定して npx -y submitator-mcp を実行するか、以下のリモートサーバーを使用してください。

リモートサーバー

https://mcp.submitator.com/mcp にあるリモートサーバーは、インストール不要です。接続方法は 2 つあります。 claude.ai と ChatGPT では Submitator にサインインします。その他のクライアントでは、ヘッダーに代理店キーを指定します。

claude.ai：サインイン

1. claude.ai で Customize > Connectors を開き、+ Add、続いて Add custom connector を押します。
2. 名前に Submitator、URL に https://mcp.submitator.com/mcp を入力し、Continue を押します。 検出された設定を確認し、もう一度 Continue を押します。
3. Authentication で Sign in now を選び、OAuth クライアントは Use Claude's published identity (Recommended) のままにします。 Request headers は空欄のままにして、Add を押します。
4. Submitator のサインイン画面が開きます。代理店コンソールにログインしてください。同意ページにはクライアント名とホスト（Claude、claude.ai）が表示されます。Test または Live、および Full または Read only を選び、Allow Claude を押します。
5. チャットで +、続いて Connectors を開き、Submitator をオンにします。

このリンク を開くと、手順 1 のダイアログが表示され、名前と URL が入力済みです。

サインインすると、コンソールの Developers ページに MCP: Claude というラベルのキーが作成されます。接続を解除するには、そのページでキーを取り消してください。次回の呼び出し時に、再度サインインを求められます。Live を利用するには、代理店が掲載開始回数を購入している必要があります。そのため、新しい代理店で利用できるのは Test のみで、テストモードでは何も送信されません。

Team プランと Enterprise プランでは、まず Owner が Organization settings > Connectors で Add、Custom、Web の順に選択してコネクターを追加します。その後、メンバーは Customize > Connectors で Connect を押し、それぞれサインインします。

ChatGPT：サインイン

1. ChatGPT のウェブ版で、Plugins（chatgpt.com/plugins）を開き、プラスボタンを押してから Add custom MCP server を選択します。
2. 名前に Submitator を入力し、Connection の Server URL に https://mcp.submitator.com/mcp を入力します。
3. 認証方式として、Client ID Metadata Document（CIMD）を使う OAuth を選び、クライアント ID もシークレットも入力しないでください。Submitator のサインインでは、ChatGPT が公開しているクライアントドキュメントを読み取るため、クライアント登録は不要です。
4. リスクに関する警告を確認し、I understand and want to continue を選択してから、Create as a plugin を選択します。
5. プラグインをインストールし、チャットで @ と入力して選択します。

ChatGPT から Submitator のサインインに移動したら、代理店コンソールにログインし、同意ページで Test または Live と Full または Read only を選び、ChatGPT を許可します。claude.ai の場合と同様に、サインインすると、コンソールの Developers ページにラベルが MCP: で始まるキーが作成されます（切断するには、そこでキーを取り消してください）。新しい代理店では、Test のみが利用できます。

OpenAI のドキュメントによると、ChatGPT はデフォルトで書き込み操作の前に確認を求め、readOnlyHint のないツールを書き込みツールとして扱います。ここでは、読み取りのみを行うツールには readOnlyHint: true が設定され、その他のすべてのツールには false が設定されています。ワークスペースでは、カスタム MCP サーバーの追加と使用に、その権限とセキュリティ設定が適用されます。

Claude Code、Cursor、VS Code、その他のクライアント：ヘッダー内のキー

URL:    https://mcp.submitator.com/mcp
Header: Authorization: Bearer <your key>   (X-API-Key: <your key> works too)

Claude Code

claude mcp add --transport http submitator https://mcp.submitator.com/mcp \
  --header "Authorization: Bearer $SUBMITATOR_API_KEY"

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "submitator": {
      "url": "https://mcp.submitator.com/mcp",
      "headers": { "Authorization": "Bearer sbm_test_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code ではキーの入力を求められ、ファイルには保存されません。

{
  "inputs": [
    { "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
  ],
  "servers": {
    "submitator": {
      "type": "http",
      "url": "https://mcp.submitator.com/mcp",
      "headers": { "Authorization": "Bearer ${input:submitator-key}" }
    }
  }
}

HTTP 経由で接続するその他のクライアントでも、同じ URL とヘッダーを使用します。

リモートサーバーはリクエスト間に情報を保持しません。ヘッダーまたはサインインのアクセストークンから受け取ったキーを Submitator API に渡し、すぐに破棄します。ファイルの読み取りや保存はできないため、save_report_file とローカル画像パスは npx パッケージでのみ使用できます。

ツール

ツール	機能
whoami	キーに紐づく代理店とモード、その権限、残りのローンチ数、時間あたりの予算を確認します
list_projects、get_project	クライアントのプロジェクトを検索し、プロジェクトの詳細を確認します
create_project、update_project、delete_draft	URL からプロジェクトを作成し、フィールドを変更し、下書きを削除します
set_logo、add_screenshot、remove_image	公開 URL の画像、または npx パッケージでローカルファイルの画像を扱います
preview_launch	ローンチまたは追加を同じ引数で無料でドライランします。ディレクトリ数、不足している項目、費用、自動選択されたディレクトリの DR の最高値と中央値を確認できます
find_directories、project_directories	カタログを検索し、プロジェクトで選択可能なディレクトリを確認します
launch_project	登録を開始します。ローンチを 1 回消費し、同じ引数で preview_launch が示した件数と confirm_selected が一致しない場合は実行されません
add_directories	ローンチ済みプロジェクトの無料枠を使って、さらにディレクトリに登録します。同じ確認チェックが適用されます
list_listings、list_events	掲載状況と、指定した時刻以降の変更を確認します
get_badge、verify_badge	クライアントのサイトに設置するバッジのコードと、設置済みかどうかの確認を行います
create_report、get_report、save_report_file	PDF または XLSX レポートを作成し、npx パッケージでディスクに保存します
get_share_link、create_share_link、delete_share_link	クライアントの進捗ページを扱います（ライブキー）
advance_test_listing、set_test_launches	テストモード用のヘルパーです（テストキー）

プロンプト：launch_client_project はローンチの手順を案内し、client_progress_update は Submitator の名前を出さずにクライアント向けの報告文を作成します。

キーと安全性

• launch_project、add_directories、update_projectでは、常に許可するのではなく、クライアントの承認プロンプトを有効にしておいてください。起動には費用がかかります。データを上書きまたは削除するツールや、ディレクトリに送信するツールはすべて、この3つと同様に destructiveHint: true を設定しているため、このヒントを読み取るクライアントは呼び出しのたびに確認を求めます。create_project、add_screenshot、verify_badgeなど、追加または確認のみを行うツールは false を設定しています。有効なキーがあり、ユーザーへの質問（MCP エリシテーション）に対応しているクライアントでは、起動または追加の前にも確認を求めます。その回答がモデルに渡されることはありません。リモートサーバーはセッションを保持しないため、そこでこの質問を受け取れるのは、MCP プロトコル 2026-07-28に対応したクライアントのみです。
• npx パッケージは環境変数からキーを読み取り、https://api.submitator.comにのみ送信します。
• ローカル画像は SUBMITATOR_FILES_DIR（またはクライアントがサーバーを起動したフォルダー）からのみ読み取ります。対象は実際の PNG、JPEG、GIF、WebP ファイルのみで、リンク経由で読み取ることはありません。レポートはデフォルトで Downloads に保存され、既存のファイルが上書きされることはありません。ログイン情報を含むレポートはここには保存されません。
• 読み取り専用キーは、プロジェクト、掲載情報、イベント、既存のレポートのステータスのみを確認するアシスタントに適しています。レポートの作成やクライアントページへのリンクには、すべての権限を持つキーが必要です。
• ログイン情報とそのパスワードは、このサーバーを通じて公開されません。代理店コンソールで確認してください。
• すべての呼び出しは、mcp-で始まるリクエスト ID とともに Developers, Request log に表示されます。キーはいつでもそこで取り消せます。
• 脆弱性は公開イシューではなく、[email protected] にメールで報告してください （SECURITY.md）。

開発

npm install
npm test               # unit, contract and protocol tests
npm run build
npm run sync:openapi   # refresh openapi/v1.json and src/v1.d.ts from the public contract
npm run check:pack     # pack, install in an empty folder, run the stdio handshake

API の新しいリリースが公開されると、npm run sync:openapiとnpm testによって、ツールの追加または EXCLUDED（src/tools/index.ts）への行の追加が必要な新しい操作がわかります。

ライセンス

MIT