CanGoal 標誌
CanGoal

溫柔陪你達成目標的夥伴

🤖 MCP（模型情境協議）

CanGoal 內建 MCP（模型情境協議）伺服器，讓 Claude Desktop、Cursor 和 ChatGPT Desktop 等 AI 助理可以透過安全的本地連結，直接讀取和管理你的目標、任務、計時工作階段、筆記和統計數據。

  • 協定：MCP 2025-06-18 + JSON-RPC 2.0
  • 傳輸方式：僅支援 stdio（stdin/stdout）— 不使用 HTTP 或 WebSocket 伺服器
  • 工具數量：22 個（Goal 6 / Task 6 / Timing 3 / Note 5 / Stats 2）
  • 平台：僅支援 macOS（桌面用戶端無法啟動 iOS 行程）

MCP 以內建於 CanGoal 的獨立輔助執行檔形式運作，不會干擾主應用程式 — 你可以同時使用圖形介面與 AI 助理。

MCP 讓你的 AI 能做什麼

連結後，你的 AI 助理可以：

  • 讀取你的數據 — 列出目標、任務、計時記錄、筆記和統計數據。
  • 建立與編輯 — 新增目標和任務、完成任務、開始/停止專注計時器，以及新增筆記。
  • 追蹤進度 — 查詢統計數據和各目標的量化進度。

AI 所做的一切都經過與 CanGoal 應用程式完全相同的商業邏輯，因此連續紀錄、小工具、通知和 CloudKit 同步的行為都完全一致。

連結你的 AI 用戶端

MCP 輔助程式位於已安裝的應用程式內，路徑為：

/Applications/CanGoal.app/Contents/Helpers/CanGoalMCP.app/Contents/MacOS/CanGoalMCP

Claude Desktop

編輯 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "cangoal": {
      "command": "/Applications/CanGoal.app/Contents/Helpers/CanGoalMCP.app/Contents/MacOS/CanGoalMCP",
      "args": []
    }
  }
}

重新啟動 Claude Desktop。你應該會看到 cangoal 伺服器的 22 個工具出現在工具選單中。

Cursor

前往 Settings → MCP Servers → Add new MCP Server：

  • 類型：command
  • 名稱：cangoal
  • 指令：/Applications/CanGoal.app/Contents/Helpers/CanGoalMCP.app/Contents/MacOS/CanGoalMCP

ChatGPT Desktop

前往 Settings → Connectors → Add new connector，並使用與 Claude Desktop 相同的 JSON 設定。

可用工具（22 個）

Goal (6)

  • list_goals — 列出所有目標，可選擇按狀態 / 啟用中篩選
  • get_goal — 取得目標詳情（進度、統計摘要）
  • create_goal — 建立目標（名稱、類型、顏色、截止日期、量化目標）
  • update_goal — 更新目標欄位
  • delete_goal — 軟刪除目標
  • list_goal_templates — 列出可用的目標範本

Task (6)

  • list_tasks — 列出任務，按目標 / 日期 / 狀態篩選
  • get_task — 取得任務詳情（清單、連續紀錄）
  • create_task — 在目標下建立任務
  • update_task — 更新任務欄位
  • complete_task — 將任務標記為完成（觸發連續紀錄 / 小工具 / 通知，與圖形介面相同）
  • delete_task — 刪除任務

Timing (3)

  • start_timing — 為任務開始專注工作階段（碼錶或番茄鐘）
  • stop_timing — 停止目前的工作階段，寫入 TimingRecord + GoalEvent
  • list_timing_records — 查詢計時歷史紀錄

Note (5)

  • list_notes — 按目標 / 任務 / 日期查詢筆記
  • get_note — 取得筆記的完整內容
  • add_note — 在目標或任務中新增文字筆記
  • update_note — 編輯筆記
  • delete_note — 刪除筆記

Stats (2)

  • get_statistics — 全域統計（今日完成數、連續紀錄、總計時、目標概覽）
  • get_goal_progress — 目標的量化進度 + 各任務的貢獻度

隱私與安全

  • MCP 完全在本地透過 stdio 運作 — 你的數據不會經過任何額外的伺服器。
  • 輔助程式讀取和寫入與 CanGoal 應用程式相同的 Core Data 儲存區（透過 App Group 容器），受 App Sandbox 保護。
  • MCP 連線本身不會收集或傳輸任何個人數據；它只存取你的 CanGoal 資料庫中已有的內容。
  • CloudKit 同步讓 MCP 輔助程式與圖形介面之間的數據保持一致，就像在你的各個設備之間一樣。

疑難排解

  • AI 用戶端看不到工具 — 指令路徑指向帶有 --mcp 的舊主執行檔。修復：使用 Contents/Helpers/CanGoalMCP.app/... 下的輔助程式路徑，並移除 --mcp 參數。
  • 工具回傳 isError: true — 商業邏輯錯誤（找不到資源 / 狀態衝突 / 參數錯誤）。修復：閱讀 content[0].text 中的訊息。
  • 工具回傳 JSON-RPC 錯誤 -32602 — 工具名稱錯誤或結構描述不符。修復：執行 tools/list 重新檢查結構描述。
  • 輔助程式讀取到空數據 — Core Data 儲存區不符。修復：確認應用程式已安裝且有數據；輔助程式共用同一個儲存區。

注意事項

  • MCP 僅支援 macOS — 桌面 AI 用戶端無法啟動 iOS 應用程式。
  • 僅支援 stdio 傳輸（不支援 HTTP / WebSocket / SSE）。
  • 單一輔助程式行程一次只服務一個用戶端工作階段。
  • 不支援 resources/* 和 prompts/* MCP 方法；僅支援 tools/*。
🤖 MCP（模型情境協議） – CanGoal