接入你的 agent（BYO Agent）

把你自己的 AI agent（Claude Code、Cursor、Codex CLI…）接上你的 Blave Agent 机器：用你自己的订阅，LLM 费用 0。

怎么接？在 Blave Agent 页的「接入你的 agent」生成接入配置，贴进你用的工具即完成。本页列出各家工具的配置形状与注意事项，给人读、也给被指来读配置细节的 agent 读。三个核心事实：

• MCP endpoint：https://mcp.blave.org/mcp（HTTP transport）。
• 认证：HTTP header Authorization: Bearer <你的接入码>。
• 接入码在生成当下只显示一次；机器 running 时可随时重新生成或撤销（旧码立即作废）。

各家工具怎么配置？

Claude Code

claude mcp add --scope user --transport http blave https://mcp.blave.org/mcp --header "Authorization: Bearer <你的接入码>"

在终端执行。--scope user 让接入全局生效（默认 local 只在当下项目目录）。重新生成接入码后先 claude mcp remove blave 再重加（同名不会被覆盖），并重启 Claude Code。

Codex CLI

[mcp_servers.blave]
url = "https://mcp.blave.org/mcp"
http_headers = { "Authorization" = "Bearer <你的接入码>" }

贴进 ~/.codex/config.toml。用 table header 形式（如上），单行 dotted-key 接在别的 [section] 后面会被归错节。

Cursor

{
  "mcpServers": {
    "blave": {
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

贴进 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）。文件已有 mcpServers 就把 blave 这段并进去，不要整段覆盖。

Gemini CLI

gemini mcp add --scope user --transport http blave https://mcp.blave.org/mcp --header "Authorization: Bearer <你的接入码>"

在终端执行。--scope user 必带：默认 scope 是 project，在家目录执行会直接报错退出。重新生成接入码后直接重跑即可覆盖。

Antigravity

{
  "mcpServers": {
    "blave": {
      "serverUrl": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

在 agent 面板 … → MCP Servers → Manage MCP Servers → View raw config 打开配置文件（实际路径依版本而异）。已有 mcpServers 就把 blave 这段并进去。

VS Code Copilot

{
  "servers": {
    "blave": {
      "type": "http",
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

贴进 .vscode/mcp.json（工作区）或执行 MCP: Open User Configuration 打开用户级配置。注意顶层键是 servers，不是 mcpServers。

Cline

{
  "mcpServers": {
    "blave": {
      "type": "streamableHttp",
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

在 Cline 面板的 MCP Servers 设置打开 JSON 贴入。type 必须是 camelCase 的 streamableHttp——写 http 或 streamablehttp 都不行。

opencode

{
  "mcp": {
    "blave": {
      "type": "remote",
      "url": "https://mcp.blave.org/mcp",
      "oauth": false,
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

贴进 opencode.json。"oauth": false 建议带上：明确停用自动 OAuth 检测，走接入码 header 认证。

Warp

{
  "blave": {
    "url": "https://mcp.blave.org/mcp",
    "headers": { "Authorization": "Bearer <你的接入码>" }
  }
}

在 Settings → AI → MCP Servers（或 Warp Drive → MCP Servers）按 Add 贴入。顶层直接是 server 名字，不包 mcpServers。

Windsurf

{
  "mcpServers": {
    "blave": {
      "serverUrl": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

贴进 ~/.codeium/windsurf/mcp_config.json。注意 url 字段名是 serverUrl。（产品改名中：文档现以 Devin Desktop 称之，本配置适用 legacy Cascade agent。）

Trae

{
  "mcpServers": {
    "blave": {
      "url": "https://mcp.blave.org/mcp",
      "headers": { "Authorization": "Bearer <你的接入码>" }
    }
  }
}

在 MCP 设置选手动新增贴入 JSON，或写进项目根目录 .trae/mcp.json。

接不上或不能动？

• 动作被权限挡下：把 mcp__blave 加进 permissions.allow（Claude Code auto mode 建议同时允许 Bash(ssh:*)），或改用默认模式。
• 换了接入码没生效：重新生成接入码后要重启 agent session（重启工具或重开对话），旧连接不会自动换码。
• Claude Code 改了配置却没变：local scope 的同名配置会优先于 user。用 claude mcp get blave 看目前生效的是哪个 scope，把不要的那份移除。
• 同名 server 已存在：Claude Code 会报错且不覆盖——先 claude mcp remove blave；Gemini CLI 直接重跑即可覆盖。

接上之后，agent 该做什么？

1. 先调用 get_ssh_access 获取短效 SSH 凭证（15 分钟，过期重调用即可）。
2. SSH 进机器后，先读 workspace 根目录 /opt/blave-agent/workspace 的 AGENTS.md 并遵守：用 lib/ 跑回测与下单、不碰 control/。
3. 连接建议开 SSH multiplexing（参数见 get_ssh_access 返回的 usage），后续指令免重新 handshake。