昨天我先介紹了 Claude-Code + Zen MCP 的觀念，今天就來實際動手安裝與設定。
這個過程主要分成四個步驟：準備 Docker、clone專案、設定 API Key、啟動並整合到 Claude Code CLI。

1. 安裝 Docker

Zen MCP Server 必須透過 Docker 容器運行，所以第一步先安裝 Docker：

macOS / Windows 則可以直接安裝 Docker Desktop。

2. clone倉庫

接著拉取官方的 Zen MCP Server 程式碼：

git clone https://github.com/BeehiveInnovations/zen-mcp-server.git
cd zen-mcp-server

3. 配置 API 金鑰

Zen MCP 需要 模型 API Key 才能運行。
在 .env 檔案中填入你自己的 Gemini API Key 或 OpenAI API Key：

nano .env

內容範例可去.env.example：

GEMINI_API_KEY=your-gemini-api-key-here
OPENAI_API_KEY=your-openai-api-key-here

4. 建置與啟動

先執行建置腳本：

chmod +x docker/scripts/build.sh
./docker/scripts/build.sh

接著啟動 Zen MCP Server：

docker run --rm -i --env-file .env \
  -v $(pwd)/logs:/app/logs \
  zen-mcp-server:latest

到這裡 Zen MCP Server 就會啟動並等待請求。

5. 整合到 Claude CLI

下一步，你只要在這裡新增一個 servers.json：

nano ~/.claude/servers.json

然後貼入設定（路徑要用 WSL 格式 /mnt/c/...，記得依你自己的實際路徑修改）：

{
  "servers": {
    "zen-docker": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/mnt/c/Users/user/zen-mcp-server/.env",
        "-v",
        "/mnt/c/Users/user/zen-mcp-server/logs:/app/logs",
        "zen-mcp-server:latest"
      ]
    }
  }
}

⚠️ 提醒：以上路徑要改成你自己實際的安裝路徑。

成功畫面

今天的成果如下圖，顯示 Zen MCP Server 已成功啟動並整合到 Claude Code CLI：

明天預計

明天就要來 實際呼叫 Zen MCP API，並串接到 Claude / Gemini，看看怎麼把不同 AI 分工協作起來 🚀。