# 客户端配置

> 在 Claude Desktop / Cursor 里配置 MCP 服务，附表格对照。
> 分组：MCP 接入
> 更新时间：2026-10-13
> 原文：https://www.chenra.com/docs/mcp-client-config

## 先拿到两样东西

- **接入地址** —— 在控制台 **MCP 服务 → MCP 列表** 里，每个 MCP 服务都给出接入地址；系统自带端点固定为 https://api.chenra.com/api/relay/mcp。

- **密钥** —— 在 **MCP 服务 → 密钥管理** 里创建，形如 sk-xxxxxxxxxxxx。

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

## Claude（网页 / 桌面 App）

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

- 打开 Claude → **设置 → 连接器（Connectors）→ 添加自定义连接器**。

- 名称随便填（如 辰予），URL 填 https://api.chenra.com/api/relay/mcp。

- 在请求头里加一条：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 请求过于频繁
触发了每分钟上限
在「密钥管理」里调高或设为不限