zaDojo

VS Code SEO MCP:搭配 Copilot 設定 zaDojo

以 OAuth 或 API 金鑰將 zaDojo 的 SEO 與 AI 能見度 MCP 伺服器連上 VS Code 與 GitHub Copilot 代理模式,並加入十二項 SEO 技能。

連上 zaDojo 後,VS Code 中 GitHub Copilot 的代理模式就能研究關鍵字、讀取即時 Google 結果、查詢競爭對手的排名與反向連結、稽核你的網站、追蹤排名與 AI 回答,並讀取你的 Search Console 與 Google Analytics 資料。因為代理也能編輯你的檔案,你可以在同一個對話中從「這個頁面有什麼問題」一路走到修正完成。

你需要準備

  • 一個 zaDojo 帳號。註冊即可獲得 €0.10 試用點數,無需信用卡。方案每月 €10,內含 €10 用量。
  • 使用代理模式的 VS Code 與 GitHub Copilot。

加入 MCP 伺服器

從命令選擇區

  1. 執行 MCP: Add Server。
  2. 選擇 HTTP (HTTP or Server-Sent Events)。
  3. 貼上 https://app.zadojo.com/mcp,並命名為 zadojo。
  4. 選擇要儲存在這個工作區,還是你的使用者設定檔。
  5. VS Code 詢問時,在瀏覽器中核准 zaDojo 登入。

mcp.json

單一專案請建立 .vscode/mcp.json。若要用於所有專案,請執行 MCP: Open User Configuration 並改為編輯該檔案:

{
  "servers": {
    "zadojo": {
      "type": "http",
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

VS Code 會啟動伺服器,並在工具第一次需要時打開 zaDojo 登入頁。

使用 API 金鑰

在遠端機器、Codespaces 或任何瀏覽器登入失敗的地方,請使用金鑰。在設定 > API keys 建立金鑰。以下設定只會詢問一次金鑰,且不會把它寫進檔案:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "zadojo-key",
      "description": "zaDojo API key",
      "password": true
    }
  ],
  "servers": {
    "zadojo": {
      "type": "http",
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:zadojo-key}"
      }
    }
  }
}

絕對不要把金鑰本身貼進 .vscode/mcp.json,因為這個檔案經常會被提交。

加入 SEO 技能

技能為 Copilot 提供每項工作的逐步方法:SEO 稽核、關鍵字研究、分群、競爭對手分析、在地 SEO、連結開發、AI 提示詞研究、AI 能見度稽核與報告。VS Code 會從 .github/skills、.agents/skills 與 .claude/skills,以及你家目錄下的相同資料夾讀取技能。

npx skills add zadojo/seo-geo-mcp --skill '*' --agent github-copilot

加上 -g 可以為你的使用者安裝,而不只是這個工作區。技能總覽說明了每項技能。

檢查連線

以代理模式打開 Copilot Chat 並傳送:

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

代理應該會呼叫 whoami 與 list_projects,兩者都免費。如果它沒有呼叫工具就直接回答,請打開對話框中的工具選擇器,確認已勾選 zaDojo 工具。

適合的第一個請求

  • 「為我的網站執行 zaDojo SEO 稽核,並列出我可以在這個儲存庫中修正的項目。」
  • 「取得我最近 28 天的 Search Console 查詢,找出曝光高但點閱率低的頁面。」
  • 「為我目前打開的部落格文章研究關鍵字,並建議一個 60 字元以內的標題。」
  • 「看看 ChatGPT 怎麼回答『best [my category] for [my audience]』,以及它引用了哪些網站。」

讀取 Search Console 與 Analytics、已儲存的報告與一般網站稽核都不消耗點數。關鍵字研究每次搜尋約 €0.07。代理被設定為:計畫中的批次作業超過 €2 時,會先詢問你。MCP 指南提供完整的工具表格。

疑難排解

**登入視窗沒有打開。**執行 MCP: List Servers,選擇 zaDojo 並重新啟動。如果仍然失敗,請改用 API 金鑰方式。

**Copilot 看不到工具。**必須開啟代理模式,並在工具選擇器中勾選 zaDojo 的工具。有些組織會透過政策在 Copilot 中停用 MCP,請詢問你的管理員。