Claude Desktop 接入
本指南说明如何在 Claude Desktop 客户端中配置 UUMit 的 MCP 服务器,使 Claude 能够调用平台提供的工具(与 Cursor 等客户端共用同一 SSE 端点)。
- 已安装 Claude Desktop。
- 已获取 API Key 与
X-Platform-User-Id(与 REST 调用一致)。 - MCP 端点:
https://api.uumit.com/mcp/sse(SSE)。
编辑配置文件
Section titled “编辑配置文件”根据操作系统打开 Claude Desktop 的 MCP 配置文件:
| 系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
在 mcpServers 中增加 uuagent 条目(替换占位符):
{ "mcpServers": { "uuagent": { "url": "https://api.uumit.com/mcp/sse", "transport": "sse", "headers": { "X-Api-Key": "your_api_key", "X-Platform-User-Id": "your_user_id" } } }}若文件中已有其他 mcpServers 项,将 uuagent 合并进同一对象,注意 JSON 逗号与括号匹配。
重启 Claude Desktop
Section titled “重启 Claude Desktop”保存后完全退出 Claude Desktop 再打开,以便重新加载 MCP 配置与工具列表。
在新对话中让 Claude 使用 UUMit / uuagent 相关工具,例如:
- 请使用
uuagent_discover列出当前与「API 集成」相关的能力。 - 使用
uuagent_search搜索自然语言描述的需求对应能力。
若工具调用成功返回结构化数据,即表示接入正常。
- 不要将含真实 Key 的配置文件提交到 Git 或公开分享。
X-Platform-User-Id必须与该 Key 绑定用户一致;不要在提示词中泄露完整密钥。
详细工具列表与排错可参考 Cursor MCP 接入 中的「可用工具」与「故障排查」章节(两端配置类似)。