MCP整合

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

給初次使用者： 新建立組織的人，以及受邀加入組織的人，目標頁面中會有「設定Addness」。在其中的「1. 將AI連接到Addness」這一列按下「諮詢AI」→「在Claude Code中開啟」（或「在Codex中開啟」），AI 就會從連接 Addness 開始依序推進（→ 目標頁面）。從安裝 AI 應用程式開始的步驟，請見安裝AI應用程式並連接Addness。本篇文章只說明 MCP 整合的部分。

把請求文傳送給 AI

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

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

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

AI 將能做到的事

無論從哪個 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

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

claude mcp login addness

1. 確認連線（清單中出現 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

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

codex mcp list

Cursor

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

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

1. 在 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 的工具」或「需要認證」，請見連接不上的時候。

若要從畫面上交辦：「諮詢AI」

除了用話語拜託之外，也可以從目標列右側的✦（「諮詢AI」）交辦（手機寬度時為列的「…」→「諮詢AI」）。

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

按下「在Claude Code中開啟」「在Codex中開啟」「在ChatGPT中開啟」，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 天後中斷。在以下情況下，會在 90 天之前中斷。從同一個 AI 應用程式重新連接時，該應用程式先前的連線會中斷。每人最多可以有 20 個連線，超過後，會從最久未使用的連線開始中斷（使用多台電腦或多個 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 連接

<a id="mobile-only"></a>

僅在手機上使用 Addness

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

<a id="phone-pc-relay"></a>

無法從手機委託

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

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

• 出現「還沒有連上電腦上的AI」： 電腦的準備還沒完成。請在電腦上開啟 Addness，按下「用手機委託AI工作」的「諮詢AI」（✦）並完成
• 一直顯示「電腦喚醒後開始」而沒有動作： 電腦處於睡眠狀態，或桌面應用程式已關閉。喚醒電腦並開啟應用程式，就會開始運作。經過 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的問題」與我們聯絡