Speko MCP Server

Speko MCP Server とは？

https://mcp.speko.ai/ の Speko MCP サーバーは、公開・読み取り専用の Speko Docs MCP です。AI アシスタントはサインインせずに、Speko の音声 AI 向け API、SDK、アダプター、クイックスタート、移行ガイドのドキュメントを検索して読むことができます。

Speko は自らを「音声 AI のルーター」（the router for voice AI）と説明しています。型付きの契約を通じて音声認識（STT）、LLM、音声合成（TTS）のトラフィックを各プロバイダーに振り分けるホスト型 Router と、LiveKit と Pipecat 向けのオープンな顧客側 Gateway を提供しています。また、17 言語にわたるモデルのベンチマークも公開しています。ここに掲載するドキュメント用エンドポイントは、コーディングエージェントがコードを書きながらこうした使い方を調べられるようにするためのものです。アカウントに関わる操作（エージェント、通話、電話番号）には、認証が必要な別の運用エンドポイント https://mcp.speko.ai/mcp が用意されています。

Speko MCP Server の使い方

ドキュメント用エンドポイントには、アカウント、API キー、OAuth サインインのいずれも不要です。クライアントにリモートの Streamable HTTP サーバーとして追加します。

Claude Code

claude mcp add --transport http speko-docs https://mcp.speko.ai/

Claude Desktop と claude.ai

Settings > Connectors > Add custom connector を開き、「Speko Docs」などの名前を付けて、URL に https://mcp.speko.ai/ を貼り付けます。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "speko-docs": {
      "url": "https://mcp.speko.ai/"
    }
  }
}

VS Code

.vscode/mcp.json にサーバーを追加します。

{
  "servers": {
    "speko-docs": {
      "type": "http",
      "url": "https://mcp.speko.ai/"
    }
  }
}

Speko のフルツールセットに接続する

ドキュメントだけでなく Speko アカウントを操作したい場合は、運用エンドポイントに接続します。Speko のドキュメントでは次のコマンドが案内されています。

npx @spekoai/mcp@latest init
claude mcp add --transport http speko https://mcp.speko.ai/mcp

このエンドポイントはブラウザでの OAuth サインインを使います。自動化の場合は、代わりに Speko Platform の API キーを Authorization: Bearer ${SPEKO_API_KEY} として送信できます。キーの作成と失効は Speko Platform のダッシュボードで行い、MCP からは行えません。

Speko MCP Server の主な機能

• 公開かつ読み取り専用：サーバー自身の説明に「アカウントデータや書き込みツールを一切公開せず、認証も不要」と明記されています。
• Speko の音声 AI 向け API、SDK、アダプター、クイックスタート、移行ガイドのドキュメントを同梱し、MCP リソースとして提供します。
• すべての同梱ドキュメントを一覧できるインデックスリソース（spekoai://docs/index）と、ドキュメントごとの spekoai://docs/{slug} リソース。
• slug、タイトル、スコア、スニペットを返すランキング付き検索。API のバリデーションエラー後にフィールド名を調べるのに便利です。
• 運用エンドポイント、ガイド付きインストーラーのコマンド、Claude Code・Codex・OpenCode・Cursor 向けのコピー可能な設定スニペットを返すセットアップツール。
• MCP Apps を表示できるクライアント向けのセットアップカード UI リソース。

Speko MCP Server のツール

ドキュメント用エンドポイントは 2 つのツールを提供します。

• ドキュメント検索：docs.search は同梱の Speko ドキュメントを検索し、各ヒットの slug、タイトル、スコア、スニペットを返します。ヒットした内容は spekoai://docs/{slug} リソースを読むと開けます。
• クライアント設定：setup.connect は MCP クライアントを Speko に接続する方法を示します。運用エンドポイント、npx @spekoai/mcp@latest init インストーラー、サインイン方法、クライアントごとの設定スニペットを返します。

/mcp の運用エンドポイントははるかに大規模です。Speko の MCP ガイドによると 101 個のツールがあり、組織、エージェント、セッション、通話、電話番号、ナレッジベース、評価、デプロイ、移行支援、使用量データをカバーしています。

Speko MCP Server のユースケース

• 音声エージェントのコーディング中に SDK の使い方を調べる：「LiveKit で Gateway の STT プラグインを使う方法を Speko のドキュメントで検索して」
• API エラー後にリクエストを修正する：「Speko へのリクエストが objective でバリデーションエラーになった。正しいフィールドの形式を探して」
• 移行を計画する：「既存の音声エージェント設定を移行するための Speko の移行ガイドを探して」
• チームメイトのクライアントを設定する：「Speko を Cursor と Codex に接続するには？」（エージェントが setup.connect を呼び出します）
• アカウント用サーバーに接続するかを決める前に、認証情報なしで安全に Speko の情報をコーディングエージェントに与える。

Speko MCP Server のトラブルシューティング

• アカウント操作をしたいのにツールが 2 つしか表示されない：公開ドキュメント用エンドポイント（https://mcp.speko.ai/）に接続しています。運用ツールを使うには https://mcp.speko.ai/mcp に接続してサインインしてください。
• 401「Authentication required」が返る：これは /mcp の運用エンドポイントからの応答で、OAuth サインインか Bearer API キーが必要です。ルート URL のドキュメント用エンドポイントはどちらも不要です。
• ディレクトリ用ホストでツールが「Unknown tool」を返す：Speko の機能を絞ったディレクトリ用ホスト（例：anthropic.speko.ai）では、エージェントのデプロイや削除など一部のツールが意図的に除外されています。