Next TokenParallel World

← ラボ / Claude Code ガイド / 連携台帳

Twilio Inc.・通信・メッセージ・海外　公式サイト
SMS・MMS・音声通話などをAPIで送受信できる通信プラットフォーム。公式のCLI解説ページでは「ターミナルから Twilio API を操作し、電話番号の管理やAPI呼び出し、webhookのテストができる」と説明されている。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか 未確認
公式ドキュメントMCP（https://mcp.twilio.com/docs）は『It does not execute API calls on your behalf.』『No Twilio account or API keys needed.』で、アカウントのデータには触れない。アカウントのデータを読み取りだけで渡す専用モードは確認できていない。Restricted キーは『Each permission maps to one or more endpoints/actions for each API Resource』で、例として『Call Resource の作成（POST）だけを許可する』キーが挙がるが、読み取り専用のプリセットや Read/Create/Update/Delete の区分の記載は無い（restricted-api-keys）。
権限（スコープ）を選べるか あり
APIキーの種類（api-keys）: Main＝『Full access to all Twilio API resources. Equivalent to using your Account SID and Auth Token』（Console のみで作成）／Standard＝Accounts と一部の Keys リソースを除く全リソース／Restricted＝特定のAPIリソースへの細かい権限（REST作成は v1 のみ。1キーあたり最大100権限）。twilio-labs/mcp は --services / --tags で公開APIを絞れる（READMEは主にコンテキスト量対策として記載）。
危険な操作の既定
制御の記載なし（CLI・API・twilio-labs/mcp で送信や削除を行う際の確認の仕組みは読んだ範囲に無い）。公式ブログ（2025-04-01）には『Claude will prompt you to allow the tool to run』とあるが、これは Claude 側の挙動で Twilio の機能ではない。同ブログは Cline の auto run では承認なしでMCPコマンドが実行されたと記載。送信はセグメント課金。
削除ができるか できる
メッセージリソースの概要に『Delete messages from your account』。DELETE の節は取得結果が途中で切れて読めておらず、取り消し可否は未確認。本文のみ消す redact（Body を空文字で更新）は『primarily used to redact Message content』で、他のプロパティは残る。
取り消し方（キー・接続）
『If a key is compromised or no longer used, revoke it』（api-keys）。手順は Console または REST で管理するとだけ案内され、api-keys ページ内には手順なし。

根拠のページ

つなぎ方（公式の資料にある範囲）

公式MCP あり

【ホスト型ドキュメントMCP】https://mcp.twilio.com/docs（Public Beta）。ツールは twilio__search（自然言語でAPI操作・ドキュメント・IDを検索）と twilio__retrieve（APIのパラメータ・レスポンススキーマを取得）の2つだけ。公式に「It does not execute API calls on your behalf.」とあり、SMS送信・通話・削除は実行できない（API直接実行は『今後の追加予定』扱い）。認証は不要（公開APIスペックのみを索引）。【別リポジトリ】GitHub twilio-labs/mcp（README の表記は『Twilio Alpha』）は『Twilio の API 全体をMCPツールとして公開する』と書かれており、アカウントSID/APIキー/シークレットで動く。Twilio の公式ブログ（2025-04-01、Twilio の Emerging Tech and Innovation チーム）が『Twilio Alpha MCP server』として紹介し、npm の @twilio-alpha/mcp または twilio-labs/mcp で入手でき、『limited to local execution with no user authentication support』と書いている。リポジトリには archived/deprecated の表示がない。ライセンスは LICENSE ファイルが MIT License（Copyright (c) 2025 Twilio Alpha）、README は『licensed under the ISC License』で、リポジトリ内で食い違いが残る。ドキュメントMCPのページは twilio-labs/mcp に触れておらず、上記ドキュメントMCPとは別の製品として案内されている。

つなぎ方（公式の記載）
claude mcp add --transport http twilio-docs https://mcp.twilio.com/docs （公式ページの記載）。twilio-labs/mcp は README に npx -y @twilio-alpha/mcp を使う mcpServers JSON の例（引数に ACCOUNT_SID/API_KEY:API_SECRET）。twilio-labs/mcp に Claude Code 向けの記載は無い。ドキュメントMCPのページには claude mcp list / get / remove --scope user の記載と、『Claude users can install the Twilio connector from the Claude connectors directory』の記載もある（コネクターの具体的な接続先・権限は未確認）。

根拠のページ

公式CLI あり

Twilio CLI（twilio-cli）。インストールは brew tap twilio/brew && brew install twilio、または npm install -g twilio-cli（npm版は自動更新されない）。twilio login で Account SID と Auth Token を入力すると、CLIがAPIキーを作成しプロファイルとしてローカルに保存。SMS送信例: twilio api core messages create --from ... --to ... --body ...（api:core:messages:create と同じ）。クイックスタートに削除コマンドの例は無い。

根拠のページ

公式API あり

Twilio REST API（製品ごとにAPI）。メッセージ送信は POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json。公式に『Your account is charged for each segment sent or received.』。本文の redact（Body を空文字で更新）も可能。メッセージ概要には『Delete messages from your account』とあるが、削除の詳細節は読めていない。

根拠のページ

第三者製MCP（公式ではない） 2件

  • deshartman/twilio-messaging-mcp-server（作者: deshartman（GitHubユーザー））
    書き込み・削除: True
    READMEは『Twilio APIでSMSを送るMCPサーバー』。ツールは send-sms の1つ（メッセージ送信）。削除・変更のツールの記載は無い。ライセンスMIT。Twilioとの提携の有無はREADMEに記載なし。最終更新日は表示から読み取れず。
    https://github.com/deshartman/twilio-messaging-mcp-server
  • 0x-Professor/Twilio-mcp-server（作者: 0x-Professor（GitHubユーザー））
    書き込み・削除: True
    READMEは『MCP対応クライアントからTwilioのSMS/MMSを扱うサーバー』。ツールは16個で、送信（sms_send／sms_send_bulk）、予約（sms_schedule／sms_cancel_scheduled）、削除（sms_delete_message）、秘匿化（sms_redact_message）を含む。ライセンスMIT。Twilioとの提携の有無はREADMEに記載なし。最終更新日は表示から読み取れず。
    https://github.com/0x-Professor/Twilio-mcp-server

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所（5件）

できる操作

読み取りでできる操作

  • 【MCP】twilio__search / twilio__retrieve でAPI仕様・ドキュメントを検索（アカウントのデータには触れない）
  • 【CLI】twilio api core messages list（メッセージ一覧。クイックスタートの例）
  • 【API】メッセージリソースの取得（price・num_segments・status 等の項目が返る）

書き込みでできる操作

  • 【CLI】twilio api core messages create（SMS送信。課金対象）
  • 【API】POST Messages.json でSMS/MMS送信（セグメントごとに課金）
  • 【API】メッセージ本文の redact（Body を空文字にする）
  • 【MCP】公式ドキュメントMCPは書き込み不可（API実行しない）。twilio-labs/mcp は Twilio API 全体をツール化と記載（個別の送信・通話ツールの記載は読んでいない）

管理者操作（削除・課金・設定変更など）

  • 【API】メッセージの削除（メッセージ概要に『Delete messages from your account』と記載。エンドポイントと取り消し可否は未確認）
  • 【API】APIキーの管理: Main キーは Console でのみ作成、Standard は Accounts と一部の Keys リソースを除く全リソース、Restricted は『Customized, fine-grained access』（1キー最大100権限。Access Token〔クライアントSDK用〕は Restricted キーでは作れない）
  • 【CLI】クイックスタートに削除・番号購入のコマンドは無い（番号管理ができるとは概要に記載、購入可否は未確認）

制限

  • ホスト型ドキュメントMCPは Public Beta で、Twilio Support Terms・SLAの対象外と公式に記載
  • MCPの機能は一般提供前に変わる可能性、検索品質は使うAIモデルに依存と公式に記載
  • APIキーは地域別（リージョンCLIプロファイルは --region と --edge の両方が必要）
  • 米国SMSは前払い・従量の記載ではなくセグメント課金。A2P 10DLC・RCS送信者は登録費が必要な場合あり
注意
  • 【最優先・送信】SMS送信（CLI/API）はセグメントごとに課金され、公式の読んだ範囲に確認プロンプトの記載は無い。Mainキーを渡すと全リソースに全権限
  • 【最優先・削除】メッセージ削除ができると概要に記載。取り消し可否は未確認
  • 【キー権限】公式のキー種別（api-keys）: Main＝Account SID+Auth Token と同等の全権限、Standard＝Accounts と一部の Keys リソースを除く全リソース、Restricted＝特定のAPIリソースへの細かい権限。AIに渡す際にどのキーを使うかについて、公式ページ（api-keys、restricted-api-keys）に記載は見当たらない。公式に『If a key is compromised or no longer used, revoke it』と書かれている
  • twilio-labs/mcp の README に『avoid installing or running any community MCP servers alongside our official ones』と注意書きがある（公式ブログにも同趣旨の記載）
  • docs MCP は公式に『It does not execute API calls on your behalf.』と記載（APIを実行しないため、このMCP経由の送信・課金は発生しない）

認証・料金・日本語・実機検証

認証方式
【API/CLI】Account SID + Auth Token、またはAPIキー（Main/Standard/Restricted）。CLIは twilio login でAPIキーを自動作成。【MCP・docs】認証なし。【MCP・twilio-labs】ACCOUNT_SID/API_KEY:API_SECRET
公表されている料金（2026年10月16日確認）
米国SMS: 送信・受信とも $0.0083/セグメント（長コード・フリーダイヤル・ショートコード）、MMS送信 $0.022。電話番号 月 $1.15（長コード、Twilio提供）／$2.15（フリーダイヤル）。別途キャリア料金、失敗メッセージ処理費 $0.001。『Pricing current as of October 2026』、価格は予告なく変更される旨の記載あり（米国向けページ・USD。日本向け料金は未確認） 料金ページ
日本語対応
あり。日本語の公式ページが実在する（www.twilio.com/ja-jp/blog/flex-localization-plugin-jp は日本語、ヘッダーに『日本語』表示）。一方、jp.twilio.com/docs/api/twiml/say は英語版ドキュメント（www.twilio.com/docs/voice/twiml/say）へリダイレクトされ、日本語のAPIドキュメントは確認できなかった。同ブログに『Flexは既定でUIが英語』とある。Twilioコンソール（管理画面）の日本語の有無は未確認。
Claude Code実機検証
未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）
確認できていない点（10件）
  • メッセージ削除（DELETE）の詳細節（取り消し可否・エンドポイント）は本文が切れて読めなかった
  • 通話発信（Voice API）・電話番号購入のAPI/CLIの記載は読んでいない
  • Restricted キーはメソッド・エンドポイント単位で絞れる例（Call Resource の作成〔POST〕だけを許可するなど）があるが、読み取り専用にする設定は公式（restricted-api-keys）に記載なし。権限の全一覧は未読
  • twilio-labs/mcp の最終コミット日・サポート状況（archived/deprecated の表示なし。LICENSE は MIT、README は ISC と書き食い違い）
  • 日本語ドキュメント・Consoleの日本語、日本向け料金
  • 第三者製MCPは運営者・更新日を確認していない
  • 2026-10-17再確認で残った点: permission.read_only: Restricted APIキーはコンソールで『指定したAPIリソースに対して許可する操作』を選べる（公式のIAM APIキー・Consoleガイド・Restricted keys公開ベータのお知らせ）が、『読み取り専用』という語や、読み取り系だけを選べるとの明記は開いたページに無かった。キー削除は Console の Settings > Account settings > API keys & auth tokens > キー名 > Delete this key（確認済み、https://www.twilio.com/docs/iam/api-keys/keys-in-console）
  • 2026-10-17再確認で残った点: ja: 前回から変わらず未確認
  • 2026-10-17再確認で残った点: 参考: github.com/twilio-labs/mcp（Twilio Labs）はTwilio自身の組織のリポジトリ（Glamaの掲載ページで確認）で、第三者には含めていない。Glama上は『Inactive』表示
  • 2026-10-17再確認で残った点: permission.read_only: 『Restricted API keys』『API keys in Console』『API keys』の各ページを開いたが、Restrictedキーは『Customized, fine-grained access to specific Twilio API resources』『Each permission maps to one or more endpoints/actions for each API Resource』『1キー最大100権限』とあるのみで、読み取り専用の項目・プリセットの記載は無い（詳細な権限一覧はページ内リンクのPDFにあるとされ、PDFは開けず）。
出典（12件）

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。