# 设置其他AI App（Cursor、Claude Code、VS Code等） > 用OAuth或token，把Claude Code、Cursor、VS Code、Codex、Gemini CLI、Cline等MCP客户端连接到BCL。 > > Source: https://docs.bcl.my/zh/ai-agent-setup/ Claude和ChatGPT以外的编程助手和AI App，也用同一个服务器地址`https://bcl.my/mcp`连接到BCL。有些通过浏览器让你登录（OAuth），有些需要BCL的**Personal Access Token**。本页提供**Connect AI Agent**页面上每个App的设置方法。 claude.ai、Claude Desktop和ChatGPT，请看[把Claude或ChatGPT连接到BCL](/zh/connect-ai-agent/)。 ## 选择你的App和登录方式 BCL在**Platform Setup** → **Connect AI Agent**的**Quick start**标签页列出15个App。每个App支持以下方式： | App | OAuth（浏览器登录） | Personal Access Token | 在哪里设置 | |---|---|---|---| | Claude Desktop / claude.ai | 是 | 否 | **Settings** → **Connectors** → **Add custom connector** | | ChatGPT | 是 | 否 | **Settings** → **Apps & Connectors** → **Advanced** → **Developer mode** → **Create** | | Claude Code | 是（推荐） | 是 | `claude mcp add`，或项目根目录的`.mcp.json` | | Cursor | 是（推荐） | 是 | `~/.cursor/mcp.json`（全局）或`.cursor/mcp.json`（项目） | | VS Code (GitHub Copilot) | 是 | 是 | `code --add-mcp`，或`.vscode/mcp.json` | | Codex | 是 | 否 | `~/.codex/config.toml` | | Gemini CLI | 是（推荐） | 是 | `gemini mcp add`，或`~/.gemini/settings.json` | | Windsurf | 是（推荐） | 是 | `~/.codeium/windsurf/mcp_config.json` | | Warp | 是 | 是 | **Settings** → **Agents** → **MCP servers** → **+ Add** | | Zed | 是（推荐） | 是 | **Agent Panel** → **Add Remote Server**，或`~/.config/zed/settings.json` | | OpenCode | 是 | 否 | `opencode.json`或`~/.config/opencode/opencode.json` | | Cline | 否 | 是 | **MCP Servers** → **Configure MCP Servers** | | JetBrains AI | 否 | 是 | **Settings** → **Tools** → **AI Assistant** → **Model Context Protocol (MCP)** → **Add** | | Hermes Agent | 否 | 是 | `~/.hermes/config.yaml` | | OpenClaw / Custom | 否 | 是 | `openclaw mcp set`，或任何MCP SDK | *(Screenshot: Quick start标签页上的Pick your agent步骤，列出全部15个App，已标示Cursor)* 使用OAuth时，App会在你的浏览器打开BCL。登录，检查权限，然后点击**Authorize**，详情请看[Approve the connection](/zh/connect-ai-agent/#批准连接)。访问权限和撤销方式都和Claude一样。 ## 为MCP创建token 如果你的App用OAuth，就跳过这个部分。要创建token，你必须是管理员： 1. 前往**Platform Setup** → **Integrations**，打开**API Token**标签页。 2. 点击**Create New API Token**。 *(Screenshot: Integrations的API Token标签页，已标示Create New API Token按钮)* 3. 输入一个说明用在哪里的**Token Name**，例如“Cursor on office laptop”。 4. 在**Permissions**下勾选**MCP Read**。只有在App需要做更改时，才同时勾选**MCP Write**。除非同一个token也要调用BCL API，否则取消勾选**API Read**和**API Write**。 *(Screenshot: Create New API Token面板，已标示MCP Read和MCP Write权限)* 5. 选择**Expiration**，例如**90 days**。 6. 点击**Create Token**，然后用复制图标从列表复制token。 更多关于token的资料，包括怎样查看或删除token，请看[创建API token](/zh/api-tokens/)。 > **Caution** > 任何拿到token的人都可以使用它，权限就是你勾选的那些。别把它放在共享文件和截图里。如果含有token的配置文件被放进Git，就在BCL删除那个token，再创建一个新的。 在下面每段代码里，把``换成你的token。保留`Bearer`这个词和它后面的空格。 ## Claude Code Claude Code通过你的浏览器登录。用一个命令添加服务器： ```shell claude mcp add --transport http bcl https://bcl.my/mcp ``` 然后在Claude Code运行`/mcp`，选择**bcl**，用你的BCL账号登录。 如果是CI或没有浏览器的机器，就改用token： ```shell claude mcp add --transport http bcl https://bcl.my/mcp \ --header "Authorization: Bearer " ``` 要和团队共享这个服务器，就在项目根目录commit一个`.mcp.json`文件。不要把token放进去。 *(Screenshot: Quick start标签页上的Claude Code设置，有OAuth和Personal Access Token的命令)* ## Cursor 把这段保存在`~/.cursor/mcp.json`（所有项目）或`.cursor/mcp.json`（单一项目），然后在**Settings** → **MCP**开启服务器。Cursor会在服务器旁显示**Needs login**：点击它，用你的BCL账号登录。 ```json { "mcpServers": { "bcl": { "url": "https://bcl.my/mcp" } } } ``` 改用token的话： ```json { "mcpServers": { "bcl": { "url": "https://bcl.my/mcp", "headers": { "Authorization": "Bearer " } } } } ``` *(Screenshot: Quick start标签页上的Cursor设置，有OAuth和Personal Access Token的配置)* ## VS Code VS Code在GitHub Copilot的**Agent Mode**使用MCP。在Copilot Chat开启Agent Mode，然后运行： ```shell code --add-mcp '{"name":"bcl","type":"http","url":"https://bcl.my/mcp"}' ``` VS Code会请你信任这个服务器，然后打开浏览器让你登录。使用token的话，把这段放进`.vscode/mcp.json`。注意VS Code用的是`servers`，不是`mcpServers`，而且需要`type`： ```json { "servers": { "bcl": { "type": "http", "url": "https://bcl.my/mcp", "headers": { "Authorization": "Bearer " } } } } ``` *(Screenshot: Quick start标签页上的VS Code设置，有code --add-mcp命令和.vscode/mcp.json配置)* ## Windsurf Windsurf用`serverUrl`，不是`url`。把这段保存在`~/.codeium/windsurf/mcp_config.json`，然后在Cascade MCP面板点击**Refresh**。没有header的话，Windsurf会打开浏览器让你登录： ```json { "mcpServers": { "bcl": { "serverUrl": "https://bcl.my/mcp" } } } ``` 使用token的话，在`serverUrl`旁加上`"headers": { "Authorization": "Bearer " }`。 ## Zed Zed原生支持连接远程服务器。最简单的方法是**Agent Panel** → **Settings** → **Add Remote Server**。或者把这段加进`~/.config/zed/settings.json`；没有header的话，Zed会请你在浏览器登录： ```json { "context_servers": { "bcl": { "url": "https://bcl.my/mcp" } } } ``` 使用token的话，在`url`旁加上`"headers": { "Authorization": "Bearer " }`。 ## Cline Cline需要token。最简单的方法是把这段贴进Cline的聊天里，并把占位符换成你的token： ```text Add this MCP server to your Cline MCP settings: name "bcl", type "streamableHttp", url https://bcl.my/mcp, with an Authorization header of "Bearer ". Then confirm the BCL tools are available. ``` 或者在**MCP Servers** → **Configure MCP Servers**手动添加。Type必须完全是`streamableHttp`： ```json { "mcpServers": { "bcl": { "type": "streamableHttp", "url": "https://bcl.my/mcp", "headers": { "Authorization": "Bearer " }, "disabled": false, "autoApprove": [] } } } ``` ## JetBrains AI IntelliJ IDEA、PhpStorm、WebStorm、PyCharm和其他JetBrains IDE都需要token。前往**Settings** → **Tools** → **AI Assistant** → **Model Context Protocol (MCP)** → **Add**，选择**As JSON**，然后粘贴： ```json { "mcpServers": { "bcl": { "url": "https://bcl.my/mcp", "headers": { "Authorization": "Bearer " } } } } ``` 如果IDE没有读取header，就改用`mcp-remote`桥接。它需要Node.js： ```json { "mcpServers": { "bcl": { "command": "npx", "args": [ "-y", "mcp-remote", "https://bcl.my/mcp", "--header", "Authorization: Bearer " ] } } } ``` *(Screenshot: Quick start标签页上的JetBrains AI设置，有原生配置和mcp-remote桥接)* ## Codex、Gemini CLI、OpenCode & Warp 这些App通过浏览器登录。 **Codex**（CLI、桌面App和IDE扩展共用一个文件）：把这段加进`~/.codex/config.toml`，然后运行`codex mcp login bcl`。 ```toml [mcp_servers.bcl] url = "https://bcl.my/mcp" oauth_resource = "https://bcl.my/mcp" ``` **Gemini CLI**：运行下面的命令。第一次使用时，它会打开浏览器让你登录。 ```shell gemini mcp add --transport http --scope user bcl https://bcl.my/mcp ``` 使用token的话：`gemini mcp add --transport http --scope user --header "Authorization: Bearer " bcl https://bcl.my/mcp`。在`~/.gemini/settings.json`里，键是`httpUrl`，不是`url`。 **OpenCode**：把这段加进`opencode.json`，然后运行`opencode mcp auth bcl`。 ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "bcl": { "type": "remote", "url": "https://bcl.my/mcp" } } } ``` **Warp**：在**Settings** → **Agents** → **MCP servers** → **+ Add**，选择**Streamable HTTP or SSE Server (URL)**，然后粘贴： ```json { "mcpServers": { "bcl": { "url": "https://bcl.my/mcp" } } } ``` ## Hermes Agent、OpenClaw和你自己的AI助手 这些使用token。 **Hermes Agent**：把这段加进`~/.hermes/config.yaml`，然后重启AI助手。 ```yaml mcp_servers: bcl: url: "https://bcl.my/mcp" headers: Authorization: "Bearer " ``` **OpenClaw**：它默认使用SSE，所以要设置transport： ```shell openclaw mcp set bcl '{"url":"https://bcl.my/mcp","headers":{"Authorization":"Bearer "},"transport":"streamable-http"}' ``` **你自己的AI助手**：把你MCP SDK的Streamable HTTP客户端指向`https://bcl.my/mcp`，并带上`Authorization: Bearer` header。要测试连接，就列出工具： ```shell curl -X POST https://bcl.my/mcp \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' ``` 拥有**MCP Read**和**MCP Write**的token会拿到62个工具。BCL以普通JSON通过`POST`回复每个请求，不会开启event stream。工具列表、限制和错误，请看[MCP工具参考](/zh/mcp-tools/)。 ## 确认可以使用 保存设置后，重启App，然后问它： ```text What tools do you have? Summarise what I can ask you to do. ``` 它应该会列出BCL工具。之后每个请求都会显示在**Tools** → **MCP Audit Log**，**Auth**列会显示**pat**或**oauth**。请看[查看你的AI助手做了什么](/zh/mcp-audit-log/)。 ## 小贴士 几个好习惯，让token和连接更容易管理： - **每个App和每台电脑一个token**。如果手提电脑不见了，你只需删除那个token，其他App照常运作。 - **尽量使用OAuth**。没有token需要复制，而且你可以在**Connected Apps**撤销App。 - **为token设置有效期**。设为**Never**的token会一直有效，直到有人删除它。 ## 常见问题 ### OAuth和Personal Access Token，哪个比较好？ 如果你的App支持OAuth，就用OAuth：你在浏览器用BCL账号登录，没有token需要复制，也不怕外泄。JetBrains AI、Cline、Hermes Agent、OpenClaw、脚本和没有浏览器的机器，就用token。 ### 我的token可以用于BCL API，但AI App说不允许。为什么？ MCP需要自己的权限。Token必须有MCP Read（要做更改还需要MCP Write）。只有API Read和API Write会被拒绝。 ### AI App连接了，但没有显示BCL工具。我要检查什么？ 检查地址是否完全是https://bcl.my/mcp、你是否已把换成你的token，以及token是否已过期。然后重启App，问它“What tools do you have?”。