ConnexCS MCP应用程序
用于ConnexCS应用平台的可扩展MCP服务器
概述
该存储库包含一个用于ConnexCS的MCP（模型上下文协议）服务器，使GitHub Copilot等AI助手能够直接访问ConnexCS调用调试、分析和客户管理工具。基本上，使用户能够与ConnexCS平台聊天。
在VS代码中安装MCP服务器
按照以下步骤在任何VS Code工作区中配置ConnexCS MCP服务器：
步骤1：创建 .vscode 文件夹
在工作区根目录（项目的主文件夹）中，创建 .vscode 如果文件夹不存在：
mkdir .vscode或者在文件资源管理器中手动创建它。
步骤2：创建 mcp.json 文件
里面 .vscode 文件夹，创建一个名为的新文件 mcp.json:
# Windows PowerShell
New-Item -Path .vscode\mcp.json -ItemType File
# Mac/Linux
touch .vscode/mcp.json或者在代码编辑器中手动创建它。
步骤3：添加配置
将以下内容复制并粘贴到 .vscode/mcp.json:
{
"servers": {
"connexcs-call-debug": {
"url": "https://fr1dev1.connexcs.net/api/cp/scriptforge/8362/run",
"type": "http",
"headers": {
"Authorization": "Bearer YourJWTTokenHere"
}
}
},
"inputs": []
}步骤4：添加 mcp.json 到 .gitignore
⚠️ 重要提示：在添加令牌之前立即执行此操作！
这 mcp.json 文件将包含一个JWT令牌，这是一个 敏感凭证。如果承诺进行版本控制，任何有权访问存储库的人都可以使用您的令牌访问您的ConnexCS帐户。
打开或创建 .gitignore 在工作区根目录中创建文件并添加：
.vscode/mcp.json这可确保您的令牌不会意外推送到远程存储库。 不要跳过此步骤。
步骤5：获取JWT访问令牌
你需要一个JWT 访问令牌 从ConnexCS控制面板：
- 登录ConnexCS控制面板
- 在左侧边栏中，导航到 设置 → 集成 → JWT钥匙
- 点击
+按钮打开 添加JWT 对话 - 填写以下字段：
- 观众：输入描述性名称（例如。， mcp-server) - 类型：点击下拉菜单，将其从“刷新令牌”更改为 访问令牌 - 一生：选择令牌持续时间（例如。， 1 Month)
- 点击 保存
- 复制生成的访问令牌
步骤6：更新令牌 mcp.json
在 .vscode/mcp.json 文件，替换 YourJWTTokenHere 使用您从控制面板复制的访问令牌。
代币在后面 Bearer （带空格） Authorization 头球
"Authorization": "Bearer
"确保两者之间有一个空格 Bearer 以及你的代币。
🔒 提醒：您的mcp.json现在包含一个实时凭据。确保你完成了 步骤4 并添加.vscode/mcp.json到你的.gitignore。切勿共享此文件或将其提交到版本控制。将此令牌视为密码。
步骤7：（可选）使用自定义ScriptForge应用程序
如果您已将自己的自定义MCP服务器部署到ScriptForge，则可以更改URL中的应用程序ID。
在URL中： https://fr1dev1.connexcs.net/api/cp/scriptforge/8362/run
替换 8362 使用您的ScriptForge应用程序ID。您可以在以下位置找到您的应用程序ID：
- ConnexCS控制面板→ 集成开发环境 → 应用
自定义应用ID示例 9999:
"url": "https://fr1dev1.connexcs.net/api/cp/scriptforge/9999/run"步骤8：启动MCP服务器
保存后 mcp.json，您需要在VS Code中启动MCP服务器：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板 - 类型 “MCP:列出服务器” 并选择它
- 找到 connexcs调用调试 在列表中
- 点击 开始 （或 重启 如果它已经在运行）
服务器状态应更改以指示它正在运行。
小贴士：如果您在中更新了令牌或URL mcp.json，重复这些步骤并选择 重启 以应用更改。步骤9：验证安装
通过询问GitHub Copilot来测试MCP服务器是否正常工作：
"Are there any calls in my ConnexCS switch today?"或
"Search for customer named Adam in ConnexCS"如果配置正确，Copilot将能够查询您的ConnexCS交换机并返回真实数据。
可用的MCP工具
安装后，您可以要求GitHub Copilot：
- 调查电话 -具有SIP跟踪、5级日志和RTCP质量的完整呼叫分析
- get_sip_trace -详细的SIP消息跟踪
- get_call_quality -RTCP质量指标（MOS、抖动、丢包）
- search_cdr -搜索通话详细记录
- get_call_analytics -通话分析和统计
- 搜索_客户 -按ID、姓名、SIP用户或IP搜索客户
- list_rtp_servers -列出RTP媒体服务器
- list_rtp_server_groups -列出RTP服务器组
- get_ai_agent_logs -AI Agent交互日志
- get_transcription -呼叫转录数据
- 还有更多。..
示例问题
"Investigate call with ID abc123"
"Show me call statistics for the last 7 days"
"Find customer with ID 12345"
"Search CDR for calls from CLI 1234567890"
"List all RTP servers in Europe"
"Get call quality metrics for call xyz789"故障排除
MCP服务器未出现
- 验证
.vscode/mcp.json存在并且是有效的JSON - 检查文件是否位于工作区根目录中
.vscode文件夹 - 完全重新启动VS代码（关闭并重新打开，不要只是重新加载）
“未经授权”或401错误
这意味着您的JWT访问令牌已过期或无效。重复 步骤5 要生成新的访问令牌，则 步骤6 在中更新它 mcp.json，以及 步骤8 重新启动服务器。
错误的服务器或“无法连接”
检查：
- URL在
mcp.json匹配您的ConnexCS服务器 - ScriptForge应用ID（例如。，
8362)是正确的 - MCP服务器已部署到ScriptForge
工具未显示或已禁用
如果某些工具未显示或显示为禁用：
- 打开 副驾驶聊天 面板
- 点击 工具 聊天输入底部的图标（扳手/锤子）
- 搜索工具名称并确保其已打开
- 如果仍然缺少工具，请使用以下命令重新启动MCP服务器 步骤8
许可证
专有-ConnexCS有限公司。