MCP整合

Claude Code、Codex、ChatGPT、Cursor、Claude Desktop 等 AI 連接到 Addness（MCP 整合）後，AI 就能讀寫 Addness 中的目標、ToDo、留言等。

平常慣用的AI

Claude Code

Codex

Cursor

MCP

讀寫雙向

Addness的目標樹

🎯 Q1新增100家客戶

完成提案資料

理想・備註・留言・成果物

無論從哪個AI使用，連接的對象都是同一棵目標樹。進度與脈絡都會累積在這裡

給初次使用者： 註冊完成後開啟的設定畫面中，第一步「連接」就是把你使用的 AI 連接到 Addness（→ 首頁）。從安裝 AI 應用程式開始的步驟，請見安裝AI應用程式並連接Addness。本篇文章只說明 MCP 整合的部分。

把請求文傳送給 AI

只要把這段請求文送給你正在使用的 AI 即可。

請設定 Addness MCP（https://vt.api.addness.com/mcp）。

能設定的部分 AI 會自行完成，只有需要你操作的地方才會加以引導。只有在瀏覽器中的登入授權，請在 AI 引導你時親自完成。

AI 將能做到的事

能做到的事	範例
目標的讀寫	確認目標樹、建立／更新／完成目標
現在要做的ToDo	對「今天做什麼？」，查看實際的待辦事項與目標後回答
進度與活動	掌握團隊的動態、成員的活動、以及停滯的目標
留言與通知	對目標張貼留言、確認與處理通知
資源的登錄	將做好的東西作為資源連結到目標
目標搜尋	搜尋組織的目標
知識	搜尋、讀取、建立、更新組織的知識
雲端硬碟	搜尋資源、建立資料夾、移動、丟到垃圾桶與還原
螢幕錄影	列出錄影、讀取逐字稿、連結到目標、分享
檔案傳送	傳送大型檔案、確認傳送紀錄、停用連結
客戶名單（CRM）	匯入客戶、更新階段、整理聯絡人、記錄活動
分析	建立 KPI 定義與儀表板、每天早上更新資料
客戶旅程	建立旅程、登錄步驟和行動、記錄每天的執行情況
資料庫	建立表格、修改欄位、讀寫列
表單	建立並發布表單、讀取回答、匯出為 CSV
聊天	目標聊天、群組、DM 的讀寫、建立群組
會議與會議記錄	請會議記錄 bot 參加會議、會議記錄的列表與讀取
心智圖	建立心智圖、新增、編輯、移動分支（節點）
範本與例行任務	從範本建立目標、預約、變更例行任務
成員與組織圖	成員的指派、設定上司、發行邀請連結
小工具	在首頁和目標詳細頁面放置準備好的小工具
Network	搜尋人員和組織、檢視個人資料、貼文和徵才資訊、回覆貼文
挑戰	回報已完成挑戰的步驟

無論從哪個 AI 連接，讀寫的都是同一組織的同一棵目標樹。

如果中途停住：各工具的步驟

如果設定在權限或認證處停住，可以把以下步驟拿給 AI 看，或自己接續完成。

ChatGPT（官方外掛程式）

在 ChatGPT 中輸入「@Addness」，或從應用程式清單中選擇 Addness。點選「連結」，登入 Addness，然後點選「允許」。Free 方案也可以使用。寫入資料前需要確認。只能連接已有的 Addness 帳號（無法在 ChatGPT 的畫面中新註冊）。

Claude Code（終端機）

1. 新增 Addness MCP（加上 --scope user，就能從任何專案使用）

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

2. 登入 Addness（瀏覽器開啟後，用你的 Addness 帳號授權）

claude mcp login addness

3. 確認連線（清單中出現 addness 即完成；也可以從 Claude Code 內的 /mcp 確認）

claude mcp list

Codex（CLI）

只要在瀏覽器登入 Addness 即可使用。不需要建立 API key（舊版 Codex 不支援 OAuth，請更新到最新版後再執行）。

1. 新增 Addness MCP（瀏覽器會自動開啟，請用你的 Addness 帳號授權。設定會儲存到 ~/.codex/config.toml）

codex mcp add addness --url https://vt.api.addness.com/mcp

2. 確認連線（Auth 變成 OAuth 即完成。如果登入沒有開始，請執行 codex mcp login addness）

codex mcp list

Cursor

1. 開啟 ~/.cursor/mcp.json，加入以下設定（如果已有其他伺服器，只需新增 addness 這一項）

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

2. 在 Cursor 的 Settings → Tools & MCP 中按下 addness 的 Connect，並在瀏覽器中用你的 Addness 帳號授權

Claude Desktop

遠端 MCP 不是透過設定檔，而是以自訂連接器的形式新增。

1. 開啟 Customize → Connectors，選擇 + → Add custom connector
2. 將名稱設為 Addness、URL 設為 https://vt.api.addness.com/mcp 後儲存（Team / Enterprise 需要由 Owner 進行組織設定）
3. 按下 Addness 的 Connect，並在瀏覽器中授權（可以在每次對話時從 Connectors 啟用）

其他支援 MCP 的用戶端

只要是支援 Streamable HTTP 與 OAuth 的 MCP 用戶端都能連接。

1. 將伺服器名稱設為 addness、傳輸方式設為 Streamable HTTP
2. 將連線目標指定為 https://vt.api.addness.com/mcp
3. 從用戶端的認證按鈕登入 Addness，能取得工具清單即完成

確認是否已連接

請對 AI 說「給我看 Addness 的組織列表」。如果回覆了你所屬組織的名稱，就表示已經連接。也可以請它「給我看 Addness 現在要做的ToDo」，看是否回覆了你現在要做的ToDo。

如果你屬於多個組織，開始工作前請對 AI 說「把 Addness 的組織切換到〈組織名稱〉」。AI 會切換它操作的組織（switch_organization）。如果已經連接到該組織，就維持不變。切換後的組織，在同一個 AI 的下一次對話中也會沿用。

如果 AI 回覆「沒有 Addness 的工具」或「需要認證」，請見連接不上的時候。

若要從畫面上交辦：Addness it

除了用話語拜託之外，也可以從目標列右側的 Addness it 交辦（手機寬度時也在列的「…」左側）。

• 推進： AI 會讀取該目標的脈絡，直接推進
• 頭腦風暴： AI 會一邊與你對話一邊整理，提出子目標的方案。只有你同意的才會被建立
• 提問： 寫下想問的內容交給 AI，AI 會讀取目標後回答。不會變更目標

按下「在Claude中開啟」「在Codex中開啟」「在ChatGPT中開啟」「在Grok Bot中開啟」，AI 就會帶著含有目標 URL 與進行方式的指示文開啟。使用「複製指令」，則可貼到 Cursor 等其他 AI 中使用。在個人設定的「AI」中決定好「指令的傳送目標」，就不必每次選擇，一鍵即可開啟。關於會發生什麼事的詳細說明，請見首頁。

與外部整合 API 的差異

MCP 整合讓 AI 以你登入的帳號讀寫 Addness。如果只是想讓你自己的系統讀取組織成員與今日待辦，請使用以固定於組織的金鑰呼叫的外部整合 API（唯讀）。外部整合的金鑰不能用於 MCP。外部整合 API 僅在 Addness 開放的組織中可用。

連接不上的時候

以下是常見的問題與解決方法。AI 應用程式的安裝與連接方式，請見安裝AI應用程式並連接Addness。

無法使用 Addness 的工具

• 明明連接了，AI 卻說「沒有 Addness 的工具」： 在電腦上的 Claude Code 或 Codex 中，剛連接之後，要重新開啟 AI 應用程式才看得到工具。請結束應用程式後重新開啟，選取同一個對話，傳送「繼續」。只關閉視窗並不會結束應用程式。Mac 請按 Command + Q 結束。Windows 請用 Alt + F4 關閉，如果畫面右下角還留有圖示，請按右鍵並選擇「結束」。在終端機中，按兩次 Ctrl + C 結束，再用 claude --resume（Codex 為 codex resume）回到同一個對話
• 重新開啟後還是說「沒有」： Claude Code 有時要到使用 Addness 的工具時才會載入。請對 AI 說「找出 Addness 的工具並使用」
• 每次使用工具都要求許可而停住： 請對 AI 說「設定成不必每次確認就能使用 Addness 的工具」。在 Claude Code 中，mcp__addness 會加入設定檔（~/.claude/settings.json）的允許清單
• 為了騰出上下文空間，移除了 Addness 的工具： 移除期間，AI 無法讀取 Addness 的目標與 ToDo。與 Addness 一起工作時，請保持連接。如果已經移除，請對 AI 說「重新啟用 Addness 的工具」，然後重新開啟應用程式
• 瀏覽器版 Claude 或 ChatGPT 中沒有顯示 Addness： 在 ChatGPT 中透過官方外掛程式連結 Addness，或在瀏覽器版 Claude 中透過自訂連接器連結 Addness。請參閱僅在手機上使用 Addness。

登入無法進行、連線中斷

• 登入畫面沒有開啟： 請對 AI 說「開始 Addness 的登入，並顯示 URL」。將顯示的 URL 貼到瀏覽器中開啟，按下「允許」。如果沒有出現「允許」的畫面，或是開啟了別的瀏覽器，請見安裝AI應用程式並連接Addness的「不順利的時候」
• 按了「允許」卻出現錯誤： 登入畫面開著經過一段時間後，會出現「無法生成授權碼」等錯誤。請讓 AI 重新開始登入，並在開啟的畫面上立刻按下「允許」
• 以前能用，現在卻需要登入、反覆要求登入： 與 Addness 的連線在連接後 90 天會中斷。請對 AI 說「重新登入 Addness」，並在瀏覽器中按下「允許」
• 想新增連線時出現上限錯誤： 每人最多可以有 50 個連線。（除了 AI 的連線，桌面應用程式等的連線也計入同樣的 50 個。）達到 50 個後，新的連線會被拒絕（目前已連線的仍可照常使用）。不過，在桌面應用程式中登入時，桌面應用程式等自動建立的連線中，距上次使用時間最久的 1 個會被自動中斷，並建立新的連線（透過 AI 應用程式建立的連線不會被中斷）。舊的連線在連接後 90 天會中斷，之後就可以再新增連線
• 「允許」的畫面上出現「此組織已停止 AI 連線。請聯絡管理員。」： 組織的管理員停止了 AI 連線。請管理員在組織設定 › 對外存取中開啟「成員可以連接自己的 AI」（→ 組織設定）。開啟後，請對 AI 說「重新登入 Addness」
• 搞混了公司與個人的帳號： AI 連接的，是「連線到Addness MCP」畫面上顯示「當前登入賬戶：…」的帳號。按下「允許」之前，請確認電子郵件地址。如果用錯誤的帳號連接了，請先在瀏覽器的 Addness 以正確的帳號重新登入，再請 AI「重新登入 Addness」

連接到了別的組織

• AI 說「找不到對象」，或正在讀取其他組織的目標： AI 連接的組織，是你按下「允許」時在瀏覽器的 Addness 中選擇的組織。如果你屬於多個組織，請對 AI 說「把 Addness 的組織切換到〈組織名稱〉」。把目標的 URL 交給 AI 時，也請先切換到該目標所在的組織再請求

在 Windows 上停住

• 用 Codex 連接的途中，或從手機發出的委託停住： 只安裝 Codex 應用程式，電腦上有時仍無法使用 codex 指令。在 Windows 上，曾有這就是原因的例子。請對 AI 說「確認 codex 指令能不能用，不能用的話就安裝」。如果按下「在Codex中開啟」也無法開啟 Codex，請按「複製指令」，貼到 Codex 中傳送
• 在 Windows 版 Codex 中，Addness 的登入無法完成： 請將 Codex 更新到最新版本，再登入一次。如果仍無法完成，也可以改用 Claude Code 連接

僅在手機上使用 Addness

• ChatGPT 應用程式： 在 ChatGPT 中輸入「@Addness」，或從應用程式清單中選擇 Addness。點選「連結」，登入 Addness，然後點選「允許」。
• Claude 應用程式： 在 Safari 中開啟 claude.ai → 自訂 → 連接器 → ＋新增 → 新增自訂連接器 → 名稱輸入 Addness，URL 輸入 https://vt.api.addness.com/mcp → 連結並允許。在 Claude 應用程式中啟用 Addness，貼上指示並傳送。
• 在電腦上繼續： 依照從手機發出的請求沒有送達中的說明，將工作傳送給電腦上的 AI。

無法從手機委託

「從手機發出的請求沒有送達」說明如何將工作傳送給電腦上的 AI。如果只使用手機，請參閱「僅在手機上使用 Addness」。

手機上的 Addness App 的 Addness it，會把委託送到電腦上的 Claude Code 或 Codex。電腦上需要安裝 Addness 的桌面應用程式（→ 網頁版與桌面應用程式），以同一個 Addness 帳號登入並保持開啟，而且電腦必須處於喚醒狀態。手機上開啟的組織，也要與桌面應用程式的組織相同。這些準備，只要在電腦上用 Addness it 把「用手機委託AI工作」這個目標交給 AI，AI 就會推進。在公司的 Windows 電腦上，有時無法執行桌面應用程式。

• 出現「還沒有連上電腦上的AI」： 電腦的準備還沒完成。請在電腦上開啟 Addness，按下「用手機委託AI工作」這一列的 Addness it 並完成
• 一直顯示「電腦喚醒後開始」而沒有動作： 電腦處於睡眠狀態，或桌面應用程式已關閉。喚醒電腦並開啟應用程式，就會開始運作。經過 24 小時後，委託會被取消
• 出現「電腦上找不到 Codex」： 電腦上沒有安裝 codex 指令。請對電腦上的 AI 說「安裝 codex 指令」，安裝後重新開啟桌面應用程式
• 使用的是 Mac 上 ChatGPT App 內附的 Codex： 桌面應用程式找不到 ChatGPT App 內部的 Codex。請對電腦上的 AI 說「安裝 codex 指令」，安裝後重新開啟桌面應用程式（桌面應用程式只會在主資料夾的 .local/bin 和終端機尋找指令的位置中尋找 Codex）
• 出現「請在電腦上的 Addness 中選擇工作資料夾」或「電腦上的 Addness 尚未選擇工作資料夾」： 請在電腦上開啟桌面應用程式設定中的「リモート操作」（遠端操作），在最上方的「作業フォルダ」（工作資料夾）中選擇讓 AI 工作的資料夾。選擇之前，請求既不會送達 Claude Code，也不會送達 Codex
• 出現「請更新電腦上的 Addness」： 電腦上的桌面應用程式是舊版本。請更新到最新版本後重新傳送
• 出現「電腦上的 Addness 中，Codex 的「從手機接收」已關閉」： 請在電腦上開啟桌面應用程式設定中的「リモート操作」（遠端操作），在「Codex」區塊開啟「スマホから受け付ける」（從手機接收）（請先選擇「作業フォルダ」（工作資料夾））
• 委託沒有送到 Claude Code： 請確認手機上的 Claude App 是否以和電腦相同的 Claude 帳號登入

還是連接不上

• 不論哪個步驟都連接不上： 防毒軟體或公司網路有可能阻擋了與 Addness 的通訊。曾有在軟體設定中將 vt.api.addness.com 排除在掃描對象之外後連接成功的例子。如果是公司的電腦，請洽詢資訊部門的負責人
• 試到這裡仍無法推進： 請從幫助中心首頁的「Addness諮詢（支援表單）」與我們聯絡。請照原樣抄寫錯誤訊息；如果有停住時畫面的截圖，請在表單中貼上截圖的分享連結

這篇文章有幫助嗎？

有沒有

← 前へ安裝AI應用程式並連接Addness次へ →透過影片了解用法

開始使用

• 安裝AI應用程式並連接Addness
• 透過影片了解用法