MCP

在 MeetAndy 中使用 MCP，把 Claude Code 等外部工具連到 MeetAndy 讀取任務，或連接 Notion 等第三方服務讓 Andy 代為操作。

MCP（Model Context Protocol）在 MeetAndy 中有兩種使用方向：

MeetAndy 作為 MCP server — 把 Claude Code、Cursor 或任何相容 MCP 的編輯器連到 MeetAndy，直接在編輯器中取得任務規劃與相關資訊。
第三方 MCP 連線 — 把外部服務（例如 Notion）連接到 MeetAndy，讓 Andy 在執行任務時可以讀取並操作這些服務。

MeetAndy 作為 MCP server

MeetAndy 提供 MCP 伺服器，任何相容 MCP 的客戶端（Claude Code、Cursor、Claude Desktop 等）都可以直接從本機工具取得 MeetAndy 資料。連好之後，你可以在編輯器裡直接說「從 MeetAndy 拉 MPD-123」而不必切換視窗。

MCP 伺服器能做什麼

MeetAndy MCP 伺服器提供三個工具給連線的客戶端：

get_task：用任務 slug（例如 MPD-123）、任務 UUID、或 hub URL 取得單一任務。回傳標題、描述、狀態、分支、PR 清單、Slack 討論串連結、最新規劃，以及變更說明。
list_tasks：列出任務。預設列出你在所有工作空間的進行中任務。可以指定工作空間、依狀態過濾、用關鍵字搜尋、分頁。
list_spaces：列出你在這間公司加入的工作空間，回傳每個工作空間的 key、名稱、描述。

所有存取都綁定你的帳號。你只看得到你已經加入的工作空間，以及你在網頁端原本就能看到的任務。

1. 建立 personal access token

登入 MeetAndy，開啟 /settings/tokens。
點 Create token，用裝置名稱命名（例如 Macbook Claude Code），選擇有效期限。
token 顯示時立即複製。明文僅顯示一次，遺失就只能撤銷後重新建立。

請把 token 當成密碼。任何拿到 token 的人都能讀取你的任務。

2. 連接 Claude Code

把 MeetAndy MCP 伺服器加到 ~/.claude.json。檔案不存在就先建立，貼上：

{
  "mcpServers": {
    "MeetAndy": {
      "type": "http",
      "url": "https://hub.meetandy.ai/api/mcp",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

把 <your-token> 換成步驟 1 複製的 token。

重新啟動 Claude Code。在新 session 問：

What MCP tools do you have from the MeetAndy server?

應該會列出 get_task、list_tasks、list_spaces。

支援 HTTP transport MCP 伺服器的客戶端都可以套用這段設定。Settings → Tokens 頁面會直接產生帶有你選定 token 的設定片段，可以一鍵複製。

3. 試試看

在 Claude Code 裡用 slug 指任意任務：

Fetch MPD-123 plan from MeetAndy

或列出你目前手上的任務：

What MeetAndy tasks am I working on right now?

工具參考

`get_task`

取得單一任務的完整資訊。

輸入

task（必填）：slug（如 MPD-224）、任務 UUID、或 hub URL（如 https://hub.meetandy.ai/tasks/MPD-224）。

輸出（JSON）

包含任務的 slug、標題、描述、狀態、phase、分支名稱與 URL、Slack 討論串 URL、pullRequests 陣列（url、number、title、status、branchName）、最新 plan（version、是否核准、內容）、最近的 walkthrough 摘要。

若任務尚未產生規劃或變更說明，工具會回傳描述目前狀態的錯誤訊息。