Twilio MCPサーバーの使い方 — 認証不要のAPI仕様検索をClaude Codeに接続する

Twilio MCP Serverは、Twilioが公式に配布するMCP(Model Context Protocol)サーバーです。TwilioアカウントもAPIキーも持たずに、Claude Codeから1,800超のAPIエンドポイントを検索し、パラメータのスキーマを取得できます。決済側の例では、サインインして口座を操作するGoCardless MCPの接続手順があります。

ホスト型なのでインストール作業も要りません。ただし検索とドキュメント取得に特化していて、APIの実行まではできません。この境界を先に押さえておくと、接続とスコープの扱いも迷いません。認証不要の読み取り専用という点では、ドメインの空きを調べるGoDaddy MCPも同じ型です。Web標準の仕様を引く側なら、MDN MCPがそれに当たります。OAuthで組織の権限を絞る側の例はMuleSoft Platform MCPサーバーにあります。製品選定や避けるべき点といった判断の知識は、Twilio公式スキルが別に渡します。

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で候補を絞り込み、必要なオペレーションだけをtwilio__retrieveで詳細取得する二段構成です。全エンドポイントの詳細を毎回ロードしないため、コンテキストの消費を抑えられます。

索引対象は公開されているTwilioのOpenAPI仕様(Conversation Memory・Conversation Orchestrator・Conversational Intelligence・Twilio Agent Connectを含む)、Twilioのドキュメントとサポート記事、Twilio SendGridのドキュメントとサポート記事、Twilio Segmentのドキュメントです。

接続前に押さえる制約

認証は不要です。索引しているのは公開されているAPI仕様だけで、TwilioアカウントもAPIキーも要りません。接続先はhttps://mcp.twilio.com/docsの1つで、IDE側にこのURLを指定すれば動きます。

最大の制約は読み取り専用であることです。提供されるのはAPI検索とドキュメント取得だけで、エージェントに代わってTwilio APIを実行する機能はありません。SMSの送信や通話の発信は、Twilio自身のSDKやAPIクライアントをコードに実装して行います。Twilioのロードマップには、OAuth認証つきでAPIを直接呼び出せるツールが追加予定として挙がっています。

索引対象は公開されているOpenAPI仕様に限られます。公開仕様に含まれないAPIは検索結果に出ません。

Claude Codeへ接続して動作を確かめる

Claude Codeでの登録はclaude mcp add1回で済みます。登録後に、エージェントが実際にtwilio__searchを使うところまで確かめます。

twilio__searchを呼ばずに一般知識だけで答えた場合は、接続の失敗か、エージェントがツールを選ばなかったことのどちらかが考えられます。接続の失敗かどうかは/mcpの表示で切り分けられます。

スコープの保存先と、削除でつまずく点

claude mcp addには3つのスコープがあります。Claude Code公式docsの整理は次のとおりです。

Twilioのサーバーは認証情報を持たないため、チーム全員が同じ参照用サーバーを使いたいなら--scope projectで.mcp.jsonに載せる選択肢もあります。個人の手元だけで使うなら、localかuserのどちらかです。

Claude Code v2.1.289のclaude mcp add --helpでは、--scopeの既定値はlocalと表示されます。HTTPで登録した設定ファイルの中身は、typeとurlの2項目だけの短いエントリです。

"twilio-docs": {
  "type": "http",
  "url": "https://mcp.twilio.com/docs"
}

user scopeで登録すると、このエントリは~/.claude.jsonのトップレベルのmcpServersに入ります。local scopeではプロジェクトのパスの下に入るため、別のプロジェクトでは見えません。

削除は、スコープを付けずに実行する方が確実です。Claude Code v2.1.289で、local scopeに登録した直後に削除した結果は次のとおりです。

# local scopeで登録した直後に、--scope userを付けて削除する
claude mcp remove twilio-docs --scope user
# => No MCP server named "twilio-docs" in user scope
 
# スコープを付けずに削除する
claude mcp remove twilio-docs
# => Removed MCP server "twilio-docs" from local config

claude mcp remove --helpには、スコープを指定しなければ、サーバーが存在するスコープから削除するとあります。Twilioの案内はremove twilio-docs --scope userの形ですが、これはuser scopeで登録した場合の書き方です。local scopeで入れたなら、スコープ指定なしで消せます。

同じ名前を複数のスコープに登録してしまった場合は、スコープを付けて1つずつ消します。公式docsも、エンドポイントの違う同名定義が重なったときはclaude mcp remove <name> --scope <scope>で不要な側を消すよう案内しています。

すでにコネクタで入れている場合

Claude.ai・Claude Desktop・Claudeモバイルアプリのコネクタ一覧で「Twilio」を検索してインストールする方法もあります。こちらはCLIコマンドが要らず、チャットでTwilioのAPI仕様を質問する使い方に向きます。

Claude Code公式docsによると、Claude Codeにclaude.aiアカウントでログインしていれば、claude.aiに追加したコネクタはClaude Codeでも自動的に使えます。コネクタ側で入れておけば、claude mcp addをやり直す必要はありません。

両方に同じエンドポイントがあると、Claude Codeはclaude mcp addで入れた側を優先します。公式docsの優先順位はlocal、project、user、プラグイン、claude.aiコネクタの順で、エンドポイントが同じコネクタは重複とみなされ、/mcpで隠れた状態になります。

つまずきやすい点

「Twilioで実際にSMSを送って」という指示は、このサーバー単体では通りません。CIやスクリプトから自動でAPIを叩く場合も、Twilioの認証情報を使うAPIクライアントが別途要ります。

バージョン違いの検索結果にも注意します。Programmable Messagingのように複数バージョンを持つAPIでは、v2010が旧版、v1が現行版です。twilio__searchは既定で最新バージョンの結果を返すので、旧版の仕様を見たいときはfilter.versionでバージョンを指定します。

検索結果の質はモデルにも左右されます。検索結果の有用性と、エージェントがその結果をどう使うかは、コーディングエージェントを動かしているモデルの性能次第です。同じクエリでも、モデルによって選ぶオペレーションや解釈が変わることがあります。

フィードバックやバグ報告はquestions-mcp@twilio.com宛てです。

まとめ

共有するならproject、手元だけならlocalかuserと、スコープは入れる前に決めておけます。Twilioの案内どおりの--scope user付き削除は、localで登録していると失敗します。

MCPサーバーの基本設定(スコープ・.mcp.json・OAuth認証)を先に押さえたい場合はClaude Code MCP設定ガイドが、Claude Code全体の中での位置づけは旗艦ガイドが扱っています。HTTPトランスポートで接続するホスト型MCPの例はVercel MCPサーバーの使い方にあります。読み取り専用のドキュメント検索というTwilioの設計とは対照的に、書き込み系の操作まで含む例がSonarQubeのMCPサーバーをClaude Codeに接続する手順です。接続後にツール一覧の表示が遅れる・古く見える場合はMCP_DISCOVERY_CACHEとはも参考になります。