MCP 経由で Plivo を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Plivo をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Plivo + Cursor

AI に Plivo を操作させます。残高と料金の確認、SMS と MMS の送信、通話の発信と通話記録の参照、通話中の通話の終了、録音と文字起こしの一覧、電話番号の検索と照会、Verify によるワンタイムコードの送信と確認ができます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN

ステップ 1 — 認証情報を取得

1. https://cx.plivo.com の Plivo コンソールにサインインします。
2. 概要ページから Auth ID（MA で始まり、サブアカウントの場合は SA で始まります）と Auth Token をコピーします。サブアカウント（Account → Subaccounts）を使うと、コネクタがアクセスできる範囲を制限できます。
3. それぞれを PLIVO_AUTH_ID と PLIVO_AUTH_TOKEN に貼り付け、コネクタをインストールします。
4. plivo_get_account で設定を確認します。アカウント、課金方式、残りのクレジットが表示されます。

トライアルアカウントでも読み取りはできます。送信と発信にはクレジットが必要で、トライアルでは認証済みの番号も必要です。

誰が何を見られるか: Auth Token は Plivo アカウント全体の権限で動き、その残高を使えます。MCP サーバーは、このアカウントでお金を使ってよい人とだけ共有してください。メッセージログ、通話記録、電話番号、録音、文字起こしは個人データです。録音のリンクは、持っていれば誰でも再生できます。

費用がかかり実在の人に届くため、AI は先に確認します: Plivo は plivo_send_message（SMS と MMS、メッセージのパートと宛先ごと）、plivo_make_call（分単位）、plivo_send_verification（認証 1 回ごと、加えて SMS または通話の料金）に課金します。AI はそれぞれの前に送信元、宛先、内容を示し、ご希望があれば plivo_get_pricing の料金も添えて、あなたの承認を待ちます。plivo_lookup_number は照会ごとに課金されるため、数件を超える番号を照会する前に、AI が件数と費用をお知らせします。

インストール時に無効: plivo_buy_number は、初期費用と月額料金で番号をレンタルし、番号を解約するまで課金が続きます。plivo_search_available_numbers による検索は無料です。plivo_hangup_call も無効です。通話中の通話を切断するツールで、通話 ID が指定されていないと、Plivo はアカウントで通話中のすべての通話を終了します。どちらも管理者が意図して有効にするツールです。有効にした後も、AI は番号とその費用、または通話の番号と開始時刻を示し、あなたの確認後にだけ実行します。

SMS: plivo_send_message は message_uuid を返します。plivo_get_message は配信状況、課金されたパート数、料金を示し、plivo_list_messages で送受信の状況を確認できます（本文は含まれません）。米国またはカナダの送信元は 10DLC またはトールフリーの SMS 送信の登録が必要で、登録がないとメッセージは失敗します。

通話には answer URL が必要です: plivo_make_call は相手の番号を呼び出し、応答されると answer_url を取得します。answer_url は、ご自身のサーバーでホストした Plivo XML を返す必要があります（例: <Response><Speak>こんにちは</Speak></Response>）。time_limit を設定すると費用を抑えられます。通話中の通話: plivo_list_live_calls と plivo_get_live_call。終了した通話: plivo_list_calls と plivo_get_call で、通話時間、課金対象時間、料金、切断理由がわかります。録音: plivo_list_recordings、plivo_get_recording、そして録音に文字起こし（Plivo の有料オプション）を注文した場合は plivo_get_transcription。

Verify: plivo_send_verification は SMS または音声通話でワンタイムコードを送り、plivo_validate_verification は相手が入力したコードを確認します（1 回ごとに試行回数の上限にカウントされます）。plivo_get_verification はステータスと料金を示します。

番号と時刻: 番号は E.164 形式（+819012345678）で送ってください。Plivo の一覧では先頭の + が付かずに表示されます。時刻の絞り込みは UTC で YYYY-MM-DD HH:MM:SS の形式です。通話と録音の検索は、期間を指定しなければ直近 7 日間が対象で、1 回の検索は最大 30 日間です。

レート制限: アカウントごとに 5 秒あたり 300 リクエストです。発信通話には、1 秒あたりの発信数と同時通話数の上限もあります（403 Concurrency Limit Breached）。429 が返ったら、少し待ってから再試行してください。

よくあるエラー: 401: Auth ID または Auth Token が間違っているか、トークンが再生成されています。403: アクセス権のないサブアカウント、または API access control の IP 制限です。404: このアカウントにそのメッセージ、通話、録音、番号はありません。400: パラメーターが不足しているか不正です。たとえば番号の形式や、アカウントが所有していない送信元などです。残高不足で送信や発信が失敗する場合: plivo_get_account でクレジットを確認し、コンソールでチャージしてください。

このコネクタは、WhatsApp テンプレート、電話会議と複数人通話、通話の転送と録音の制御、アプリケーションとエンドポイント、サブアカウント、コンプライアンス書類、番号の解約には対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Plivo のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「Plivo の残高はいくらですか？日本宛ての SMS 送信 1 通の料金も教えてください。」
• 「Plivo の番号から +819012345678 に、金曜 10 時の予約が確定したと SMS を送ってください。送る前に送信元、宛先、本文、料金を見せてください。」
• 「昨日のメッセージで、配信されなかったものや失敗したものはどれですか？エラーコードと費用を見せてください。」
• 「直近 7 日間で 5 分を超えた通話を、課金対象時間、料金、切断理由付きで一覧にしてください。」
• 「+819012345678 に SMS で認証コードを送ってください。送る前に確認してください。その後、お客様が読み上げたコードを確認してください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続