Archboard

Archboard 插件

Archboard 是一个托管式图表工作区，支持架构图、Kubernetes、C4、流程图、ER 图、思维导图和白板。 此存储库将 AI 应用连接到 Archboard MCP 服务，让助手能够在团队使用的同一实时画布上读取、创建和编辑图表。每个节点都采用节点包中的类型，因此最终结果始终是结构化图表，团队成员可以继续编辑，而不是一张静态图片。

• MCP 服务： https://getarchboard.app/mcp（远程，Streamable HTTP，OAuth 2.1）
• 文档： getarchboard.app/docs/mcp · 各应用的设置指南： getarchboard.app/integrations
• MCP Registry 名称： app.getarchboard/archboard

此存储库包含配置文件、一个用 Markdown 编写的技能和图片。不含代码，也不会在你的电脑上运行任何内容。

安装

每行对应一个步骤。首次使用工具时，应用会在浏览器中打开 Archboard 登录页面（参见 登录与访问）。如果你已从应用的连接器目录添加 Archboard，则无需在此处再次添加。

应用	安装
Claude（网页、桌面、移动端）	添加自定义连接器（Customize → Connectors，URL https://getarchboard.app/mcp）
Claude Code（含技能的插件）	claude plugin install archboard --marketplace getarchboard/archboard-plugin，然后选择 /mcp → plugin:archboard:archboard 登录
Claude 和 Cowork（含技能的插件）	Customize → Plugins → Add marketplace getarchboard/archboard-plugin，然后从插件的 Connectors 选项卡连接 Archboard
Claude Code（仅服务）	claude mcp add --transport http --scope user archboard https://getarchboard.app/mcp，然后运行 claude mcp login archboard
Cursor	添加到 Cursor
VS Code	code --add-mcp '{"name":"archboard","type":"http","url":"https://getarchboard.app/mcp"}'
Gemini CLI（扩展）	gemini extensions install https://github.com/getarchboard/archboard-plugin
Antigravity（含技能的插件）	agy plugin install https://github.com/getarchboard/archboard-plugin，然后选择 Customizations → Installed → Archboard → MCP → Authenticate
Codex（0.147.0 或更高版本）	codex mcp add archboard --url https://getarchboard.app/mcp
GitHub Copilot CLI	copilot mcp add --transport http archboard https://getarchboard.app/mcp
Grok（网页）	grok.com/connectors → New Connector → Custom，URL https://getarchboard.app/mcp
Grok Build	grok mcp add --transport http archboard https://getarchboard.app/mcp
Kiro	添加到 Kiro
其他 MCP 应用	远程服务 URL https://getarchboard.app/mcp，传输方式为 Streamable HTTP，使用 OAuth 登录

此存储库中的清单，按应用划分：

路径	用途
.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.mcp.json	Claude Code 和 Claude 插件
.cursor-plugin/plugin.json、mcp.json	Cursor
.antigravity-plugin/plugin.json、mcp.json	Antigravity
gemini-extension.json	Gemini CLI
chatgpt/	ChatGPT 和 Codex 插件包
skills/archboard-diagramming/SKILL.md	技能：Archboard 图表绘制指南
server.json	MCP Registry 条目

登录和访问权限

• 登录使用 OAuth 2.1（通过 PKCE 进行授权码授权）。应用通过客户端 ID 元数据文档或动态客户端注册进行注册。用户通过 Google 或 GitHub 登录 Archboard。
• 在授权屏幕上，你可以选择应用能够访问哪些组织和工作区，以及是否允许应用在其中读取、编辑或删除内容。删除操作会将图表移至回收站，你可以从中恢复。
• 你可以随时在 Archboard 的 Settings → Connected apps 中更改或移除应用的访问权限。移除后，应用会立即断开连接。
• 画布上应用的光标会标注应用名称，以及它所代表的用户。

示例提示词

1. Create a new Archboard diagram called "Checkout service" showing a web app, an API gateway, an orders service, a payments service and a Postgres database, with labeled connections.
2. Turn this Mermaid flowchart into an Archboard diagram: flowchart LR; Signup --> Verify{Email verified?}; Verify -->|yes| Onboarding; Verify -->|no| Reminder
3. List my Archboard diagrams and summarize the most recently updated one.
4. In the "Checkout service" diagram, add a Redis cache between the orders service and the database, then show me a snapshot.
5. Export the "Checkout service" diagram as an SVG and give me the download link.

工具

工具	功能	是否更改数据
read_me	使用指南：工作流、文档格式、布局规则、限制和错误代码	否
list_workspaces	此连接可使用的组织和工作区，以及相应的角色、套餐和权限	否
list_diagrams	此连接可访问的图表，按最新优先排序，并显示相应权限	否
create_diagram	在工作区中创建新图表	是
get_canvas	读取图表：按页获取大纲或完整记录	否
search_node_types	在各类资源包（Kubernetes、云、C4、BPMN、思维导图等）中查找节点类型	否
get_node_type	获取单个节点类型的尺寸、属性、样式键和端口	否
apply_ops	添加、更改或移除节点、连接和图像，并作为一次可撤销的更改处理	是，可移除
compose_diagram	绘制 Mermaid 流程图或信息图规范，并作为一次可撤销的更改处理	是
add_image	从公开的 https URL 添加图像；Archboard 服务只会下载一次	是
upload_image	为本地图像文件生成一次性上传链接（适用于能够运行 shell 命令的应用）	是
render_snapshot	渲染图表或其中一部分的 PNG 图像，以便检查结果	否
export_diagram	导出 PNG 或 SVG，并提供下载链接（有效期 15 分钟，最多下载 5 次）	否
get_selection	获取用户在已打开的编辑器中选中的内容	否
set_status	在画布上应用光标旁设置简短状态	否（仅状态信息）
revert_change	撤销此应用在过去 7 天内进行的一项更改	是
delete_diagram	将图表移至回收站（可以恢复；不会永久删除）	是，移至回收站
search_shapes	按关键词查找内置和已保存的形状与图标	否
show_diagram	在支持 MCP Apps 的应用中，在聊天内实时查看图表	否
viewer_poll、viewer_ticket	仅供聊天内查看器使用；模型不会调用	否

每个工具都会声明标题，以及只读、破坏性、幂等和开放世界提示。实时列表见服务卡片。

限制

• 计划限制与 Archboard 编辑器相同。免费计划：3 个图表，每个图表最多包含 15 个图表节点，以及 150 个便笺、文本、绘图、贴纸和思维导图主题。计划详情：getarchboard.app/pricing。
• 每个图表：2,000 个节点和连接、5 MiB 图片、4 MiB 其他内容。每次调用：10,000 项操作、6 MiB。
• 工具调用受用户和令牌的速率限制。达到限制时，服务会返回一条简短消息，说明适用的限制。

数据与隐私

• 你的 AI 应用只与一个服务通信：https://getarchboard.app/mcp。图表、你的账户以及你批准的连接由 Archboard 存储。请参阅隐私政策和条款。
• 应用所做的更改会保存在图表的更改日志中，可在 7 天内撤销（revert_change）。
• add_image：Archboard 的服务会下载你提供的 HTTPS URL 一次，并将图片存储在图表中。
• upload_image：在能够运行 shell 命令的应用中，应用会运行一次性上传命令，将你指定的那一个图片文件发送到 getarchboard.app。
• export_diagram 生成的链接会在 15 分钟后或下载 5 次后失效。
• Archboard 不包含自己的 AI 模型；助手就是你连接的应用。

支持与安全

• 支持：getarchboard.app/support · [email protected]
• 安全问题报告：请参阅 SECURITY.md 和 security.txt。

许可证

此代码库中的文件根据 MIT 许可证发布。Archboard 服务本身是托管产品，受其条款约束。

Archboard 是 Halil Öncen 的独立产品。本 README 中提及的 AI 应用名称用于说明此插件可安装的位置；本项目与这些应用的制造商无关联，也未获得其认可。