连接 Claude / ChatGPT：自定义 MCP 与 OAuth

你将得到什么

• 在 Claude（Web / Desktop）或 ChatGPT（Developer Mode）里挂好名为 Databox 的远程 MCP
• 一次成功的 OAuth：浏览器授权后，助手能代表你的 Databox 工作区调用工具
• （可选）在 Cursor 用 mcp-remote 写入同一端点

开始前准备

1. 一个可用的 Databox 账号（试用或付费；官方写明 MCP 在试用与付费计划可用，免费档可能需升级——以 databox.com/mcp FAQ 为准）。
2. Claude：官方 Setup 要求 付费订阅 才能用 MCP connectors；Team / Enterprise 需管理员先在工作区设置里加入该 connector。
3. ChatGPT：官方注明 Developer Mode 下的 MCP apps 仍为 beta，需符合条件的计划；Business / Enterprise 非管理员需管理员先在 Apps 中加入 Databox。
4. 建议先打开通读：https://developers.databox.com/docs/mcp/setup

核心事实（先记住）

步骤 1：确认端点可达（可选核对）

在终端对端点发一次 GET（MCP 服务通常只接受 POST）：

curl -sI "https://mcp.databox.com/mcp"

对照结果：响应头里常见 Allow: POST, DELETE（或类似），状态码可能是 405 Method Not Allowed——这反而说明服务在、只是拒绝 GET。若长时间超时或 DNS 失败，检查网络后再继续。

步骤 2：在 Claude 添加自定义 Connector

按官方 Setup「Claude (Web & Desktop)」：

1. 打开 https://claude.ai 或 Claude Desktop。
2. 进入 Settings → Connectors → Add custom connector。
3. 填写：
   • Name： Databox
   • URL： https://mcp.databox.com/mcp
   • Authentication： OAuth 2.0（按屏幕引导）
4. 弹出 Databox 登录 / 授权页时，用你的 Databox 账号确认。

对照结果：Connectors 列表出现 Databox 且状态为已连接；新开对话后，助手在需要时可以调用 Databox 工具（下一课再验证）。

Team / Enterprise：若看不到 Add custom connector，先请工作区管理员按官方说明添加该 connector。

步骤 3：在 ChatGPT 用 Developer Mode 添加 App

按官方 Setup「ChatGPT」与 Help Center 步骤（UI 文案可能随 beta 微调）：

1. ChatGPT → 头像 → Settings。
2. 进入 Apps → Advanced settings，开启 Developer Mode (Beta)（具体路径以 OpenAI 当前文档为准）。
3. Create app，填写：
   • Name： Databox
   • MCP server URL： https://mcp.databox.com/mcp
   • Authorization： OAuth 2.0
4. 按提示完成 Databox OAuth。

对照结果：Apps / Connectors 中出现 Databox；新对话里可启用该连接。Business / Enterprise 非管理员：需管理员先在账户 Apps 中加入 Databox，之后成员可直接连接、不必人人开 Developer Mode（官方 Setup 说明）。

步骤 4：（可选）Cursor 写入 mcp.json

官方 Setup「Cursor」要求 Cursor 付费订阅。可点官方快捷按钮，或手动：

1. Cursor → Settings… → Cursor Settings
2. Tools & Integrations → New MCP Server
3. 在 mcp.json 加入：

{
  "mcpServers": {
    "Databox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.databox.com/mcp",
        "--allow-http"
      ]
    }
  }
}

对照结果：MCP 列表出现 Databox；首次使用会走 OAuth / 浏览器授权。本机需能运行 npx。

步骤 5：连接健康检查（不查业务数）

在已连接 Databox 的 Claude 或 ChatGPT 对话中发送：

请用 Databox MCP 的 list_accounts 列出我当前凭证可见的账户（只读，不要修改任何数据）。

对照结果：助手应调用 MCP 工具（名称可能显示为 list_accounts），返回你有权访问的账户列表或明确的权限/空列表说明。若提示未连接或 401，回到步骤 2/3 重新授权。

常见问题（本课）

本课检查清单

• 端点记牢：https://mcp.databox.com/mcp
• Claude 或 ChatGPT 至少一条路径 OAuth 成功
• list_accounts 试问有工具调用痕迹
• （可选）Cursor mcp-remote 配置已保存

下一课：用自然语言触发 list_metrics、load_metric_data、ask_genie，并对照官方用例提问。