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 密钥（旧版 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 应用中的“咨询AI”，会把请求送到电脑上的 Claude Code 或 Codex。需要电脑上装有 Addness 的桌面应用（→ 网页版与桌面应用），并用同一个 Addness 账号登录、保持打开，同时电脑处于唤醒状态。手机上打开的组织，也要和桌面应用中的组织相同。这些准备，只要在电脑上把“用手机向AI委托工作”这个目标交给 AI，AI 就会推进。在公司的 Windows 电脑上，有时无法运行桌面应用。

• 出现“还没有连接上电脑上的AI”： 电脑还没有准备好。请在电脑上打开 Addness，按下“用手机向AI委托工作”的“咨询AI”（✦）并完成
• 一直显示“电脑唤醒后开始”，没有动静： 电脑处于睡眠状态，或者桌面应用已关闭。唤醒电脑并打开应用，就会开始运行。经过 24 小时后，请求会被取消
• 出现“电脑上未找到 Codex”： 电脑上没有安装 codex 命令。请对电脑上的 AI 说“安装 codex 命令”，安装后重新打开桌面应用
• 使用的是 Mac 上 ChatGPT 应用中自带的 Codex： 桌面应用找不到 ChatGPT 应用内部的 Codex。请对电脑上的 AI 说“安装 codex 命令”，安装后重新打开桌面应用（桌面应用只会在主文件夹的 .local/bin 和终端查找命令的位置中寻找 Codex）
• 出现“请在电脑上的 Addness 中选择工作文件夹”或“电脑上的 Addness 尚未选择工作文件夹”： 请在电脑上打开桌面应用设置中的“リモート操作”（远程操作），在最上方的“作業フォルダ”（工作文件夹）中选择让 AI 工作的文件夹。选择之前，请求既不会送达 Claude Code，也不会送达 Codex
• 出现“请更新电脑上的 Addness”： 电脑上的桌面应用是旧版本。请更新到最新版本后重新发送
• 出现“电脑上的 Addness 中，Codex 的“从手机接收”已关闭”： 请在电脑上打开桌面应用设置中的“リモート操作”（远程操作），在“Codex”部分打开“スマホから受け付ける”（从手机接收）（请先选择“作業フォルダ”（工作文件夹））
• 请求没有送到 Claude Code： 请确认手机上的 Claude 应用，登录的是和电脑相同的 Claude 账号

还是连接不上

• 无论哪个步骤都连接不上： 杀毒软件或公司网络可能阻止了与 Addness 的通信。有过在软件设置中把 vt.api.addness.com 排除在扫描对象之外后连接成功的例子。如果是公司的电脑，请咨询信息系统部门的负责人
• 试到这里还是无法推进： 请附上停住时画面的截图，从帮助首页的“关于Addness的问题”联系我们