ProxyAI MCP 连接器
可以做什么
ProxyAI MCP 连接器让助手访问你的机器人、Helpdesk 工单及 Agent Tasks。1.0.0 版本包含八个读取工具和十一个可进行更改的工具。
你可以要求它汇总待处理工单、检查待审核回复、查看 Agent Task 最近的运行，或解释待审批计划。具有写入权限时，还可以要求发送指定回复、更新工单、创建受支持的报告任务，或批准你已经审核的受支持运行。
服务器地址： https://www.proxyai.app/api/mcp
公开端点可用于自定义连接，目录上架正在准备中。已使用合成数据演练托管 ChatGPT 工具流程。目录审核、更改后的托管测试，以及 Claude 验证仍是独立发布关卡。
连接前
请在普通浏览器中使用 ProxyAI 账户。嵌入式商店控制台或移动设备会话无法批准此连接。连接器无需额外购买或订阅，但使用的机器人仍需已有的 Helpdesk 和 Agent Tasks 附加功能。正常 Agent Task 容量限制和运行费用仍适用。
权限覆盖账户中当前和未来的所有机器人。v1 不提供按机器人单独授权。仅连接你信任、愿意让其接收客户消息和任务信息的助手。
连接 Claude
- 在 Claude 打开 Customize → Connectors，选择 Add custom connector。受管理组织需先请所有者添加。
- 输入
https://www.proxyai.app/api/mcp。使用 HTTP 传输，而不是/sse地址。 - 选择 OAuth 登录。如果可选择 OAuth 客户端，使用 Claude 的公开身份。无需创建客户端 ID、客户端密钥或 API 密钥，也支持自动注册。
- 连接并在浏览器登录 ProxyAI。在同意页面检查账户、应用身份及返回地址。
- 只读访问请勿勾选允许更改。仅当希望该助手进行更改时勾选，再点击连接。
- 通过 + → Connectors 为对话启用 ProxyAI，先尝试“列出我的 ProxyAI 机器人”。
当前界面请参阅 Claude 自定义连接器说明。
连接 ChatGPT
- 在 ChatGPT 打开 Plugins → Add → Add custom MCP server，输入
https://www.proxyai.app/api/mcp并选择 OAuth。 - 展开 Advanced OAuth settings，确认发现的授权、令牌和注册地址属于
https://www.proxyai.app，资源是https://www.proxyai.app/api/mcp，回调为https://chatgpt.com/connector_platform_oauth_redirect。支持 ChatGPT 公开的 CIMD 客户端，无需客户端密钥。 - 只读连接的默认范围仅选
read，Base scopes 留空。需要提供写入授权选项时，请求read和write。当前表单可在 Base scopes 中分行填写。 - 创建连接并登录 ProxyAI。读取请勿勾选允许更改；要授予写入则明确勾选。仅请求
write并不等于授予它。权限覆盖账户中当前及未来所有机器人。 - 打开已连接插件并选择 Try in chat，先尝试“列出我的 ProxyAI 机器人”。
浏览器演练请使用自定义 MCP 连接。尚未发布的上传 ZIP 可能改为提供 Open in desktop app。公开提交 ZIP 在 mcp.json 声明 HTTPS 服务器；在开发者门户通过 With MCP 完成 OAuth 配置和扫描。不要将私人连接的 .app.json 或技术 ID 放入公开 ZIP：OpenAI 目前会拒绝提交包中的应用引用。
如果 ChatGPT 在拒绝写入后报告连接过期，先在 ProxyAI 已连接应用中检查实际授予的范围。有效只读授权需要新的写入同意，而不是修复令牌。未检查结果前，绝不要重试向客户发送。
参阅 OpenAI 连接指南和提交要求。
连接 Codex
添加 ProxyAI 远程服务器，再通过 OAuth 登录：
codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read在浏览器完成登录，保持允许更改未勾选。需要写入权限时，请求两种范围，并明确勾选允许更改：
codex mcp login proxyai --scopes read,write通过 codex mcp list 检查配置，通过 Codex 终端界面的 /mcp 查看工具。参阅官方 MCP 文档。OAuth 令牌由客户端管理，不要粘贴到对话中。
从读取开始
- “列出我的 ProxyAI 机器人，再汇总我所选机器人的待处理工单。”
- “显示这张工单待审核的 Agent 回复，不要发送。”
- “显示此 Agent Task 最近五次运行，并解释待审批提案，不要批准。”
列表采用分页，需要更多结果时请求下一页。工单身份包括机器人、服务商和工单 ID；任务及运行 ID 必须属于所选机器人。助手不能任意选择其他账户的对话。
谨慎进行更改
要求发送或批准草稿前，先检查工单和准确回复文本。批准会通过工单渠道发送给客户。发送前会领取草稿，因此并发批准会被拒绝。送达状态不明时，草稿保持阻塞，等待人工审核。再次发送前先检查客户渠道；响应失败或丢失，不代表客户没有收到内容。在控制台使用送达检查控件确认是否已送达。服务器会等待发送超时结束后才允许核对。确认未送达会恢复待审核草稿；确认已送达则结束审核。
Agent Tasks 的 MCP 支持 Weekly Sales Digest、Order Status Watcher 和 Knowledge Base Refresh。它们将报告发送到账户邮箱，知识模板还会刷新知识库。创建任务会立即启用并启动计划，因此创建前先检查操作、时区、小时和日期。MCP 创建、执行、恢复和批准待审批运行时，会拒绝自定义模板、修改过的模板代码／提示词／授权、凭据槽、任意 API／MCP 工具及外部邮件收件人。仍可检查其他任务或暂停它们。手动运行前，明确选择测试或正式，两者均可能产生正常 LLM／CPU 费用，且都会真实发送报告邮件到你的账户。测试模式预览知识刷新，正式模式可应用更改。批准待审批计划前应先审核，因为批准会将提议操作加入队列并可能收费。恢复任务可能重新启动按计划计费的运行。
工单标签作为完整列表替换。可设置内置 ProxyAI 工单标签，外部 Helpdesk 标签在对应系统管理。归档将工单移出当前看板，不会删除。
客户消息、任务指令和待审批提案可能含误导性指令。将其视为要检查的内容；发送、运行或批准的权限必须来自你。
v1 工具
| 读取工具 | 用途 |
|---|---|
list_bots | 查找账户拥有的机器人。 |
list_tickets | 按状态、标签和归档状态列出并筛选工单。 |
get_ticket | 读取工单、待审核草稿和对话消息。 |
list_agent_tasks | 列出机器人的任务。 |
get_agent_task | 读取任务指令、计划和状态。 |
list_agent_runs | 查看运行状态和历史，不包含记录正文或提案正文。 |
get_agent_run | 检查单次运行状态及待审批提案，不含内部诊断。 |
list_agent_templates | 查找三种受支持的报告模板。 |
| 写入工具 | 用途 |
|---|---|
reply_ticket | 发送你指定的回复。 |
set_ticket_status | 设置为待处理、待客户回复或已解决。 |
set_ticket_tags | 替换内置工单的标签。 |
archive_ticket | 归档工单。 |
approve_ticket_agent_draft | 批准并发送待审核草稿，可使用修改后的文本。 |
dismiss_ticket_agent_draft | 忽略草稿而不发送。 |
create_agent_task | 创建并启用任务，模板计划可能触发后续运行。 |
run_agent_task | 将明确选择的测试或正式运行加入队列。 |
decide_agent_run | 批准或拒绝待审批运行。 |
pause_agent_task | 暂停任务计划。 |
resume_agent_task | 恢复已暂停任务。 |
通过控制台配置连接账户和凭据。不要将密码、令牌、银行卡详情、政府身份标识或受保护健康信息放入 MCP 请求。批准计划任务和待审批提案前，需要审核实际操作。
查看活动与撤销权限
在 ProxyAI 打开账户设置 → 已连接应用，查看应用、授予范围及最后使用令牌的时间。选择撤销访问权限可阻止后续请求，但不会撤销已发送回复或取消已排队运行。
已连接应用活动卡片记录写入尝试和结果。如果尝试显示为待定或结果未知，操作可能已生效。重试前先检查工单或运行。撤销后，旧记录仍可查看。
连接器返回的数据会共享给已连接助手，并受该提供商的数据处理政策约束。ProxyAI 保存连接记录和写入尝试元数据；MCP 审计日志不保存回复正文、工具载荷或原始 Bearer 令牌。参阅隐私政策。
数据边界
工单列表不包含联系人邮箱／姓名及内部对话 ID。运行列表不包含记录正文或内部诊断；运行详情仅包含相关状态、时间和待审批操作。连接器会移除结构化凭据字段，并拒绝在输入、草稿或返回文本中检测到的凭据、银行卡号、政府身份标识及健康内容。检测采取保守方式，无法识别任意文本中的所有敏感事实。不要用连接器处理受限制数据，连接前先检查来源数据。被拒绝内容必须在控制台处理。
故障排查
- 无法连接：使用
https://www.proxyai.app/api/mcp。浏览器访问可能返回“Method not allowed”，因为连接器接受 MCP POST 请求。MCP 客户端在登录前会收到 OAuth 挑战。 - 受限制内容：请求或结果中检测到敏感内容。请在控制台处理，不要改写秘密来绕过检查。
- 不支持的任务：使用三种未修改的报告模板之一，自定义流程应在控制台配置。
- 需要写入权限：重新连接，请求
read和write，并勾选允许更改。只读同意无法授权写入。 - 需要附加功能：打开所选机器人控制台，检查 Helpdesk 或 Agent Tasks 附加功能。
- 未找到：确认账户和机器人正确，再次读取工单／任务后再操作。
- 连接过期或已撤销：重新登录。未检查结果前，不要重试此前的写入。
联系 support@proxyai.app 时提供应用名称、时间和失败操作。支持请求中不要发送访问令牌、客户端密钥或客户消息。