客户端配置

先拿到两样东西

1. 接入地址 —— 在控制台 MCP 服务 → MCP 列表 里，每个 MCP 服务都给出接入地址；系统自带端点固定为 https://api.chenra.com/api/relay/mcp。
2. 密钥 —— 在 MCP 服务 → 密钥管理 里创建，形如 sk-xxxxxxxxxxxx。

凡是支持远程 HTTP 的客户端，都只需要「接入地址 + 请求头 Authorization: Bearer <密钥>」两样， 只是「填在哪、字段叫什么」各不相同。下面按工具逐个给出配置。

Claude（网页 / 桌面 App）

Claude 的远程服务用 自定义连接器 添加，不写配置文件：

1. 打开 Claude → 设置 → 连接器（Connectors）→ 添加自定义连接器。
2. 名称随便填（如 辰予），URL 填 https://api.chenra.com/api/relay/mcp。
3. 在请求头里加一条：Authorization: Bearer sk-你的密钥。

保存后新开对话，在工具列表里就能看到平台提供的 MCP 工具。

桌面版若想走配置文件，可装 mcp-remote 桥接：在 claude_desktop_config.json 的 mcpServers 里加一项， command 填 npx，args 填 ["-y","mcp-remote","https://api.chenra.com/api/relay/mcp","--header","Authorization: Bearer sk-你的密钥"]。

Claude Code

命令行一条命令即可（--transport http 是远程 HTTP 的必需项）：

claude mcp add --transport http chenra https://api.chenra.com/api/relay/mcp \
  --header "Authorization: Bearer sk-你的密钥"

等价地，也可以在主目录 .claude.json 或项目根 .mcp.json 的 mcpServers 里写：

{
  "mcpServers": {
    "chenra": {
      "type": "http",
      "url": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

远程条目必须带 "type": "http"，否则会被当成本地（stdio）服务而跳过。

Cursor

编辑 ~/.cursor/mcp.json（全局）或项目里的 .cursor/mcp.json —— Cursor 的远程条目只要 url，不需要 type：

{
  "mcpServers": {
    "chenra": {
      "url": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

也可以在 Settings → MCP → Add new MCP server 里按界面填写。

VS Code（含 GitHub Copilot）

编辑工作区 .vscode/mcp.json（或命令面板 MCP: Open User Configuration 打开用户级配置）。 注意 VS Code 的顶层键是 servers，远程条目要带 "type": "http"：

{
  "servers": {
    "chenra": {
      "type": "http",
      "url": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

也可以用命令面板 MCP: Add Server 一步步加。不想把密钥写进文件，可用 inputs 声明一个 password 输入项，再用 ${input:...} 引用。

Cline（VS Code 扩展）

打开 Cline 面板 → MCP Servers → Configure MCP Servers，粘贴：

{
  "mcpServers": {
    "chenra": {
      "type": "streamableHttp",
      "url": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

Windsurf / Devin Desktop

编辑 mcp_config.json，mcpServers 下远程条目的地址字段用 serverUrl：

{
  "mcpServers": {
    "chenra": {
      "serverUrl": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

Cherry Studio

设置 → MCP 服务器 → 添加服务器：类型选 Streamable HTTP，URL 填 https://api.chenra.com/api/relay/mcp， 请求头加一条 Authorization: Bearer sk-你的密钥。

WorkBuddy

编辑 ~/.workbuddy/mcp.json（或在 插件 → MCP 服务器 → 配置 MCP 的编辑框里粘贴），mcpServers 下加一项：

{
  "mcpServers": {
    "chenra": {
      "type": "http",
      "url": "https://api.chenra.com/api/relay/mcp",
      "headers": { "Authorization": "Bearer sk-你的密钥" }
    }
  }
}

保存后在「连接器管理 → 自定义连接器」里找到它并点「信任」，新开会话即可用。

其他支持 MCP 的客户端

任何支持「Streamable HTTP / 远程 MCP」的客户端都能接入，只需两样：接入地址，以及请求头 Authorization: Bearer sk-你的密钥。字段名对不上时，按该客户端文档把地址与请求头填到对应位置即可。

用 curl 自测

不改客户端也能验证密钥是否可用：

# 握手
curl https://api.chenra.com/api/relay/mcp \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

# 列工具
curl https://api.chenra.com/api/relay/mcp \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

常见问题

现象	原因	处理
401 缺少 API Key	没带 Authorization 头	检查客户端配置里的 headers
401 Key 无效	密钥被删或写错	回「密钥管理」重新创建
403 订阅失效	该密钥绑定的订阅已过期	去控制台续费
429 请求过于频繁	触发了每分钟上限	在「密钥管理」里调高或设为不限