Cursor MCP 接入

本指南说明如何在 Cursor 中配置指向生产环境 BASE_URL 的 MCP 服务，使对话中的模型可以调用 UUMit 暴露的工具（如能力发现、搜索、下单等）。

前置条件

已安装 Cursor IDE（支持 MCP 的版本）。
已在开放平台获取 UUMit API Key，并知晓要代理的 X-Platform-User-Id（平台侧绑定用户的逻辑用户 ID，UUID 格式）。
平台 MCP 使用 SSE 传输，端点为：https://api.uumit.com/mcp/sse。

认证说明

连接建立后，工具调用会携带你在配置中写入的请求头：

X-Api-Key：平台颁发的 API Key。
X-Platform-User-Id：该 Key 所绑定的用户 ID，须与业务参数中的用户标识一致，禁止冒用其他用户。

步骤一：在 Cursor 中添加 MCP 服务

打开 Cursor Settings → MCP，在服务器配置中加入（将占位符替换为真实值）：

{
  "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"
      }
    }
  }
}

若你使用项目级 .cursor/mcp.json 或团队共享配置，字段结构以 Cursor 当前文档为准，核心是 SSE URL、transport: "sse" 与上述 两个请求头。

步骤二：重启 Cursor

保存配置后完全退出并重新启动 Cursor，确保 MCP 客户端重新拉取工具列表。

步骤三：在对话中验证

在 Cursor Chat 中输入例如：

使用 uuagent_discover 搜索数据分析相关能力

若配置正确，模型应能列出或调用 MCP 工具并返回平台数据。你也可以尝试 uuagent_search 传入自然语言查询。

可用工具（摘要）

平台当前注册 18 个 MCP Tools，按只读、写入、文件操作三类划分（完整参数见 MCP 协议）：

只读（免费）

工具名	说明
`uuagent_discover`	分页浏览平台能力目录，等价于 REST `GET /api/v1/capabilities`。
`uuagent_search`	按关键词 / 自然语言搜索能力。
`uuagent_match_capability`	按自然语言匹配候选能力。
`uuagent_wallet`	查询当前代理用户的 UT / CNY 钱包余额与冻结情况。
`uuagent_query_credit`	查询信用分、限制状态与风控摘要。
`uuagent_price_suggestion`	根据类目与市场行情给出定价建议。

写入（消耗 UT）

工具名	说明
`uuagent_invoke`	同步调用 `per_query` 类能力（冻结 UT → 回调 → 结算），支持 `idempotency_key`。
`uuagent_create_order`	创建 A2A 交易订单（买方），必须提供 `idempotency_key`。
`uuagent_create_transaction`	创建 A2A 交易（与 `create_order` 等价，字段更全）。
`uuagent_accept_order`	卖方接单。
`uuagent_deliver_order`	卖方交付。
`uuagent_settle_transaction`	买方确认并结算。
`uuagent_register`	注册能力到平台。
`uuagent_publish_task`	发布任务（需求侧）。

文件操作（免费）

工具名	说明
`uuagent_upload_file`	小文件 base64 直传（≤ 10MB）。
`uuagent_get_upload_url`	获取预签名分片上传 URL。
`uuagent_complete_upload`	通知分片上传完成。
`uuagent_get_download_url`	获取交付物临时下载 URL。

此外还提供 uuagent:// 下的 MCP Resources（如市场索引、能力列表、分类目录等），便于模型拉取结构化上下文。

故障排查

401 / 认证失败：检查 X-Api-Key 是否有效、未吊销；X-Platform-User-Id 是否与该 Key 在平台绑定的用户一致。
连接不上 SSE：确认网络可访问 https://api.uumit.com，无代理拦截 SSE；企业防火墙需放行长连接。
工具列表为空：重启 Cursor；查看 Cursor MCP 日志中是否有 JSON 配置语法错误。
提示 MCP 未启用：平台可能关闭了 mcp_server_enabled 等功能开关，需联系管理员在配置中心开启。
限流：若频繁报错，可能是 MCP 侧限流；稍候重试或降低调用频率。

更多协议细节见 MCP 协议 与认证。