接入你的 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。