---
title: "编程 Agent 与编辑器"
description: "用登录或 API 密钥把 Claude Code、Codex、Cursor、VS Code、OpenCode 和 Windsurf 连接到 TwexAPI MCP 服务器。"
---

下面所有客户端都通过 Streamable HTTP 连接同一个服务器：`https://api.twexapi.io/mcp`。大多数客户端都支持用你的 TwexAPI 账号登录：只填服务器地址，客户端会打开浏览器让你确认授权。不支持 MCP 登录的客户端，或者你更习惯用密钥时，请使用 API 密钥。

| 客户端 | 用 TwexAPI 登录 | API 密钥 | TwexAPI 实测 |
| --- | --- | --- | --- |
| [Claude Code](#claude-code) | 支持 | 支持 | 否 |
| [Cursor](#cursor) | 支持 | 支持 | 是 |
| [Codex](#codex) | 支持 | 支持 | 否 |
| [VS Code](#vs-code) | 支持 | 支持 | 否 |
| [OpenCode](#opencode) | 支持 | 支持 | 否 |
| [Windsurf](#windsurf) | 未确认 | 支持 | 否 |

"实测"指我们用该客户端完整走过登录并成功调用了工具。其他客户端的登录方式依据各厂商文档中对 MCP 授权的支持说明；如果登录失败，请改用 API 密钥。Claude.ai、Claude Desktop 和 ChatGPT 请参阅 [MCP 服务器概览](/mcp/overview#claude-ai-and-claude-desktop) 和 [ChatGPT](/mcp/chatgpt)。

:::tip
  API 密钥请放在环境变量里，不要写进会提交到仓库的配置文件。在 [TwexAPI 控制台](https://twexapi.io/dashboard) 创建密钥。
:::

<a id="claude-code"></a>

## Claude Code

添加服务器：

```bash
claude mcp add --transport http twexapi https://api.twexapi.io/mcp
```

然后在 Claude Code 会话中运行 `/mcp`，选择 `twexapi`，再选择 **Authenticate**，在浏览器中确认授权。加上 `--scope project` 可以通过 `.mcp.json` 把服务器共享给团队，每位成员各自用自己的账号登录。

如果改用 API 密钥，把请求头写进 `.mcp.json`。Claude Code 会从环境变量中展开 `${TWEXAPI_API_KEY}`：

```json
{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="cursor"></a>

## Cursor

添加到 `~/.cursor/mcp.json`（所有项目）或 `.cursor/mcp.json`（单个项目）：

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

打开 **Settings → MCP**，服务器会显示 **Needs authentication**。点击 **Authenticate**，在浏览器中确认授权，并允许浏览器打开 Cursor。之后服务器会显示已启用 3 个工具。

如果改用 API 密钥：

```json
{
  "mcpServers": {
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="codex"></a>

## Codex

添加服务器并登录：

```bash
codex mcp add twexapi --url https://api.twexapi.io/mcp
codex mcp login twexapi
codex mcp list
```

Codex CLI、桌面应用和 IDE 扩展共用 `~/.codex/config.toml` 中的配置：

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
```

如果改用 API 密钥，指定一个保存密钥的环境变量，Codex 会以 `Authorization: Bearer` 发送：

```toml
[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
bearer_token_env_var = "TWEXAPI_API_KEY"
```

<a id="vs-code"></a>

## VS Code

在命令面板中运行 **MCP: Add Server** 并选择 **HTTP**，或者添加到 `.vscode/mcp.json`：

```json
{
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

启动服务器，然后在浏览器中确认登录授权。

如果改用 API 密钥，可以让 VS Code 提示输入一次并安全保存：

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "twexapi-key",
      "description": "TwexAPI API key",
      "password": true
    }
  ],
  "servers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "${input:twexapi-key}"
      }
    }
  }
}
```

<a id="opencode"></a>

## OpenCode

添加到 `opencode.json`：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp"
    }
  }
}
```

OpenCode 会检测到服务器需要登录并自动打开浏览器。如果没有打开，运行 `opencode mcp auth twexapi`。用 `opencode mcp list` 查看状态，连接失败时用 `opencode mcp debug twexapi` 排查。

如果改用 API 密钥，需要关闭自动登录：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "twexapi": {
      "type": "remote",
      "url": "https://api.twexapi.io/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:TWEXAPI_API_KEY}"
      }
    }
  }
}
```

<a id="windsurf"></a>

## Windsurf

我们尚未确认 Windsurf 是否支持登录，请使用 API 密钥。添加到 `~/.codeium/windsurf/mcp_config.json`（可以从 Cascade 的 MCP 菜单打开这个文件，以确认你所用版本的位置）：

```json
{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

## 其他客户端

只要客户端实现了 MCP 授权（带 PKCE 和动态客户端注册的 OAuth 2.1），只填服务器地址就能登录。否则请在 `x-api-key` 请求头中发送 API 密钥，或使用 `Authorization: Bearer YOUR_API_KEY`。如果你在开发自己的客户端，请参阅 [MCP 客户端 OAuth](/mcp/oauth)。

## 检查连接

- 服务器会列出 `explore`、`twexapi_request` 和 `twexapi_write`。没有写入权限时不会列出 `twexapi_write`。
- 让 Agent "用 TwexAPI 的 explore 找一下趋势相关的接口"。`explore` 不消耗额度，所以充值之前也能用。
- 新连接会出现在 [控制台](https://twexapi.io/dashboard) 的 **Authorized apps**（已授权应用）里。

| 问题 | 解决方法 |
| --- | --- |
| `401` 或 "Needs authentication" | 重新执行客户端的登录：Claude Code 里用 `/mcp`，Cursor 里点 **Authenticate**，或运行 `codex mcp login`、`opencode mcp auth`。 |
| 授权页提示你没有 API 密钥 | 在控制台创建密钥，然后在 10 分钟内回到授权页再点一次 **Approve**。 |
| 授权页提示你没有额度 | 充值后，在 10 分钟内回到授权页再点一次 **Approve**。 |
| 工具调用返回 "No credits left on this TwexAPI account" | 在控制台充值即可，连接本身没有问题。 |
| 没有 `twexapi_write` | 你是以只读方式连接的。在控制台撤销该应用，重新连接，并保持写入权限勾选。 |

反馈问题时，请附上客户端名称和版本、发生时间（UTC），以及能看到的响应头 `X-Request-Id`。