ClawdCall

ClawdCall MCP サーバー

Model Context Protocol を通じて、AI エージェントが ClawdCall のエージェント向け電話実行 API を利用できるようにします。

clawdcall-mcp は、確認済みの ClawdCall ワークフローを公開します。

• 登録用 OTP を送信する
• 登録用 OTP を検証する
• 想定された発信を行う
• 通話の文字起こしを取得する

ホスト型リモート接続

互換性のあるリモート MCP クライアントを、Streamable HTTP エンドポイントに接続します。

https://gateway.clawdcall.com/mcp/

このエンドポイントは OAuth 保護リソースメタデータを提示します。既存の ClawdCall 統合では、エージェント向けドキュメントに従って API キーを使用することもできます。

ローカル Stdio パッケージ

公開済みの npm パッケージをローカル MCP クライアントに追加します。

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key"
      }
    }
  }
}

発信と文字起こしの取得には CLAWDCALL_API_KEY が必要です。登録用 OTP ツールには既存のキーは必要ありません。

ステージング環境またはセルフホスト型の API ルーティングを使用する場合：

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key",
        "CLAWDCALL_BASE_URL": "https://api.clawdcall.com"
      }
    }
  }
}

安全な初回テスト

1. ClawdCall エージェントのセットアップを開きます。
2. 互換性のあるエージェントクライアントから、ホスト型エンドポイントまたはローカルパッケージに接続します。
3. 範囲を限定したタスクを依頼し、エージェントから自分自身、または想定される社内の受信者に電話をかけてもらいます。
4. 通話を許可する前に、発信先とタスクを確認します。
5. 返されたステータス、文字起こしの証拠、要約、または構造化された結果を確認します。

ClawdCall は、コールドコール、自動発信電話、バルクアウトリーチ、緊急用途、政治的なアウトリーチ、または機微な助言を行うワークフローを目的としていません。

コピーしてすぐに使える例

examples ディレクトリには、範囲を限定した初回通話ワークフローが含まれています。

• MCP による自分自身への通話
• OpenAI Agents SDK
• LangGraph を利用するエージェント
• 署名付き Webhook からの通話アラート
• フライト変更の判断引き継ぎ

コード例では、受信者をオペレーターが管理する環境変数に設定します。エージェントが生成した入力によって電話番号が変更されることはなく、実際の副作用には明示的な承認またはオプトインが必要です。

ツール

ツール	確認済みエンドポイント	説明
send_signup_otp	POST /cc/signup/send-otp	登録用の電話番号確認 OTP を送信します。
verify_signup_otp	POST /cc/signup/verify-otp	OTP を検証し、アカウントと API キーの詳細を受け取ります。
place_outbound_call	POST /external/v1/agent/outbound?conversionFlag=1	想定された音声エージェントの発信を行います。
get_call_transcript	GET /cc/v1/calls/{id}/transcript	通話 ID またはキャンペーン ID で文字起こしを取得します。

環境変数

変数	必須	デフォルト	説明
CLAWDCALL_API_KEY	通話／文字起こしツールで必要		ClawdCall API キーです。
CLAWDCALL_BASE_URL	いいえ	https://api.clawdcall.com	API のベース URL です。

開発

git clone https://github.com/dialgoodian/clawdcall-mcp.git
cd clawdcall-mcp
npm install
npm run dev

ビルド：

npm run build

ビルド済みサーバーを実行します。

CLAWDCALL_API_KEY=your_clawdcall_api_key npm start

ディスカバリーメタデータ

• server.json には Official MCP Registry のメタデータが含まれています。
• サーバーカード
• エージェントが読み取れるドキュメント
• OpenAPI の説明

API コントラクト

このサーバーは、以下の ClawdCall エージェント向けエンドポイントを対象としています。

• POST /cc/signup/send-otp
• POST /cc/signup/verify-otp
• POST /external/v1/agent/outbound?conversionFlag=1
• GET /cc/v1/calls/{id}/transcript

ClawdCall の API コントラクトにルートが追加されるまでは、エージェント、番号購入、SMS、会話、音声、一般的な Webhook 用の MCP ツールを追加しないでください。

ライセンス

MIT