2026-06-05 · 7 分鐘閱讀

🖥️用 Claude Desktop + MCP 管 ticket — 完整教學

5 分鐘把 Stackr 接到 Claude Desktop,從此用對話就能查 ticket、開單、留言、追時間。完整步驟、實戰範例、卡關排錯。

MCP(Model Context Protocol)是 Anthropic 推的協定,讓 AI 助理可以直接呼叫外部工具。 Stackr 提供完整的 MCP server(86 個 tool 涵蓋 ticket、sprint、文件、留言、時間追蹤、自動化), 意思是你可以用對話的方式操作整個 workspace,不用切到瀏覽器。

這篇教學 5 分鐘接好,從零開始。

前置作業

Stackr 帳號(沒帳號的話先註冊)
Claude Desktop(macOS / Windows / Linux 都可)
Node.js 18+(MCP server 用 npx 跑)

Step 1 — 建立 API token

進到 Stackr 的 Settings → API Tokens, 建一個 token 給 Claude 用。token 格式 sk_...,**產生後只顯示一次**,先複製起來。

Step 2 — 編輯 Claude Desktop 設定檔

依你的作業系統開這個檔案(不存在就新建):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Step 3 — 貼入這段 JSON

sk_replace_me 換成你剛複製的 token:

claude_desktop_config.json

{
  "mcpServers": {
    "stackr": {
      "command": "npx",
      "args": ["-y", "@stackr/mcp"],
      "env": {
        "STACKR_API_URL": "https://stackr.9niche.com",
        "STACKR_API_TOKEN": "sk_replace_me"
      }
    }
  }
}

Step 4 — 重啟 Claude Desktop

完全關掉 Claude Desktop(不是只縮小視窗),再開一次。重開後在新對話的下方應該會看到「🔌 stackr」這個工具圖示, 點開可以看到 86 個 stackr_* 工具。

實戰範例

接下來就可以開始用對話操作。幾個常用情境:

每週狀態回報

你: 幫我整理上週(2026-06-02 到 2026-06-08)我做的所有 ticket,
     寫成週報格式,按 board 分組,每張 ticket 用一句話總結。

Claude:(自動呼叫 stackr_list_tickets + stackr_list_activities)
       本週進度:

       STAC(產品開發)
       - STAC-42 ✅ 修好 mobile 拖拉 bug
       - STAC-43 ✅ 加入 Bing IndexNow 整合
       - STAC-44 🔄 進行中:重構 ticket modal

       BLOG(內容)
       - BLOG-5 ✅ 發布 "Why Stackr" 文章
       ...

批次開單

你: 在 STAC board 建 3 張 bug 票:
     1. 登入頁 redirect 偶爾失敗
     2. 忘記密碼 email 沒寄出
     3. Verify 連結點兩次會 400
     優先級都設 high,指派給我。

Claude:(自動呼叫 stackr_create_ticket × 3)
       ✓ 建立 STAC-45: 登入頁 redirect 偶爾失敗
       ✓ 建立 STAC-46: 忘記密碼 email 沒寄出
       ✓ 建立 STAC-47: Verify 連結點兩次會 400

Sprint 健康度分析

你: 看一下現在 active sprint 的進度,標出有風險的 ticket。

Claude:(呼叫 stackr_list_sprints + stackr_list_tickets + stackr_list_activities)
       Sprint 12(2026-06-01 ~ 2026-06-14)進度 60%

       ⚠️ 風險 ticket:
       - STAC-44 已 4 天沒更新,due 2026-06-12
       - STAC-50 標 high priority 但還在 todo

       建議:把 STAC-44 拆成 subtask,或延到下個 sprint。

卡關排錯

看不到 stackr 工具:確認 Claude Desktop 完全關掉再開(不是縮小)。檢查 JSON 有沒有打錯字 — 一個逗號錯就會載入失敗。
token 顯示 unauthorized:可能被撤銷或打錯。回 Settings 重新建一個。
本機開發環境:把 STACKR_API_URL 改成 http://localhost:3000 並確認 dev server 跑著。