Justcall Mcp Server

JustCall MCP 服务

JustCall Model Context Protocol (MCP) 服务让大模型 (LLM) 和 AI Agent 可以直接通过 JustCall 的 API 进行真实语音通话和发送 SMS——安全、带上下文且可编程。

它为对话式 AI 系统提供函数调用接口，支持：

• 📞 AI 驱动的通话：让你的大模型使用 JustCall 发起、管理或转录通话。
• 💬 智能消息：让你的 AI Agent 在对话中发送或回复 SMS。
• ⚙️ 无缝集成：使用 MCP 标准将 JustCall 的电话能力与任何大模型运行时或编排框架连接起来。

简而言之：它让你的大模型拥有声音和电话号码——将聊天机器人变成真正能对话的 Agent。

Claude Desktop 设置

1. 打开 Claude Desktop 并按 CMD + , 进入 Settings。
2. 点击 Connectors 标签页。
3. 点击 Add Custom Connector 按钮。
4. 将名称添加为 JustCall，将 Remote Server Url 添加为 https://mcp.justcall.host/mcp。
5. 现在在 Connectors 列表中，点击 JustCall 对应的 Connect 按钮。
6. 它会打开一个 JustCall 页面，要求提供 API key 和 secret。
7. 从 JustCall 仪表盘获取你的 JustCall API Key 和 Secret（https://app.justcall.io/app/developersApiCredentials）。
8. 输入 API key 和 Secret 并按 Continue，它应该会将你重定向回 Claude。

Claude Web - https://claude.ai

1. 在浏览器中打开 connectors 网址 - https://claude.ai/settings/connectors。
2. 点击 Connectors 标签页。
3. 点击 Add Custom Connector 按钮。
4. 将名称添加为 JustCall，将 Remote Server Url 添加为 https://mcp.justcall.host/mcp。
5. 现在在 Connectors 列表中，点击 JustCall 对应的 Connect 按钮。
6. 它会打开一个 JustCall 页面，要求提供 API key 和 secret。
7. 从 JustCall 仪表盘获取你的 JustCall API Key 和 Secret（https://app.justcall.io/app/developersApiCredentials）。
8. 输入 API key 和 Secret 并按 Continue，它应该会将你重定向回 Claude。

Chat GPT（仅在 Plus、Pro、Business 和 Enterprise 上可用）

1. 在浏览器中打开 connectors 网址 - https://chatgpt.com/#settings/Connectors。
2. 点击 Apps & Connectors 标签页。
3. 确保在高级设置中启用了开发者模式
4. 点击 Create 按钮。
5. 将名称添加为 JustCall，将 MCP Server Url 添加为 https://mcp.justcall.host/mcp。你可以跳过其他字段。
6. 现在在 Connectors 列表中，点击 JustCall 对应的 Connect 按钮。
7. 它会打开一个 JustCall 页面，要求提供 API key 和 secret。
8. 从 JustCall 仪表盘获取你的 JustCall API Key 和 Secret（https://app.justcall.io/app/developersApiCredentials）。
9. 输入 API key 和 Secret 并按 Continue，它应该会将你重定向回 Chat GPT。

远程 MCP

要远程连接到 JustCall 的 MCP 服务：

Streamable HTTP（推荐）

默认且推荐的连接方式是通过 Streamable HTTP Transport：

• 使用 Streamable HTTP Transport 从任何 MCP 客户端连接到 https://mcp.justcall.host/mcp
• 在请求头中将你的 JustCall API key 作为 bearer token 包含在内
• 示例请求头：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）的授权码流程
• Code Challenge Method：S256 (SHA-256)
• Token 身份验证：所有 MCP 和 SSE 端点都需要 Bearer token 身份验证

受保护的端点

以下端点需要有效的 Bearer token 认证：

• /mcp - 主 MCP 端点
• /sse - Server-Sent Events 端点
• /sse/message - SSE 消息端点

认证头格式

将你的 JustCall API 凭据作为 Bearer token 包含在内：

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 凭据配置。

可用工具

JustCall MCP 服务提供 66 个工具，分为以下类别：

JustCall API 工具

📞 通话（6 个工具）

• list_calls - 列出所有 JustCall 通话，支持多种筛选选项
• get_call - 通过 ID 获取特定的 JustCall 通话
• update_call - 更新 JustCall 通话（处置、备注、评分）
• get_call_journey - 获取特定通话的事件序列
• get_voice_agent_data - 获取特定通话的语音 Agent 数据（已弃用，请使用 get_voice_agent_call）
• get_voice_agent_call - 获取特定通话的语音 Agent 相关数据

👥 用户与 Agent（3 个工具）

• list_users - 列出账户中的所有用户/Agent
• get_user - 获取特定用户/Agent 的详细信息
• update_user_availability - 将用户的可用状态更新为可接听或不可接听通话

💬 短信与消息（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/Blacklist 列表或从中移除
• add_contacts_blacklist - 将一个或多个联系人批量添加到全局黑名单

📊 分析（4 个工具）

• get_agent_analytics - 获取指定日期范围的 Agent 分析数据
• 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 生成分析

🎙️ 语音 Agent (2 个工具)

• list_voice_agents - 检索与该账户关联的所有 AI 语音 Agent
• create_voice_agent_call - 从已配置的 AI 语音 Agent 向联系人发起外呼

Sales Dialer 工具

📢 营销活动 (6 个工具)

• list_campaigns - 检索所有 Sales Dialer 营销活动
• get_campaign - 检索特定 Sales Dialer 营销活动的详细信息
• create_campaign - 创建一个新的 Sales Dialer 营销活动
• update_campaign - 更新营销活动详情，包括名称、描述、状态和分配
• list_salesdialer_campaign_contacts - 检索特定营销活动中的所有联系人
• add_salesdialer_campaign_contact - 将联系人添加到特定营销活动

👥 联系人 (8 个工具)

• list_salesdialer_contacts - 检索 Sales Dialer 中的所有联系人
• get_salesdialer_contact - 通过 ID 检索特定联系人的详细信息
• create_salesdialer_contact - 在 Sales Dialer 中创建一个新联系人
• update_salesdialer_contact - 更新/修改现有联系人的详细信息
• import_salesdialer_contacts - 批量导入多个联系人到 Sales Dialer 或某个营销活动
• import_salesdialer_contacts_status - 通过批次 ID 检查批量导入任务的状态
• add_salesdialer_contacts_dnca - 批量将一个或多个联系人添加到“Do Not Call Again”列表
• list_salesdialer_custom_fields - 获取 Sales Dialer 中定义的所有自定义联系人字段

📞 通话 (2 个工具)

• list_salesdialer_calls - 检索通过 Sales Dialer 进行的所有通话
• get_salesdialer_call - 通过 ID 检索特定 Sales Dialer 通话的详细信息

📊 分析 (2 个工具)

• get_sales_dialer_analytics - 检索 Sales Dialer 营销活动的全面分析数据
• get_salesdialer_agent_analytics - 检索特定 Agent 在某个营销活动中的通话表现分析。