编程 Agent 与编辑器

用登录或 API 密钥把 Claude Code、Codex、Cursor、VS Code、OpenCode 和 Windsurf 连接到 TwexAPI MCP 服务器。

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

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

Claude Code

添加服务器：

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}：

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

Cursor

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

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

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

如果改用 API 密钥：

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

Codex

添加服务器并登录：

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

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

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

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

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

VS Code

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

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

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

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

{
  "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}"
      }
    }
  }
}

OpenCode

添加到 opencode.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 密钥，需要关闭自动登录：

{
  "$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}"
      }
    }
  }
}

Windsurf

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

{
  "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。

检查连接

• 服务器会列出 explore、twexapi_request 和 twexapi_write。没有写入权限时不会列出 twexapi_write。
• 让 Agent “用 TwexAPI 的 explore 找一下趋势相关的接口”。explore 不消耗额度，所以充值之前也能用。
• 新连接会出现在 控制台 的 Authorized apps（已授权应用）里。

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