Deshartman Twilio Agent Payments MCP Server

🚀 Twilio MCP サーバー

Twilio の MCP（MCP プロトコル）サーバーは、Claude デスクトップとの統合に役立つ強力なツールです。開発者には、支払い処理、音声通話、その他の通信関連タスクを簡素化するための豊富な API と機能を提供します。このドキュメントでは、このサーバーの機能、使用方法、および設定の詳細について説明します。

✨ 主な機能

1. 支払い処理

• 支払いセッションの作成：新しい支払いセッションを初期化するための createPaymentSession メソッドを提供します。
• 支払い情報の収集：ユーザーの支払い情報を収集して処理するための capturePaymentInfo メソッドを提供します。
• 支払いステータスの照会：特定の支払いセッションのステータスを取得するための getPaymentStatus メソッドを提供します。

2. 音声通信

• 通話接続：新しい通話接続を確立するための connectCall メソッドを提供します。
• 転送機能：着信を指定の番号に転送するための forwardCall メソッドを提供します。
• メディア処理：Twilio の Media API を介したオーディオおよびビデオストリームの処理をサポートします。

3. ログ記録

• イベント駆動型ログ記録アーキテクチャ：すべてのツールとリソースクラスは、Node.js の EventEmitter を継承し、操作を記録するために 'log' イベントを発行します。
• ログレベルのサポート：info、error、debug、および warn（自動的に info レベルに変換）のログレベルをサポートします。

4. コールバックデータ処理

• 初期コネクタデータ：支払いセッションが最初に作成されたとき、Twilio はコネクタデータを送信します。
• 収集データの更新：支払い情報が収集されたとき、Twilio は更新されたコールバックデータを送信します。

📦 インストール

1. サーバーの初期化

MCP サーバーを手動で起動してテストするには、以下のコマンドを実行します。

# 実際のクレデンシャルを使用して実行
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret"

# または npm スクリプトを使用（開発環境）
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret"

Claude デスクトップで使用する場合、サーバーは自動的に起動します。

2. ログ記録の規則

• イベント駆動型ログ記録システム：すべてのツールとリソースクラスは、Node.js の EventEmitter を継承し、'log' イベントを発行します。
• ログ転送：これらのイベントはキャプチャされ、MCP サーバーのログシステムに転送されます。

// ツールログのイベントリスナー
startPaymentCaptureTool.on(LOG_EVENT, logToMcp);
captureCardNumberTool.on(LOG_EVENT, logToMcp);
// 他のツール...

3. 支払いコールバックデータ構造

初期コネクタデータ

支払いセッションが最初に作成されたとき、Twilio は以下のデータを送信します。

{
  "PaymentConnector": "PGP_MOCK",
  "DateCreated": "2021-08-10T03:55:53.408Z",
  "PaymentMethod": "credit-card",
  "CallSid": "CAzzzzz",
  "ChargeAmount": "100.00",
  "Currency": "USD"
}

収集データの更新

支払い情報が収集されたとき、Twilio は以下の更新データを送信します。

{
  "PaymentStatus": "captured",
  "Amount": "100.00",
  "TransactionId": "ABC123DEF"
}

📚 ドキュメント

互換性に関する説明

MCP チェックツールとの互換性

• ログレベルの処理：'warn' レベルを自動的に 'info' レベルに変換します。

セキュリティに関する注意事項

• PCI コンプライアンス：サーバーは PCI 標準に準拠しており、支払い情報の安全な保存と転送を保証します。
• クレデンシャル管理：環境変数または安全なクレデンシャル管理システムを使用して機密情報を保存することをおすすめします。

エラー処理

一般的なエラー

1. 無効なクレデンシャル：提供された Account SID、API Key、および Secret が有効な Twilio クレデンシャルであることを確認してください。
2. ネットワーク問題：サーバーと Twilio サービス間のネットワーク接続が正常であることを確認してください。

エラーログの例

{
  "error": {
    "code": "401 Unauthorized",
    "message": "Invalid authentication credentials"
  }
}

まとめ

Twilio の MCP サーバーは、支払いと通信関連のタスクを効率的に処理するための強力で柔軟なツールです。このドキュメントのガイドに従うことで、さまざまなニーズに合わせてこのサーバーを簡単に統合および設定することができます。