01
找到正确的上下文
从当前账户可见的工作区开始，再逐步定位文件夹和项目。
- list_workspaces
- list_folders
- list_projects
ON-UML / MODEL CONTEXT PROTOCOL
将你的编程智能体连接到 OnUML MCP 服务器。
OnUML MCP 服务器可以把 Codex、Claude Code、Cursor 和 OpenClaw 等编程智能体连接到你的图表工作区。发现可访问的工作区、读取图表源码，并在对话中完成可控更新。
能力概览
OnUML MCP 服务器可以做什么？
02
修改前先读取图表
先读取项目结构和最新图表源码，再执行修改。
- get_project
- get_diagram
03
安全地创建和更新
创建项目和图表，避免网络重试产生重复内容，也不会覆盖他人的最新修改。
- create_project
- create_diagram
- update_diagram
简要说明
什么是 OnUML MCP 服务器？
它是一个远程 MCP 服务器，让 AI 编程客户端可以操作你 OnUML 账户可访问的图表与项目。访问范围始终以当前工作区权限为准。
当图表需要和代码处在同一个工作流中时，可以用它探索项目、检查当前源码、更新 Mermaid 或 PlantUML 图表，或创建 OnUML 思维导图。结果仍可在 OnUML 图表编辑器.
几分钟完成连接
将 OnUML MCP 连接到你的编程智能体。
步骤 01
创建密钥
登录后打开 OnUML API Key 设置。请立即复制密钥，OnUML 不会再次显示完整内容。
步骤 02
粘贴 Token
将命令或个人配置文件中的 YOUR_ONUML_TOKEN_HERE 替换为你的 Token，并确保该配置不会提交到 Git。
步骤 03
添加远程服务器
使用对应客户端的配置，MCP 端点为 https://onuml.com/mcp。
一键连接
codex mcp add onuml --url https://onuml.com/mcp && printf '\n[mcp_servers.onuml.http_headers]\nAuthorization = "Bearer YOUR_ONUML_TOKEN_HERE"\n' >> "$HOME/.codex/config.toml"运行前，请将 YOUR_ONUML_TOKEN_HERE 替换为你的 API Key。
Codex
config.tomlREMOTE MCP
[mcp_servers.onuml]
url = "https://onuml.com/mcp"
http_headers = { Authorization = "Bearer YOUR_ONUML_TOKEN_HERE" }带着上下文写入
每次修改都可追溯、可恢复。
智能体会先读取最新图表再修改。如果其他人已经更新了图表，OnUML 会阻止本次操作，避免覆盖对方的工作。
访问范围跟随当前权限
智能体只能看到你的 OnUML 账户当前有权访问的工作区和项目。
网络重试不会产生重复内容
当请求因网络问题重试时，OnUML 会避免重复创建同一个项目或图表。
更新不会覆盖较新的工作
如果图表已被他人修改，智能体需要重新读取最新内容，不会直接覆盖新版本。
常见问题
OnUML MCP 服务器常见问题
智能体可以操作哪些图表类型？
智能体可以读取和更新 Mermaid、PlantUML 与 OnUML 思维导图。MCP 暂不支持 Draw.io 图表。
API Key 被撤销或过期后会怎样？
客户端会立即失去访问权限。请在 API Key 设置中创建替代密钥，并替换客户端配置中的 Token。
智能体可以访问哪些工作区？
只能访问你的 OnUML 账户当前有权限查看的工作区和项目；账户权限变化后，MCP 的访问权限也会同步变化。
准备好让智能体获得图表上下文了吗？
创建密钥、连接一个客户端，然后从 list_workspaces 开始。