Speko AI

spekoai-mcp

SpekoAI 向けの FastMCP v4 サーバーです。ホストされているエンドポイントは次のとおりです。

https://mcp.speko.ai/mcp

OAuth または Speko Platform API キーを使った、認証済みの POST リクエストを受け付けます。URL を設定し、クライアントにプロトコルをネゴシエートさせてください。プロトコルヘッダーを手動で追加しないでください。

Authorization: Bearer <OAuth access token or sk_live_xxx>
Content-Type: application/json

トランスポートはステートレスで、JSON のみを使用します。最新のクライアントは MCP 2026-07-28 を直接使用します。Cursor などのハンドシェイク方式のクライアントは、initialize を通じて MCP 2025-11-25 をネゴシエートします。どちらの方式もセッションレスです。Mcp-Session-Id、SSE レスポンス、ローカルの OAuth トランザクションストア、stdio トランスポートはありません。認可、同意、リフレッシュトークン、クライアント登録は Better Auth が担い、MCP サービスはリクエストごとに署名済みアクセストークンを検証するだけです。

クライアントのセットアップ

直接 HTTP インストーラーを使用し、OAuth を選択します（対話形式でのデフォルトの選択肢です）。

npx @spekoai/mcp@latest init

または、OAuth 対応クライアントを直接設定します。たとえば、Codex は次の設定を読み込みます。

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"

自動化では、Platform API キーを環境変数に設定し、ベアラー設定を追加します。

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"
bearer_token_env_var = "SPEKO_API_KEY"

ツールの提供範囲

ホストされるツールの提供範囲はホスト名に紐づいており、profile クエリパラメーターは無視されます。プライマリエンドポイントでは、ドメイン／アクション名を使った運用ツールを提供します。

• アカウント：organization.get、credits.balance.get、credits.ledger.list、usage.summary.get；
• エージェント：agents.list、agents.preview_stacks、agents.create、agents.get、agents.update、agents.delete、デプロイ／バージョン／ツールおよびモニターの操作；
• セッションと通話：作成、一覧表示、確認、文字起こし、録音、テスト通話の操作；
• 独自のキャリアを使用する場合を含む電話番号： phone_numbers.sip_connections.create は顧客の SIP トランクを接続し、phone_numbers.import はそのトランクを経由する番号を関連付けます。SIP ゲートウェイもサポートへの問い合わせも不要です；
• カスタム音声：voice_clones.create は録音リンクから音声をクローンし、ElevenLabs、Cartesia、MiniMax、または CSM に登録します。そのプロバイダーの音声 ID は audio.synthesize で使用できます；voice_clones.list、.provision、.delete；
• ナレッジベース、評価、移行ヘルパー、音声ヘルパー、および docs.search。

ビルダープロファイル

アプリビルダーは、次の専用ホストを使用します。

https://builder-mcp.speko.ai/mcp

ドキュメント検索、カタログ、エージェントの読み取り、スタックのプレビュー、インテグレーションのコードスニペット、テスト通話の確認フロー、および制限付きの agents.create と agents.test_call の書き込みを利用できます。生成されたアプリケーションは実行時に Speko SDK を使用し、MCP ツールは呼び出しません。

Replit プロファイル

Replit は専用のホストを使用します。

https://replit.speko.ai/mcp

ビルド時の順序に沿って 28 個のツールを提供します。最初に code_snippets.get、音声とモデルのカタログ、ドキュメント検索、スタックのプレビューが続き、その後にエージェント、番号、文字起こしの読み取り、最後に書き込みが続きます。ビルダープロファイルにない次の 2 つのフローも追加されます。音声 FAQ の保存先となるナレッジベースと、アプリ内アシスタントが動作した後の次の要望となる電話番号です。ゲートウェイ操作、評価、モニター、シナリオ、請求、API キー、移行、破壊的な削除操作はすべて対象外です。

アシスタントディレクトリのホスト

アシスタントディレクトリはそれぞれ独自のホストで公開され、各ディレクトリのポリシーに沿った構成になっています。提供範囲はホストに設定されます。クエリパラメーター、ヘッダー、アカウント設定によって範囲を広げることはできません。

Anthropic MCP Directory

https://anthropic.speko.ai/mcp

アカウント全体の読み取り、音声からテキストへの変換、発信通話、読み取り専用の電話コンプライアンス診断：

• アカウント：organization.get、credits.balance.get、credits.ledger.list、 usage.summary.get；
• エージェント：agents.list、agents.get、agents.preview_stacks、 agents.versions.list、agents.tools.list、agents.tools.get、 agents.calls.list、agents.test_call.get；
• セッションと通話：sessions.list、sessions.get、 sessions.transcript.get、sessions.recording.get、calls.get、 calls.recording.get；
• 電話番号：phone_numbers.list、phone_numbers.get、 phone_numbers.available.search；
• ナレッジベース：knowledge_bases.list、knowledge_bases.get、 knowledge_bases.documents.list、knowledge_bases.documents.get；
• 評価とモニタリング：evals.get、agents.monitoring.results.list；
• オーディオ：audio.transcribe；
• 発信：sessions.phone.create — ツール呼び出しごとに発信通話を1件行い、AI であることの開示がサーバー側で挿入されます。ChatGPT とコネクターからの呼び出しには、デフォルトで5分の厳格な上限が設定されています。別の上限にする場合は、body.maxDurationSeconds を明示的に設定してください（S2S は30～3600秒、カスケードは最大14400秒）。
• 通話終了：sessions.end — session_id を使用して、直ちに通話終了を要求します。繰り返し呼び出しても安全です。ending の応答は要求が確認されたことを示します。セッションが終了したことを確認するには、sessions.get を使用してください。
• コンプライアンス：phone_numbers.kyb.get — OAuth コネクターの同意と申告の送信は、バックエンドで自動的に行われます。
• 移行ヘルパー：migration.workspace.inspect、 migration.external_config.parse、migration.session_config.build、 migration.briefing.render；
• その他：docs.search。

意図的にこのホストには含めていません。いずれも、要求に応じて合成音声を生成するか、音声を生成する機能を有効にするためです。

グループ	含まれないもの
音声生成	audio.synthesize
ライブセッション／通話の作成	sessions.create、agents.test_call
エージェントの設定とデプロイ	agents.create、agents.update、agents.deploy、agents.rollback、agents.tools.create、agents.tools.update、agents.tools.delete
ナレッジベースへの書き込み	knowledge_bases.create、knowledge_bases.documents.create、knowledge_bases.documents.delete、knowledge_bases.documents.finalize
電話番号のプロビジョニング	phone_numbers.create、phone_numbers.update
一括評価またはスケジュール評価	agents.evals.*、agents.monitors.*
取り消せない外部向けの書き込み	agents.delete、phone_numbers.delete、knowledge_bases.delete、share_cards.create

エージェントの設定は、そのエージェントを起動可能な状態にするのと同じです。デプロイ済みのエージェントは、それ以上ツールを呼び出さなくても、着信に応答して話します。そのため、エージェント自体の生成ツールと同様に、エージェントの作成、更新、デプロイ、ロールバックも利用できないようにしています。audio.transcribe は、音声を生成せず、テキストのみを返す音声テキスト変換機能なので含めています。

sessions.phone.create は、意図的にこのホストに含めています。顧客が別の場所でデプロイしたエージェントを使用して、明示的なツール呼び出しごとに1つの番号へ1件の通話を発信します。一括、スケジュール実行、無人での利用経路はなく、発話するエージェントを発信者が設定することもできません。ディレクトリのホストで作成されたすべての通話には、AI であることの開示がサーバー側で挿入されます。最初に話す内容で発信者が AI であることを明らかにし、エージェントにその事実を認めないよう促すことはできません。発信できない通話の文字起こしを読めるだけのサーフェスは、コネクターではなくビューアーです。sessions.create（チャットクライアントでは役に立たないブラウザーセッショントークン）と、agents.test_call（2つの合成エージェント同士の会話）は引き続き含めません。 最後の行が除外されている理由は別です。削除は何かを有効化するのではなく、機能を取り除くため、これらのツールは上記のルールの対象外です。ただし、公開するツールセットは誠実な一文で説明できる必要があります。取り消し不能な削除が3つあり、公開ページを作成するツールも含まれていたため、今回は読み取り専用のツールセットとは呼べませんでした。phone_numbers.delete は課金対象の番号も解放します。4つすべてのリソースは引き続き読み取れます。このホストで非公開のツールを呼び出すと、登録されていない名前の場合と同じく、Unknown tool: '<name>' が返されます。

OpenAI Plugin Directory

https://chatgpt.speko.ai/mcp

21個のツール。 Anthropic のものを再利用せず、別のリストを用意しています。2つのディレクトリでは禁止事項が異なるためです。OpenAI では生成音声に制限がないため、audio.synthesize と外向きの通話は残っています。一方、デジタル商品の販売に関するルールにより、電話番号のプロビジョニングとクレジットおよび使用状況の読み取りは除外されています。3つの読み取りツールは、agents.test_call が行き止まりにならないようにするためのものです。テスト通話を確認するには、実行のセッション ID を取得する agents.test_call.get、実行結果が上書きされた場合にその ID を復元する agents.calls.list、音声を取得する calls.recording.get が必要です。

認証と下流への呼び出し

OAuth クライアントは、MCP の保護リソースメタデータから Better Auth を検出します。Better Auth は、正確な MCP リソース URL に紐付けられた JWT アクセストークンを発行します。MCP サーバーは、OAuth やプロトコルの状態を保持せず、リクエストごとに署名、発行者、オーディエンス、有効期限、スコープを検証します。

プロダクト全体で使われる Platform API キーは、リクエストごとに GET /v1/auth/api-key-context で個別に検証されます。Speko API ツールは API キーを変更せずに転送します。OAuth クライアントの場合、MCP サービスは Platform API 専用の別個の60秒有効な JWT を発行し、クライアントが提示した MCP トークンを転送することはありません。

設定：

• SPEKOAI_API_URL — Platform API のオリジン。デフォルトは https://api.speko.dev です。
• SPEKOAI_ROUTER_URL — Speko Router のオリジン。デフォルトは https://router.speko.dev です。 audio.transcribe と audio.synthesize は Router を優先し、Router がリクエストを処理できない場合は Platform エンドポイントにフォールバックします。Speko API キーのないセッションでは、Router は OAuth 委任トークンではなく API キーで認証するため、どちらのツールもフォールバックします。audio.transcribe は、Router がデコードできない WAV/PCM 以外のコンテナでもフォールバックします。audio.synthesize は、リクエスト本文で Router の音声生成本文では指定できない項目が指定された場合にフォールバックします。該当するのは speed、instructions、spokenForm、単独の model、intent.region、または許可されたプロバイダーが2つ以上指定されている場合です。
• SPEKOAI_OAUTH_ISSUER — Better Auth の発行者。例：https://platform.speko.ai/api/auth
• SPEKOAI_MCP_BASE_URL — 正確なリソースオーディエンスの導出に使用する公開 MCP オリジンです。
• SPEKOAI_MCP_DELEGATION_SECRET — ステートレスな API 委任のために Platform とのみ共有する、32文字以上のシークレットです。
• SPEKOAI_MCP_DEFAULT_PROFILE — /mcp で提供する、デプロイ時のみ設定可能なツールセット（builder | connector | chatgpt | customer）です。ホスト型サービスでは明示的に設定します。公開クエリパラメーターで選択または上書きすることはできません。未設定の場合、ローカル環境とセルフホスト環境では従来の全ツールセットが維持されます。

デプロイの順序、スモークテスト、障害の診断については、docs/fastmcp-v4.md を参照してください。