Justcall Mcp Server

JustCall MCP サーバー

JustCall の Model Context Protocol（MCP） サーバーを使うと、LLM や AI エージェントが JustCall の API を介して、実際の音声通話や SMS の送受信を安全かつ文脈に即してプログラムから実行できます。

会話型 AI システム向けの関数呼び出しインターフェースを提供し、次のことを可能にします。

• 📞 AI による通話：LLM が JustCall を使って通話を開始、管理、または文字起こしできます。
• 💬 スマートメッセージング：AI エージェントが会話中に SMS を送信したり、返信したりできます。
• ⚙️ シームレスな統合：MCP 標準を使って、JustCall の電話機能をあらゆる LLM ランタイムやオーケストレーションフレームワークに接続できます。

つまり、LLM に声と電話番号を与え、チャットボットを真に会話できるエージェントへと変えます。

Claude Desktop のセットアップ

1. Claude Desktop を開き、CMD + , を押して Settings に移動します。
2. Connectors タブをクリックします。
3. Add Custom Connector ボタンをクリックします。
4. 名前に JustCall、リモートサーバー URL に https://mcp.justcall.host/mcp を入力します。
5. Connectors の一覧で JustCall の Connect ボタンをクリックします。
6. API キーとシークレットの入力を求める JustCall のページが開きます。
7. JustCall ダッシュボード（https://app.justcall.io/app/developersApiCredentials）で JustCall API キーとシークレットを取得します。
8. API キーとシークレットを入力して Continue を押すと、Claude に戻ります。

Claude Web - https://claude.ai

1. ブラウザーでコネクターの URL を開きます（https://claude.ai/settings/connectors）。
2. Connectors タブをクリックします。
3. Add Custom Connector ボタンをクリックします。
4. 名前に JustCall、リモートサーバー URL に https://mcp.justcall.host/mcp を入力します。
5. Connectors の一覧で JustCall の Connect ボタンをクリックします。
6. API キーとシークレットの入力を求める JustCall のページが開きます。
7. JustCall ダッシュボード（https://app.justcall.io/app/developersApiCredentials）で JustCall API キーとシークレットを取得します。
8. API キーとシークレットを入力して Continue を押すと、Claude に戻ります。

Chat GPT（Plus、Pro、Business、Enterprise でのみ利用可能）

1. ブラウザーでコネクターの URL を開きます（https://chatgpt.com/#settings/Connectors）。
2. Apps & Connectors タブをクリックします。
3. 詳細設定で開発者モードが有効になっていることを確認します。
4. Create ボタンをクリックします。
5. 名前に JustCall、MCP サーバー URL に https://mcp.justcall.host/mcp を入力します。その他の項目は空欄のままで構いません。
6. Connectors の一覧で JustCall の Connect ボタンをクリックします。
7. API キーとシークレットの入力を求める JustCall のページが開きます。
8. JustCall ダッシュボード（https://app.justcall.io/app/developersApiCredentials）で JustCall API キーとシークレットを取得します。
9. API キーとシークレットを入力して Continue を押すと、Chat GPT に戻ります。

リモート MCP

JustCall の MCP サーバーにリモート接続するには、次の手順に従います。

Streamable HTTP（推奨）

デフォルトかつ推奨される接続方法は、Streamable HTTP Transport を使用する方法です。

• Streamable HTTP Transport を使用する任意の MCP クライアントから https://mcp.justcall.host/mcp に接続します。
• リクエストヘッダーに JustCall API キーをベアラートークンとして含めます。
• ヘッダーの例：Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

認証とセキュリティ

JustCall MCP サーバーは、すべてのエンドポイントへの安全なアクセスのために OAuth2 認証を実装しています。

OAuth2 の設定

サーバーは、次の機能を備えた OAuth2 認可に対応しています。

• 認可エンドポイント：OAuth2 認可サーバーのメタデータは /.well-known/oauth-authorization-server で利用できます。
• グラントタイプ：PKCE（Proof Key for Code Exchange）を使用する認可コードフロー
• コードチャレンジ方式：S256（SHA-256）
• トークン認証：すべての MCP エンドポイントと SSE エンドポイントで、ベアラートークン認証が必要です。

保護されたエンドポイント

以下のエンドポイントでは、有効な Bearer トークンによる認証が必要です。

• /mcp - メインの MCP エンドポイント
• /sse - Server-Sent Events エンドポイント
• /sse/message - SSE メッセージエンドポイント

認証ヘッダーの形式

JustCall API の認証情報を Bearer トークンとして指定します。

Authorization: Bearer <JWT_TOKEN_BY_OAUTH>
Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

公開エンドポイント

以下のエンドポイントは公開されています。

• /health - ヘルスチェックエンドポイント（200 OK を返します）
• /.well-known/oauth-authorization-server - OAuth2 認可サーバーのメタデータ

API の使用とレート制限

この MCP サーバーは JustCall Developer API を使用します。すべての API リクエストには、JustCall API キーに関連付けられたレート制限が適用されます。JustCall API credentials configuration を参照してください。

利用可能なツール

JustCall MCP Server は、以下のカテゴリに分類された 66 個のツールを提供します。

JustCall API ツール

📞 通話（6 個のツール）

• list_calls - さまざまな条件で絞り込んで、JustCall のすべての通話を一覧表示します
• get_call - ID で指定した JustCall の通話を取得します
• update_call - JustCall の通話を更新します（処理結果、メモ、評価）
• get_call_journey - 特定の通話のイベントシーケンスを取得します
• get_voice_agent_data - 特定の通話の音声エージェントデータを取得します（非推奨。代わりに get_voice_agent_call を使用してください）
• get_voice_agent_call - 特定の通話に関連する音声エージェントデータを取得します

👥 ユーザーとエージェント（3 個のツール）

• list_users - アカウント内のすべてのユーザー／エージェントを一覧表示します
• get_user - 特定のユーザー／エージェントの詳細情報を取得します
• update_user_availability - ユーザーの通話対応状況を、対応可能または対応不可に更新します

💬 SMS とメッセージ（11 個のツール）

• send_sms - 連絡先に SMS／テキストメッセージを送信します
• list_sms - すべての SMS／テキストメッセージを取得します
• get_sms - 特定の SMS／テキストメッセージの詳細情報を取得します
• check_sms_reply - 特定の連絡先から届いた最新の受信 SMS 返信を確認します
• list_sms_tags - テキストメッセージの整理に使用するすべての SMS タグを取得します
• get_sms_tag - 特定の SMS タグの詳細情報を取得します
• create_sms_tag - SMS の会話を整理するための新しいタグを作成します
• delete_sms_tag - 特定の SMS タグを削除します
• list_sms_threads - JustCall 番号に関連付けられたすべての SMS スレッド／会話を取得します
• get_sms_thread - ID で指定した SMS スレッド／会話を取得します
• add_sms_thread_tag - SMS スレッド／会話にタグを追加します

📇 連絡先（6 個のツール）

• list_contacts - CRM のすべての連絡先を取得します
• get_contact - ID で指定した連絡先の詳細情報を取得します
• create_contact - CRM に新しい連絡先を作成します
• update_contact - 既存の連絡先の詳細を更新／変更します
• update_contact_status - DND／DNM／ブラックリストのリストに連絡先を追加または削除します
• add_contacts_blacklist - 1 件以上の連絡先をグローバルブラックリストに一括追加します

📊 分析（4 個のツール）

• get_agent_analytics - 指定した期間のエージェント分析データを取得します
• get_account_analytics - 指定した期間のアカウント分析データを取得します
• get_number_analytics - 指定した期間の番号分析データを取得します
• get_sales_dialer_analytics - セールスダイヤラーキャンペーンの包括的な分析データを取得します

🔔 Webhook（2 個のツール）

• list_webhooks - 設定済みのすべての Webhook を取得します
• create_webhook - リアルタイム通知を受信するための新しい Webhook エンドポイントを作成します

📱 電話番号（2 個のツール）

• list_numbers - JustCall のすべての電話番号を取得します
• get_number - 特定の JustCall 電話番号の詳細情報を取得します

👥 ユーザーグループ（2 個のツール）

• list_user_groups - アカウントに定義されているすべてのユーザーグループを取得します
• get_user_group - ID で指定したユーザーグループの詳細情報を取得します

📅 予約（3 ツール）

• list_appointment_slots - 特定のカレンダーで予約可能なすべての時間枠を取得します
• create_appointment - 特定のカレンダーに新しい予約を登録します
• get_appointment - ID を指定して特定の予約の詳細を取得します

💚 WhatsApp（5 ツール）

• list_whatsapp_messages - アカウントに関連付けられたすべての WhatsApp メッセージを取得します
• get_whatsapp_message - ID を指定して特定の WhatsApp メッセージの詳細情報を取得します
• send_whatsapp_message - 連絡先の電話番号に新しい WhatsApp メッセージを送信します
• list_whatsapp_templates - アカウントで利用可能なすべての WhatsApp メッセージテンプレートを取得します
• check_whatsapp_message_reply - 連絡先から届いた最新の WhatsApp メッセージを確認します

🤖 AI 分析（4 ツール）

• list_calls_ai_analysis - すべての通話について、AI が生成した分析（文字起こし、要約、インサイト）を取得します
• get_call_ai_analysis - Call ID を指定して特定の通話の AI 生成分析を取得します
• list_meetings_ai_analysis - 録画されたミーティング（Zoom、Google Meet）の AI 生成分析を取得します
• get_meeting_ai_analysis - Instance ID を指定して特定のミーティングの AI 生成分析を取得します

🎙️ 音声エージェント（2 ツール）

• list_voice_agents - アカウントに関連付けられたすべての AI 音声エージェントを取得します
• create_voice_agent_call - 設定済みの AI 音声エージェントから連絡先に発信します

セールスダイヤラーツール

📢 キャンペーン（6 ツール）

• list_campaigns - すべてのセールスダイヤラーキャンペーンを取得します
• get_campaign - 特定のセールスダイヤラーキャンペーンの詳細情報を取得します
• create_campaign - 新しいセールスダイヤラーキャンペーンを作成します
• update_campaign - 名前、説明、ステータス、割り当てなど、キャンペーンの詳細を更新します
• list_salesdialer_campaign_contacts - 特定のキャンペーンに登録されているすべての連絡先を取得します
• add_salesdialer_campaign_contact - 特定のキャンペーンに連絡先を追加します

👥 連絡先（8 ツール）

• list_salesdialer_contacts - セールスダイヤラーのすべての連絡先を取得します
• get_salesdialer_contact - ID を指定して特定の連絡先の詳細情報を取得します
• create_salesdialer_contact - セールスダイヤラーに新しい連絡先を作成します
• update_salesdialer_contact - 既存の連絡先の詳細を更新・変更します
• import_salesdialer_contacts - 複数の連絡先をセールスダイヤラーまたはキャンペーンに一括でインポートします
• import_salesdialer_contacts_status - バッチ ID を指定して一括インポートジョブのステータスを確認します
• add_salesdialer_contacts_dnca - 1 件以上の連絡先を「再度電話をかけない」リストに一括で追加します
• list_salesdialer_custom_fields - セールスダイヤラーで定義されているすべてのカスタム連絡先フィールドを取得します

📞 通話（2 ツール）

• list_salesdialer_calls - セールスダイヤラー経由で行われたすべての通話を取得します
• get_salesdialer_call - ID を指定して特定のセールスダイヤラー通話の詳細情報を取得します

📊 分析（2 ツール）

• get_sales_dialer_analytics - セールスダイヤラーキャンペーンの包括的な分析データを取得します
• get_salesdialer_agent_analytics - 特定のキャンペーンにおけるエージェントの通話パフォーマンス分析を取得します。