Archboard 登录页面没有打开
如果上方的设置步骤中有登录命令，请使用它。否则，请从应用中移除 Archboard 并重新添加：应用在连接时会打开登录页面。
关于 Codex
Codex 是 OpenAI 的编程智能体；您可以通过命令行为它添加 MCP 服务器。
设置 Codex
将 Archboard 添加到 Codex
在终端中运行以下命令：
codex mcp add archboard --url https://getarchboard.app/mcp需要 0.147.0 或更高版本。
浏览器打开后，请登录 Archboard 并批准该应用。
如果浏览器没有打开，请运行：
codex mcp login archboard该命令会将 Archboard 添加到这台电脑上 Codex 的配置中，随后 Codex 会打开浏览器供您登录。
登录并选择访问权限
应用会打开 Archboard。用 Google 或 GitHub 登录，选择它可以使用的组织和工作区，为每一项选择读取、编辑或删除，并为它命名。
请它画图
让您的智能体绘制或更新一张图表，然后在 Archboard 中打开，实时查看改动到达。
您的 AI 应用需要支持通过 OAuth 登录的远程 MCP 服务器。
试试这些提示词
连接后，用日常用语向 Codex 提出请求，例如：
- “在 Kubernetes 上画出我们的 checkout 服务，包含 Postgres 和 Redis。”
- “在我的“支付”图表中，在 checkout-api 旁边添加一个缓存。”
- “撤销你上一次的改动。”
套餐限制
MCP 在所有方案中可用，包括 Free，套餐限制与编辑器相同。智能体的工具调用另有每分钟速率限制。在 Free 上，您可以与自己的 AI 智能体实时编辑；与队友实时编辑需要 Pro 或 Enterprise 席位。
- Free：3 张图，每图包含 15 个图表节点 + 150 个便签、文本、手绘、贴纸和思维导图主题。
- Pro 与 Enterprise：无限图表与节点，另有席位供队友实时编辑。
故障排除
智能体能读取图表，但无法修改
如果您在连接时批准的是只读权限，请重新连接该应用并批准编辑权限。如果该应用在那个工作区的权限是“读取”，请在 设置 → 已连接的应用 中将其改为“编辑”；更改会在它的下一次调用时生效。
智能体找不到某个工作区或图表
应用可以使用您在连接时允许的组织和工作区。您可以在 设置 → 已连接的应用 中更改它们，无需重新连接。
智能体提示已达到套餐限制
MCP 的套餐限制与编辑器相同。达到限制时，智能体会显示 Archboard 的提示信息及升级链接。请删除不再需要的图表或节点，或升级到 Pro。
调用因速率限制而失败
智能体的工具调用有每分钟速率限制。请稍等片刻再试；请求更少、更大的改动会有帮助。
应用中没有添加自定义 MCP 服务器的选项
有些应用只在部分套餐中允许添加自定义 MCP 服务器，或需要管理员先开启。