Twilio MCPサーバーの使い方 — 認証不要のAPI仕様検索をClaude Codeに接続する
Twilio公式のMCPサーバーは1,800超のAPIを検索・参照できる、認証もインストールも不要な読み取り専用サーバーです。Claude Codeへの接続手順と制限事項をまとめます。
Twilio MCP Serverは、Twilioが公式に配布するMCP(Model Context Protocol)サーバーです。TwilioアカウントもAPIキーも持たずに、Claude Codeから1,800超のAPIエンドポイントをその場で検索し、パラメータのスキーマを取得できます。
ホスト型のためインストール作業も不要です。ただし検索とドキュメント取得に特化した設計で、できないこともあります。その境界を先に押さえておきます。
Twilio MCPサーバーとは何ができるか
Twilio MCP Serverは、Twilioの全APIサーフェス(30以上の製品にまたがる1,800超のエンドポイント)への構造化アクセスを、AIコーディングエージェントに提供するホスト型サーバーです。ドキュメントを検索してパラメータをコピーし、ブラウザとエディタを行き来する作業を省き、エージェントが必要なスキーマだけをその場で取得します。
Conversation Memory・Conversation Orchestrator・Twilio Agent Connect・Conversational Intelligenceのように比較的新しい製品は、モデルの学習データに十分な情報が含まれていない可能性があります。こうした製品のAPIを扱うときほど、このMCPサーバーの効果が大きくなります。
twilio__searchとtwilio__retrieveの二段階ワークフロー
MCPサーバーが公開するツールは2つだけです。
| ツール | 役割 |
|---|---|
twilio__search | 役割自然文のクエリを受け取り、関連度順にAPIオペレーション・ドキュメント記事・IDを返す |
twilio__retrieve | 役割検索結果のAPI IDを1つ以上受け取り、完全なパラメータスキーマとレスポンススキーマを返す |
まずtwilio__searchで候補を絞り込み、必要なオペレーションだけをtwilio__retrieveで詳細取得する二段構成です。全エンドポイントの詳細を毎回ロードしないため、コンテキストの消費を抑えられます。
索引対象は公開されているTwilioのOpenAPI仕様(Conversation Memory・Conversation Orchestrator・Conversational Intelligence・Twilio Agent Connectを含む)、Twilioのドキュメントとサポート記事、Twilio SendGridのドキュメントとサポート記事、Twilio Segmentのドキュメントです。
収録されている主なTwilio製品
Programmable Messaging、Programmable Voice、Verify、Twilio Conversations、Twilio Video、Flex、Twilio Serverless、Studio、Sync、TaskRouter、Elastic SIP Trunking、Content、Events、Monitor、Twilio Frontline、Lookup、Notify、Proxy、Super SIM、Wireless、Trust Hub、Marketplace、Conversation Intelligence、Conversation Memory、Conversation Orchestrator、Twilio Agent Connect(TAC)
接続前に確認すること
認証不要です。このMCPサーバーが索引しているのは公開されているAPI仕様のみで、TwilioアカウントもAPIキーも必要ありません。インストール作業も不要で、https://mcp.twilio.com/docsというURLをIDE側に指定するだけで動きます。接続先はこの1つだけで、認証方式も「なし」です。
一方で読み取り専用である点が最大の制約です。提供されるのはAPI検索とドキュメント取得のみで、エージェントに代わってTwilio APIを実行する機能はありません。SMSを送る、通話を発信するといった実際の操作をさせたい場合は、別途Twilio自身のSDKやAPIクライアントをコード内に実装する必要があります。Twilio公式のロードマップには、OAuth認証つきでAPIを直接呼び出せる「実行可能なMCPツール」が計画中と記載されていますが、まだ提供されていません。
索引対象は公開されているOpenAPI仕様に限られる点にも注意します。パブリックなAPI仕様に含まれないプライベートAPIやベータ限定機能は検索対象外です。
Claude Codeへの接続手順
TwilioのMCPサーバーは、Claude.ai・Claude Desktop・Claude Codeのそれぞれで接続方法が異なります。Claude Codeでコーディングエージェントに使わせたい場合は、CLIからclaude mcp addで登録します。
claude mcp add --transport http twilio-docs https://mcp.twilio.com/docsこのコマンドにはスコープの指定がないため、既定のlocal scope(現在のプロジェクトだけで有効)に登録されます。複数のプロジェクトで横断的に使いたい場合は--scope userを明示的に付けます。
claude mcp add --transport http twilio-docs --scope user \
https://mcp.twilio.com/docs接続状態の確認や削除は次のコマンドで行います。
claude mcp list
claude mcp get twilio-docs
claude mcp remove twilio-docs --scope userclaude mcp removeはサーバーを追加したときと同じスコープを指定しないと削除できません。local scopeで追加したサーバーを--scope user付きで削除しようとしても対象が見つからないため、追加時に使ったスコープを覚えておく必要があります。
Claude Connectorとして使う場合
Claude Code以外に、Claude.ai・Claude Desktop・Claudeモバイルアプリの「コネクタ」からも同じTwilio MCPサーバーへ接続できます。各クライアントのコネクタディレクトリで「Twilio」を検索してインストールする方式で、CLIコマンドは不要です。こちらはチャット上でTwilioのAPIドキュメントを質問する用途に向き、コーディングセッションの外でAPI仕様を調べたいときに使えます。
Claude Code CLIとClaude Connectorは、どちらも同じhttps://mcp.twilio.com/docsエンドポイントに接続しますが、登録先の面が異なります。CLIで登録したサーバーはClaude Codeのセッションでのみ使え、Connectorとして登録したものはClaude.aiやClaude Desktopのチャットで使えます。両方の環境で使いたい場合は、それぞれで個別に登録が必要です。
接続を確認する
登録後は次の3点で動作を確認します。
- IDEやCLIのMCP設定一覧に
twilio-docsが表示されているか確認する(claude mcp list) - コーディングエージェントに「TwilioでSMSを送信するにはどうすればいいですか」のようなTwilioに関する質問を投げる
- 返答が具体的なTwilio APIエンドポイントを参照し、
twilio__searchツールが呼び出されているかを確認する
エージェントがtwilio__searchを呼ばずに一般知識だけで回答した場合は、MCPサーバーが正しく接続されていないか、ツールの使用をエージェント側が選択していない可能性があります。
Claude Code CLIとClaude Connector、どちらを選ぶか
| 用途 | おすすめ | 理由 |
|---|---|---|
| Claude Codeでコーディング中にTwilio APIを調べたい | おすすめClaude Code CLI(claude mcp add) | 理由エージェントのツール呼び出しに直接組み込まれる |
| チャットでTwilioのAPI仕様を質問したい | おすすめClaude Connector | 理由Claude.ai・Desktop・モバイルのどこからでも使える |
| チームの複数プロジェクトで共通利用したい | おすすめClaude Code CLI + --scope user | 理由プロジェクトをまたいで有効になる |
| CIやスクリプトから自動的にTwilio APIを実行したい | おすすめどちらも不可 | 理由現行版は検索・参照専用で、API実行機能は未提供 |
よくあるつまずき
接続しただけでTwilio APIを実行できると誤解する。「Twilioで実際にSMSを送って」という指示は、このMCPサーバー単体では通りません。実行にはTwilioの認証情報を使ったAPIクライアントを別途コードに実装します。
バージョン違いの検索結果を参照してしまう。Programmable Messagingのように複数バージョンが存在するAPI(v2010が旧版、v1が現行版)では、twilio__searchは既定で最新バージョンの結果を返します。旧バージョンのAPI仕様を意図的に参照したい場合は、filter.versionパラメータでバージョンを明示的に指定します。
追加コマンドと削除コマンドでスコープが食い違う。前述のとおり、claude mcp add --transport http twilio-docs https://mcp.twilio.com/docsをそのまま実行するとlocal scopeに登録されます。あとから--scope userを付けて削除しようとしても対象が見つからないため、複数プロジェクトで使う前提なら追加時点で--scope userを付けておきます。
検索結果の質がモデルに依存する。検索結果の有用性と、エージェントがその結果をどう使うかは、コーディングエージェントを動かしているモデルの性能に依存します。同じ検索クエリでも、モデルによって選ぶAPIオペレーションや解釈が変わることがあります。
まとめ
Twilio MCPサーバーは、Twilioアカウントもインストール作業も不要で、claude mcp add --transport http twilio-docs https://mcp.twilio.com/docsの1行でClaude Codeに接続できます。読み取り専用でAPI実行はできない点、追加時のスコープを覚えておく必要がある点の2つを押さえれば、1,800超のTwilio APIをコーディングセッションの中から検索・参照できる構成になります。フィードバックやバグ報告はquestions-mcp@twilio.com宛てに送る運用です。
MCPサーバーの基本設定(スコープ・.mcp.json・OAuth認証)を先に押さえたい場合はClaude Code MCP設定ガイドを、同じくHTTPトランスポートで接続するホスト型MCPの例を見たい場合はVercel MCPサーバーの使い方を参照してください。読み取り専用のドキュメント検索という設計はSonarQubeのMCPサーバーとも対照的で、書き込み系の操作まで含む例はSonarQubeのMCPサーバーをClaude Codeに接続する手順にまとめています。接続後にツール一覧の表示が遅れる・古く見える場合はMCP_DISCOVERY_CACHEとはも参考になります。