在 Claude Code 中設定 Zeabur MCP：從安裝到踩坑完整紀錄

TL;DR
掌握在 Claude Code 中設定 Zeabur MCP 的完整流程——從安裝正確版本的 CLI（避開三個死路）、取得 API Token，到一行指令完成 MCP 設定。設好之後，部署、查 log、改環境變數都不用離開 Claude Code。

這篇文章適合：

用 Claude Code + Zeabur 開發，想在終端機裡直接管理雲端服務的人
安裝 Zeabur CLI 時踩坑（Homebrew 找不到、npm 版本過舊），需要正確解法的人
想了解 MCP（Model Context Protocol）實際能做什麼的 Claude Code 使用者

前言

Zeabur 提供了官方的 MCP（Model Context Protocol）Server，讓你可以直接在 Claude Code 中管理雲端專案 — 部署應用、查看服務狀態、設定環境變數、綁定網域等，不用再切換到 Zeabur Dashboard。

這篇文章記錄了從安裝 Zeabur CLI 到成功設定 MCP Server 的完整過程，包含所有踩過的坑。

你需要準備什麼

Claude Code：已安裝並可正常使用
Zeabur 帳號：需要用來產生 API Token
Node.js：用於執行 npx 指令（MCP Server 透過 npx 啟動）

第一步：安裝 Zeabur CLI

為什麼需要 CLI？

雖然 MCP Server 本身不依賴 CLI，但你在日常操作中經常會需要用 CLI 搭配使用（例如快速列出專案、部署等）。先把 CLI 裝好，後續流程會更順暢。

踩坑紀錄：三條死路

安裝 Zeabur CLI 的過程中，我踩了三個坑：

坑 1：Homebrew 找不到

brew install zeabur
# Error: No available formula with the name "zeabur". Did you mean zebra?

Zeabur CLI 沒有 Homebrew formula，此路不通。

坑 2：npm 套件版本過舊

如果你之前透過 npm 安裝過：

npm install -g @zeabur/cli

你會發現版本停在 0.2.9，而最新版已經是 0.5.6。原因是 Zeabur 團隊後來把 CLI 改用 Go 語言重寫了，npm 套件不再更新。

用舊版會遇到的問題：

每次執行指令都會自動開瀏覽器嘗試 OAuth 登入
瀏覽器顯示 ERR_CONNECTION_REFUSED
指令永遠無法完成

坑 3：沒有官方安裝腳本

curl -sSL https://raw.githubusercontent.com/zeabur/cli/main/install.sh | sh
# 404: Not Found

GitHub Repo 裡根本沒有 install script。

正確安裝方式：下載 Go Binary

直接從 GitHub Releases 下載對應平台的 binary：

macOS Apple Silicon（M1/M2/M3/M4）：

# 下載
curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_darwin_arm64" \
  -o /tmp/zeabur_new

# 賦予執行權限
chmod +x /tmp/zeabur_new

# 移到 PATH 中（如果有舊版先移除）
rm -f "$(which zeabur)" 2>/dev/null
mv /tmp/zeabur_new /usr/local/bin/zeabur

# 驗證
zeabur version
# VERSION: 0.5.6

macOS Intel：

curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_darwin_amd64" \
  -o /tmp/zeabur_new
chmod +x /tmp/zeabur_new && mv /tmp/zeabur_new /usr/local/bin/zeabur

Linux x86_64：

curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_linux_amd64" \
  -o /tmp/zeabur_new
chmod +x /tmp/zeabur_new && sudo mv /tmp/zeabur_new /usr/local/bin/zeabur

提示：可以用 GitHub API 查詢最新版本號：
curl -sL "https://api.github.com/repos/zeabur/cli/releases/latest" | grep '"tag_name"'

第二步：登入 Zeabur

安裝完成後，執行登入：

zeabur auth login

瀏覽器會自動跳出 Zeabur 登入頁面，完成 OAuth 授權後，終端機會顯示：

INFO  Logged in as  {"user": "your-username", "email": "[email protected]"}

確認登入狀態：

zeabur auth status

如果瀏覽器跳出 ERR_CONNECTION_REFUSED：大概率是 CLI 版本太舊，請確認你用的是 Go 版本（0.5.x），不是 npm 版本（0.2.x）。

第三步：取得 Zeabur API Token

MCP Server 需要一個 API Token 來驗證身份。取得方式：

前往 Zeabur Dashboard（dash.zeabur.com）
點擊右上角頭像，選擇 Settings
左側選單選擇 Developer
在 API Key 區域，點擊 Generate New Token
點「眼睛」圖示查看，再點「複製」按鈕複製 Token

Token 格式大致為：sk-xxxxxxxx

安全提醒：這個 Token 等同於你的帳號權限，請妥善保管，不要提交到 Git。

第四步：在 Claude Code 中設定 Zeabur MCP

方法一：用 `claude mcp add` 指令（推薦）

在終端機執行：

claude mcp add zeabur \
  --scope user \
  -e ZEABUR_TOKEN=sk-你的 Token \
  -- npx @zeabur/mcp-server

參數說明：

zeabur：MCP Server 的名稱（自訂）
--scope user：全域設定，所有專案都能用
-e ZEABUR_TOKEN=...：環境變數，傳入 API Token
-- npx @zeabur/mcp-server：啟動指令

方法二：手動編輯設定檔

如果你偏好直接編輯設定檔，找到 Claude Code 的 MCP 設定檔：

macOS：~/.claude.json 或 ~/.claude/settings.json

加入以下內容：

{
  "mcpServers": {
    "zeabur": {
      "command": "npx",
      "args": ["@zeabur/mcp-server"],
      "env": {
        "ZEABUR_TOKEN": "sk-你的 Token"
      }
    }
  }
}

驗證設定

claude mcp list

應該會看到 zeabur 出現在清單中。

設定完成後你可以做什麼？

成功設定 Zeabur MCP 後，你可以直接在 Claude Code 中用自然語言管理雲端服務：

操作	範例指令
建立專案	「幫我在 Zeabur 建一個新專案叫 my-app」
部署應用	「把這個專案部署到 Zeabur」
查看服務狀態	「列出我 Zeabur 上的所有服務」
設定環境變數	「幫我加一個環境變數 DATABASE_URL」
綁定網域	「幫這個服務綁定 api.example.com」
查看 Log	「看一下部署的 log 有沒有錯誤」
執行資料庫指令	「在 Postgres 裡跑這個 SQL 查詢」

這些操作都不需要離開 Claude Code，直接在對話中完成。

實際使用情境：Zeabur MCP 能幫你做什麼？

光看功能列表可能還是有點抽象，以下是幾個真實的使用情境，讓你感受 MCP 帶來的效率提升。

情境 1：快速部署 Side Project

你剛寫完一個 Next.js 小專案，想丟到線上讓朋友看看。

以前的做法：開瀏覽器 → 登入 Zeabur Dashboard → 建專案 → 連 GitHub Repo → 等部署 → 設環境變數 → 綁網域

用 MCP 之後，在 Claude Code 裡直接說：

幫我在 Zeabur 建一個專案叫 my-side-project，
把當前的 repo 部署上去，
加一個環境變數 DATABASE_URL=postgres://...，
然後綁定 demo.example.com

一段話搞定，不用切換任何視窗。

情境 2：跨專案管理多個服務

你同時維護 3 個 Zeabur 專案，需要檢查它們的狀態。

列出我所有 Zeabur 專案的服務狀態，
如果有任何服務掛掉了，幫我查一下最近的 log

AI 會自動遍歷所有專案，回報異常，附上相關 log — 省去你逐一登入 Dashboard 檢查的時間。

情境 3：Debug 線上問題

使用者回報 API 出錯，你需要看部署的 log。

幫我看一下 Brickverse 專案裡 backend 服務最近的部署 log，
找找有沒有 error 或 exception

不用開 Dashboard、不用翻 log 頁面，直接在 Claude Code 裡看結果。

情境 4：資料庫快速操作

你想在 Postgres 裡跑一段 SQL 查詢，但不想另開資料庫工具。

在 Brickverse 專案的 Postgres 裡執行：
SELECT count(*) FROM users WHERE created_at > '2026-01-01'

直接在對話中拿到結果，適合快速驗證資料。

情境 5：環境變數批次管理

專案要遷移環境，需要更新一批環境變數。

幫我把 Brickverse 專案的以下環境變數更新：
- API_URL=https://new-api.example.com
- REDIS_HOST=new-redis.example.com
- ENABLE_CACHE=true

一次講完，AI 批次幫你改好，不用一個一個在 Dashboard 裡點。

為什麼這很重要？

關鍵不只是「方便」，而是 不中斷心流（Flow）。

當你正在寫程式、Debug 或做架構決策時，每一次切換到瀏覽器、登入 Dashboard、找到對應頁面，都是一次上下文切換。MCP 讓你把雲端操作融入開發流程中，保持專注在程式碼上。

踩坑總結表

問題	原因	解法
`brew install zeabur` 失敗	沒有 Homebrew formula	從 GitHub Releases 下載 binary
`npm update -g @zeabur/cli` 無效	npm 套件停更，已改用 Go	同上
官方 install script 404	Repo 中不存在安裝腳本	同上
每次執行都跳瀏覽器	CLI 未登入 + 版本太舊	升級到 Go 版後重新 `zeabur auth login`
MCP Server 連不上	Token 未設定或過期	到 Dashboard > Settings > Developer 重新產生

常用指令速查

# Zeabur CLI
zeabur version             # 查看版本
zeabur auth login          # 登入
zeabur auth status         # 確認登入狀態
zeabur project list        # 列出所有專案
zeabur deploy              # 部署當前專案

# Claude Code MCP
claude mcp list            # 列出已設定的 MCP Server
claude mcp add zeabur ...  # 新增 Zeabur MCP
claude mcp remove zeabur   # 移除 Zeabur MCP

結語

整個設定流程其實不複雜，但 Zeabur CLI 從 Node.js 遷移到 Go 的過渡期確實容易讓人踩坑。記住兩個關鍵：

CLI 要用 Go 版本（從 GitHub Releases 下載，不是 npm 安裝）
MCP 需要 API Token（從 Dashboard > Settings > Developer 產生）

搞定這兩點，你就能在 Claude Code 裡直接管理 Zeabur 上的所有服務了。

前言

這篇文章記錄了從安裝 Zeabur CLI 到成功設定 MCP Server 的完整過程，包含所有踩過的坑。

你需要準備什麼

Claude Code：已安裝並可正常使用
Zeabur 帳號：需要用來產生 API Token
Node.js：用於執行 npx 指令（MCP Server 透過 npx 啟動）

第一步：安裝 Zeabur CLI

為什麼需要 CLI？

雖然 MCP Server 本身不依賴 CLI，但你在日常操作中經常會需要用 CLI 搭配使用（例如快速列出專案、部署等）。先把 CLI 裝好，後續流程會更順暢。

踩坑紀錄：三條死路

安裝 Zeabur CLI 的過程中，我踩了三個坑：

坑 1：Homebrew 找不到

brew install zeabur
# Error: No available formula with the name "zeabur". Did you mean zebra?

Zeabur CLI 沒有 Homebrew formula，此路不通。

坑 2：npm 套件版本過舊

如果你之前透過 npm 安裝過：

npm install -g @zeabur/cli

你會發現版本停在 0.2.9，而最新版已經是 0.5.6。原因是 Zeabur 團隊後來把 CLI 改用 Go 語言重寫了，npm 套件不再更新。

用舊版會遇到的問題：

每次執行指令都會自動開瀏覽器嘗試 OAuth 登入
瀏覽器顯示 ERR_CONNECTION_REFUSED
指令永遠無法完成

坑 3：沒有官方安裝腳本

curl -sSL https://raw.githubusercontent.com/zeabur/cli/main/install.sh | sh
# 404: Not Found

GitHub Repo 裡根本沒有 install script。

正確安裝方式：下載 Go Binary

直接從 GitHub Releases 下載對應平台的 binary：

macOS Apple Silicon（M1/M2/M3/M4）：

# 下載
curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_darwin_arm64" \
  -o /tmp/zeabur_new

# 賦予執行權限
chmod +x /tmp/zeabur_new

# 移到 PATH 中（如果有舊版先移除）
rm -f "$(which zeabur)" 2>/dev/null
mv /tmp/zeabur_new /usr/local/bin/zeabur

# 驗證
zeabur version
# VERSION: 0.5.6

macOS Intel：

curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_darwin_amd64" \
  -o /tmp/zeabur_new
chmod +x /tmp/zeabur_new && mv /tmp/zeabur_new /usr/local/bin/zeabur

Linux x86_64：

curl -sL "https://github.com/zeabur/cli/releases/download/v0.5.6/zeabur_0.5.6_linux_amd64" \
  -o /tmp/zeabur_new
chmod +x /tmp/zeabur_new && sudo mv /tmp/zeabur_new /usr/local/bin/zeabur

提示：可以用 GitHub API 查詢最新版本號：
curl -sL "https://api.github.com/repos/zeabur/cli/releases/latest" | grep '"tag_name"'

第二步：登入 Zeabur

安裝完成後，執行登入：

zeabur auth login

瀏覽器會自動跳出 Zeabur 登入頁面，完成 OAuth 授權後，終端機會顯示：

INFO  Logged in as  {"user": "your-username", "email": "[email protected]"}

確認登入狀態：

zeabur auth status

如果瀏覽器跳出 ERR_CONNECTION_REFUSED：大概率是 CLI 版本太舊，請確認你用的是 Go 版本（0.5.x），不是 npm 版本（0.2.x）。

第三步：取得 Zeabur API Token

MCP Server 需要一個 API Token 來驗證身份。取得方式：

前往 Zeabur Dashboard（dash.zeabur.com）
點擊右上角頭像，選擇 Settings
左側選單選擇 Developer
在 API Key 區域，點擊 Generate New Token
點「眼睛」圖示查看，再點「複製」按鈕複製 Token

Token 格式大致為：sk-xxxxxxxx

安全提醒：這個 Token 等同於你的帳號權限，請妥善保管，不要提交到 Git。

第四步：在 Claude Code 中設定 Zeabur MCP

方法一：用 `claude mcp add` 指令（推薦）

在終端機執行：

claude mcp add zeabur \
  --scope user \
  -e ZEABUR_TOKEN=sk-你的 Token \
  -- npx @zeabur/mcp-server

參數說明：

zeabur：MCP Server 的名稱（自訂）
--scope user：全域設定，所有專案都能用
-e ZEABUR_TOKEN=...：環境變數，傳入 API Token
-- npx @zeabur/mcp-server：啟動指令

方法二：手動編輯設定檔

如果你偏好直接編輯設定檔，找到 Claude Code 的 MCP 設定檔：

macOS：~/.claude.json 或 ~/.claude/settings.json

加入以下內容：

{
  "mcpServers": {
    "zeabur": {
      "command": "npx",
      "args": ["@zeabur/mcp-server"],
      "env": {
        "ZEABUR_TOKEN": "sk-你的 Token"
      }
    }
  }
}

驗證設定

claude mcp list

應該會看到 zeabur 出現在清單中。

設定完成後你可以做什麼？

成功設定 Zeabur MCP 後，你可以直接在 Claude Code 中用自然語言管理雲端服務：

操作	範例指令
建立專案	「幫我在 Zeabur 建一個新專案叫 my-app」
部署應用	「把這個專案部署到 Zeabur」
查看服務狀態	「列出我 Zeabur 上的所有服務」
設定環境變數	「幫我加一個環境變數 DATABASE_URL」
綁定網域	「幫這個服務綁定 api.example.com」
查看 Log	「看一下部署的 log 有沒有錯誤」
執行資料庫指令	「在 Postgres 裡跑這個 SQL 查詢」

這些操作都不需要離開 Claude Code，直接在對話中完成。

實際使用情境：Zeabur MCP 能幫你做什麼？

光看功能列表可能還是有點抽象，以下是幾個真實的使用情境，讓你感受 MCP 帶來的效率提升。

情境 1：快速部署 Side Project

你剛寫完一個 Next.js 小專案，想丟到線上讓朋友看看。

以前的做法：開瀏覽器 → 登入 Zeabur Dashboard → 建專案 → 連 GitHub Repo → 等部署 → 設環境變數 → 綁網域

用 MCP 之後，在 Claude Code 裡直接說：

幫我在 Zeabur 建一個專案叫 my-side-project，
把當前的 repo 部署上去，
加一個環境變數 DATABASE_URL=postgres://...，
然後綁定 demo.example.com

一段話搞定，不用切換任何視窗。

情境 2：跨專案管理多個服務

你同時維護 3 個 Zeabur 專案，需要檢查它們的狀態。

列出我所有 Zeabur 專案的服務狀態，
如果有任何服務掛掉了，幫我查一下最近的 log

AI 會自動遍歷所有專案，回報異常，附上相關 log — 省去你逐一登入 Dashboard 檢查的時間。

情境 3：Debug 線上問題

使用者回報 API 出錯，你需要看部署的 log。

幫我看一下 Brickverse 專案裡 backend 服務最近的部署 log，
找找有沒有 error 或 exception

不用開 Dashboard、不用翻 log 頁面，直接在 Claude Code 裡看結果。

情境 4：資料庫快速操作

你想在 Postgres 裡跑一段 SQL 查詢，但不想另開資料庫工具。

在 Brickverse 專案的 Postgres 裡執行：
SELECT count(*) FROM users WHERE created_at > '2026-01-01'

直接在對話中拿到結果，適合快速驗證資料。

情境 5：環境變數批次管理

專案要遷移環境，需要更新一批環境變數。

幫我把 Brickverse 專案的以下環境變數更新：
- API_URL=https://new-api.example.com
- REDIS_HOST=new-redis.example.com
- ENABLE_CACHE=true

一次講完，AI 批次幫你改好，不用一個一個在 Dashboard 裡點。

為什麼這很重要？

關鍵不只是「方便」，而是 不中斷心流（Flow）。

踩坑總結表

問題	原因	解法
`brew install zeabur` 失敗	沒有 Homebrew formula	從 GitHub Releases 下載 binary
`npm update -g @zeabur/cli` 無效	npm 套件停更，已改用 Go	同上
官方 install script 404	Repo 中不存在安裝腳本	同上
每次執行都跳瀏覽器	CLI 未登入 + 版本太舊	升級到 Go 版後重新 `zeabur auth login`
MCP Server 連不上	Token 未設定或過期	到 Dashboard > Settings > Developer 重新產生

常用指令速查

# Zeabur CLI
zeabur version             # 查看版本
zeabur auth login          # 登入
zeabur auth status         # 確認登入狀態
zeabur project list        # 列出所有專案
zeabur deploy              # 部署當前專案

# Claude Code MCP
claude mcp list            # 列出已設定的 MCP Server
claude mcp add zeabur ...  # 新增 Zeabur MCP
claude mcp remove zeabur   # 移除 Zeabur MCP

結語

整個設定流程其實不複雜，但 Zeabur CLI 從 Node.js 遷移到 Go 的過渡期確實容易讓人踩坑。記住兩個關鍵：

CLI 要用 Go 版本（從 GitHub Releases 下載，不是 npm 安裝）
MCP 需要 API Token（從 Dashboard > Settings > Developer 產生）

搞定這兩點，你就能在 Claude Code 裡直接管理 Zeabur 上的所有服務了。

前言

你需要準備什麼

第一步：安裝 Zeabur CLI

為什麼需要 CLI？

踩坑紀錄：三條死路

坑 1：Homebrew 找不到

坑 2：npm 套件版本過舊

坑 3：沒有官方安裝腳本

正確安裝方式：下載 Go Binary

第二步：登入 Zeabur

第三步：取得 Zeabur API Token

第四步：在 Claude Code 中設定 Zeabur MCP

方法一：用 `claude mcp add` 指令（推薦）

方法二：手動編輯設定檔

驗證設定

設定完成後你可以做什麼？

實際使用情境：Zeabur MCP 能幫你做什麼？

情境 1：快速部署 Side Project

情境 2：跨專案管理多個服務

情境 3：Debug 線上問題

情境 4：資料庫快速操作

情境 5：環境變數批次管理

為什麼這很重要？

踩坑總結表

常用指令速查

結語

延伸閱讀

Willy / 柏燁．Brickverse 創辦人

前言

你需要準備什麼

第一步：安裝 Zeabur CLI

為什麼需要 CLI？

踩坑紀錄：三條死路

坑 1：Homebrew 找不到

坑 2：npm 套件版本過舊

坑 3：沒有官方安裝腳本

正確安裝方式：下載 Go Binary

第二步：登入 Zeabur

第三步：取得 Zeabur API Token

第四步：在 Claude Code 中設定 Zeabur MCP

方法一：用 `claude mcp add` 指令（推薦）

方法二：手動編輯設定檔

驗證設定

設定完成後你可以做什麼？

實際使用情境：Zeabur MCP 能幫你做什麼？

情境 1：快速部署 Side Project

情境 2：跨專案管理多個服務

情境 3：Debug 線上問題

情境 4：資料庫快速操作

情境 5：環境變數批次管理

為什麼這很重要？

踩坑總結表

常用指令速查

結語

延伸閱讀

Willy / 柏燁．Brickverse 創辦人