zaDojo MCP 伺服器設定：Claude、Cursor、Codex

zaDojo 提供遠端 MCP 伺服器，任何支援遠端 MCP 的用戶端都能連線。MCP（Model Context Protocol）是 AI 應用程式呼叫外部工具的標準方式。透過它，你的代理可以研究關鍵字、讀取即時 Google 結果、查詢任何網域的排名與反向連結、執行網站稽核、追蹤排名與 AI 回答，並讀取你自己的 Search Console 與 Google Analytics 資料。

伺服器網址：

https://app.zadojo.com/mcp

用戶端第一次連線時，會在瀏覽器中打開 zaDojo 登入頁，並要求你核准存取。之後，用戶端就能在你看得到的專案中使用這些工具。若是 CI 工作或沒有瀏覽器的伺服器，請使用 API 金鑰。

Claude Code 與 Codex 使用者安裝外掛能得到更多：一次安裝就同時加入這個連線與十二項 zaDojo 技能。如果你只需要 MCP 連線，或你的用戶端沒有外掛，請使用本頁的步驟。代理設定指南中有一段提示詞，會幫你選擇合適的方式。

你需要準備

• 一個 zaDojo 帳號。註冊即可獲得 €0.10 試用點數，無需信用卡。
• 支援透過 HTTP 連接遠端 MCP 伺服器的用戶端：Claude Code、Claude Desktop、Cursor、Codex CLI、ChatGPT 桌面應用程式中的 Codex、使用自訂連線的 ChatGPT、搭配 Copilot 的 VS Code、Windsurf（Devin Desktop）、Gemini CLI、Zed 或類似工具。
• 用來登入的瀏覽器，或在無介面環境中使用的 API 金鑰。

應用程式內的 Agent setup 頁面也會顯示同一個網址，並附有複製按鈕。想在註冊前先試試 zaDojo 的資料？免費 SEO 工具不需要帳號。

連接你的用戶端

Claude Code

對大多數人來說，Claude Code 外掛是更好的選擇。如果只要連線，請在終端機執行：

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

--scope user 讓 zaDojo 在你電腦上的所有專案中都能使用。用 --scope local 則只限目前的儲存庫。接著 Claude Code 會提示你登入 zaDojo。如果沒有出現提示，執行 /mcp，選擇 zaDojo 並在那裡完成登入。

Claude Desktop

使用 Claude 付費方案時，zaDojo 外掛會一起加入連線與技能。使用 Free 方案，或只需要連線時，請加入自訂連接器：

1. 打開 Customize > Connectors。
2. 點 Add 或 +，選擇 Add custom connector。
3. 貼上 https://app.zadojo.com/mcp。
4. 登入 zaDojo 並核准存取。

自訂連接器適用於 Claude Free、Pro、Max、Team 與 Enterprise。Free 方案只能加入一個自訂連接器。

Cursor

1. 打開 Customize 並前往 MCP servers，或直接編輯 ~/.cursor/mcp.json。
2. 加入 zaDojo 項目：

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

3. 儲存檔案，並在 Cursor 詢問時核准 zaDojo 登入。

Cursor 指南提供一鍵安裝連結與技能安裝方式。

Codex CLI

Codex 外掛會一起加入連線與技能。如果只要連線：

codex mcp add zadojo --url https://app.zadojo.com/mcp

登入頁打開時核准 zaDojo 登入。如果沒有打開，請執行 codex mcp login zadojo。

ChatGPT 桌面應用程式中的 Codex

Codex 外掛也包含技能。如果只要連線：

1. 打開 Codex，前往 Settings > MCP servers > Add server。
2. 名稱輸入 zadojo，選擇 Streamable HTTP，貼上 https://app.zadojo.com/mcp。
3. 儲存，並在 Codex 詢問時點 Restart。
4. 點 zaDojo 旁的 Authenticate，核准登入。
5. 開啟新的 Codex 對話，執行連線檢查。

這個連線只適用於 Codex。網頁版 ChatGPT 需要另外設定。OpenAI 的參考資料是 Codex MCP 文件。

ChatGPT

以 OAuth 將 zaDojo 加為自訂 MCP 連線。ChatGPT Free 與付費方案都能使用，但工作區管理員可以封鎖自訂連線。ChatGPT 指南會逐一說明每個畫面。

VS Code、Windsurf 與 Gemini CLI

每個工具都有專屬頁面，列出確切設定、API 金鑰設定與技能安裝方式：

• VS Code 搭配 GitHub Copilot
• Windsurf（Devin Desktop）
• Gemini CLI 與 Antigravity CLI

其他 MCP 用戶端

任何能透過 streamable HTTP 連接遠端 MCP 伺服器、並支援 OAuth 登入的用戶端，都能使用上方網址。如果用戶端不支援 OAuth，請依下一節說明在標頭中傳送 API 金鑰。

以上用戶端第一次連線時，都會在瀏覽器中打開 zaDojo 登入頁。

使用 API 金鑰連線

API 金鑰可取代瀏覽器登入。適用於 CI 流程、遠端伺服器、無法使用登入流程的代理（例如 Hermes），或任何不支援 OAuth 的用戶端。

金鑰屬於你個人。代理用它做的任何事，都會以你的帳號在你的工作區中執行，所以請把它當成機密保存，絕對不要提交到儲存庫。

建立金鑰的方法：在 zaDojo 應用程式中打開設定，找到 API keys，點 Create API key。請立刻複製金鑰，因為 zaDojo 只會顯示一次。金鑰以 zadojo_ 開頭。

Claude Code：

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

**Cursor：**在 mcp.json 的 zaDojo 項目中加入 headers 區塊：

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

**Codex CLI：**把金鑰存在環境變數中，再讓 Codex 指向它：

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

**其他用戶端：**每次請求都傳送 Authorization: Bearer zadojo_YOUR_KEY 或 x-api-key: zadojo_YOUR_KEY。

要撤銷金鑰，請打開同一個 API keys 區塊並刪除它。

檢查連線

開啟新的對話或工作階段並傳送：

用 zaDojo 檢查我的連線，並列出我的專案。

代理應該會呼叫 whoami 與 list_projects。你會看到你的帳號、剩餘點數與專案；如果還沒有專案，則顯示空清單。兩項工具都免費。如果代理只是在描述 MCP 而沒有呼叫工具，代表這個工作階段沒有載入伺服器：請重新載入用戶端或開始新的對話。

可用的工具

伺服器提供 80 多種工具。下表依工作類型分組，工具名稱就是你的代理看到的名稱。

幾項值得了解的行為：

• 專案情境是專案的共用記憶：業務概覽、目前目標、定位、寫作偏好、競爭對手、重點頁面與研究紀錄。代理在開始前會先讀取它，應用程式與其他代理看到的也是同一份內容。
• 代理儲存的報告會出現在專案中，整個團隊都能閱讀、列印或匯出。新報告預設為私人。只有在你要求代理以 public: true 呼叫 set_report_sharing 時才會建立公開連結，public: false 則會撤銷連結。有公開連結時，get_report 會回傳 report.shareUrl，沒有時則為 null。
• Search Console 與 Google Analytics 工具讀取的是專案已連接的資源，存取權限為唯讀。
• 任何週期性工作都會先估價。排名追蹤與 AI 追蹤都有估價工具，讓代理在排程檢查前先向你顯示費用。

哪些動作會消耗點數

點數來自你的 zaDojo 餘額。1,000 點等於 €1，每月 €10 的方案內含 €10 用量。一般價格：

免費項目：帳號檢查、專案情境、已儲存的關鍵字、報告、Search Console、Google Analytics、一般網站稽核，以及讀取你已收集的排名追蹤、稽核或 AI 能見度結果。連上 zaDojo 的代理被設定為：計畫中的批次作業超過 2,000 點（約 €2）時，會先詢問你。餘額歸零時，付費工具會停止運作，直到你儲值。費用估算器請見價格。

連線之後

連線讓你的代理取得資料，技能則一步步告訴它如何運用這些資料。如果你使用的是沒有外掛的 MCP，下一步請安裝技能。

給代理一項明確的工作，不要只叫它「做 SEO」：

• SEO Project Setup：儲存你的目標、定位、競爭對手與重點頁面，讓之後的每項任務都從這裡出發。
• SEO Coach：如果你剛接觸 SEO，取得一個建議的下一步。
• SEO Audit：找出最可能提升流量的幾項修改。
• Keyword Research 與 Keyword Clustering：找出值得鎖定的搜尋字詞，並分組成頁面。
• Competitive Landscape 與 Competitor Analysis：描繪整個市場，或深入研究一個對手。
• Link Prospecting：找出可能連結到某個頁面的網站，並草擬外展信。
• AI Prompt Research 與 AI Visibility Audit：看看 AI 工具怎麼談論你的市場，以及為什麼競爭對手會被提到。

AI 能見度指南說明 AI 回答追蹤的引擎、涵蓋範圍與費用。

疑難排解

**用戶端無法連線。**確認網址完全是 https://app.zadojo.com/mcp，包含 https://，且結尾沒有空格。

**Codex 顯示 Authorization server response missing required issuer: expected https://app.zadojo.com。**Codex 0.143 到 0.146 版在 OAuth 過程中會遺失 issuer。請將 Codex CLI 或 Codex 桌面應用程式更新到 0.147.0 或更新版本，或改用 API 金鑰。

**登入失敗或一直過期。**從用戶端移除 zaDojo 伺服器，重新加入後再登入一次。

**代理找不到專案。**請它先呼叫 list_projects，並在之後的呼叫中重複使用回傳的專案 ID。如果你還沒有專案，請它用 create_project 為你的網域建立一個，這是免費的。

**付費工具顯示點數不足。**付費方案使用者可在應用程式的帳務頁面購買儲值，或等每月點數重置。試用中的使用者請訂閱方案，才能繼續使用付費工具。

還是卡住了？寄信到 hello@zadojo.com，附上你的用戶端名稱、版本與確切的錯誤訊息。請勿附上 API 金鑰。