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
聊天	目标聊天、群组、私信的读写，创建群组
会议与会议纪要	请会议纪要 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 密钥（旧版 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 应用中的 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 应用中自带的 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咨询（支持表单）”联系我们。请照原样抄写错误信息；如果有停住时画面的截图，请在表单中粘贴截图的分享链接

这篇文章有帮助吗？

有没有

← 前へ安装AI应用并连接Addness次へ →通过视频了解用法

开始使用

• 安装AI应用并连接Addness
• 通过视频了解用法