OpenCharts MCP

官方

将你的AI代理接入OpenCharts——在Claude Code、Codex或Cursor中构建电子表格、看板、音乐和自动化流程，无需离开终端。

GitHub

你可以用 Open Charts MCP 做什么？

创建和管理项目 — 使用 create_flowchart、create_whiteboard、create_notes 和 create_presentation 等工具构建流程图、白板、笔记和演示文稿。
处理电子表格 — 通过 inspect_sheet、get_sheet、create_sheet、update_sheet 和 edit_sheet 检查、读取、创建和编辑支持公式的 Theo Sheets。
构建并运行自动化 — 使用 build_agent、create_agent、configure_agent_trigger 和 run_agent 创建、配置、激活和运行 Theo Agents。
管理看板 — 通过 create_board、add_board_card、update_board_card 和 list_board_cards 创建看板、添加和更新卡片以及管理列表。
生成网站和歌曲 — 使用 generate_code_canvas 构建完整的网站或应用，通过 create_song 创作音乐，然后使用 get_code_canvas_status 和 get_song_status 轮询状态。
检查账户和积分 — 使用 whoami 验证连接，并通过 get_credits 监控 AI 积分使用情况。

文档

OpenCharts MCP 服务器

直接从您的 AI 客户端中，在 OpenCharts 内构建流程图、笔记、幻灯片、表格、看板、站点、智能体和歌曲。

网站 · 文档 · 获取 API 密钥 · 问题反馈

这是什么？

OpenCharts 运行着一个公共的、托管的模型上下文协议 (MCP) 服务器，它将整个 OpenCharts 产品置于任何兼容 MCP 的 AI 客户端中。只需使用 API 密钥连接一次，您的助手就能代表您构建和管理真实的 OpenCharts 项目——流程图、白板、笔记、演示文稿、电子表格 (Theo Sheets)、看板 + 日历板、完整的网站和应用 (Code Canvas)、自动化 (Theo Agents) 以及歌曲 (Theo Symphony)——所有这些都由 OpenCharts 的 AI Theo 提供支持。

它是一个基于可流式 HTTP 的远程服务器——无需在本地安装或运行任何东西。将您的客户端指向端点，粘贴您的 API 密钥，即可开始使用。

此仓库是该服务器的公共文档。服务器本身由 OpenCharts 托管；您无需自行运行。

想在一分钟内完成连接？请使用 opencharts.com/help/mcp-server 上的应用内指南，或 opencharts.com/theo-agents/mcp 上的设置页面。

快速开始

在 opencharts.com/theo-agents/mcp 创建一个 API 密钥。请立即复制——完整密钥仅显示一次。
将服务器添加到您的 AI 客户端，使用下方匹配的配置片段，并将 {{YOUR_API_KEY}} 替换为您的密钥。
验证连接：让您的助手调用 whoami 工具——它应返回您的 OpenCharts 账户信息。

端点

https://www.opencharts.com/api/mcp

传输方式： 可流式 HTTP (POST)
认证： Authorization: Bearer <API key>（来自活跃 OpenCharts 会话的 JWT 同样有效）

⚠️ 请始终使用 www. 主机。 顶级域名 opencharts.com 会发出 307 重定向，这会剥离 Authorization 头部并破坏认证。请严格使用 https://www.opencharts.com/api/mcp。

连接您的 AI 客户端

该服务器适用于任何兼容 MCP 的客户端。复制匹配的代码片段并替换为您的 API 密钥。想让您的助手来配置？帮助页面为下列每个客户端都提供了一键粘贴的“AI 设置提示”。

Warp

{
  "mcpServers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "opencharts": {
      "type": "streamable-http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "opencharts": {
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

VS Code (GitHub Copilot)

添加到 .vscode/mcp.json：

{
  "servers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:opencharts-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "opencharts-key",
      "type": "promptString",
      "description": "OpenCharts API key",
      "password": true
    }
  ]
}

Windsurf (Codeium)

{
  "mcpServers": {
    "opencharts": {
      "serverUrl": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http opencharts https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Codex (OpenAI)

codex mcp add opencharts --url https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Amp

在 VS Code 扩展 settings.json 中：

"amp.mcpServers": {
  "opencharts": {
    "url": "https://www.opencharts.com/api/mcp",
    "headers": {
      "Authorization": "Bearer {{YOUR_API_KEY}}"
    }
  }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencharts": {
      "type": "remote",
      "url": "https://www.opencharts.com/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

工具

该服务器提供 56 个工具，分为 10 个组。使用 Theo AI 或生成功能的工具会消耗 AI 额度。

项目

工具	描述
`list_projects`	使用分页和筛选器列出您的项目
`get_project`	通过 ID 获取完整的项目数据
`create_flowchart`	创建一个包含节点和边的流程图项目
`create_whiteboard`	创建一个包含原生形状和元素的白板
`create_notes`	从 Markdown 创建一个笔记项目
`create_presentation`	从大纲创建一个幻灯片演示文稿
`update_project`	更新元数据或内容（笔记、流程图、白板或演示文稿）
`delete_project`	软删除一个项目（30 天内可恢复）

Code Canvas

工具	描述
`generate_code_canvas`	根据描述构建一个完整的网站或应用（HTML/React）——返回一个用于轮询的作业
`get_code_canvas_status`	轮询 Code Canvas 构建作业；准备就绪时返回项目及打开 URL

AI

工具	描述
`ask_theo`	发送单轮 AI 消息（快速或思考模式）
`extract_flowchart`	从上传的文档（PDF、图片、PPTX）中提取流程图

Theo Agents

工具	描述
`build_agent`	根据描述构建一个 Theo Agent——在后台运行，准备就绪时通知您
`get_agent_build_status`	可选轮询 `build_agent` 作业；完成后返回智能体及打开 URL
`create_agent`	从结构化步骤和触发器确定性地创建一个 Theo Agent
`update_agent`	修补智能体的名称、描述或步骤列表
`configure_agent_trigger`	设置智能体的触发器（手动、计划、Webhook、事件、Telegram）
`activate_agent`	激活一个智能体（为首次计划运行提供种子）
`deactivate_agent`	停用一个智能体，使其触发器停止触发
`delete_agent`	软删除一个智能体（30 天内可恢复）
`list_agents`	列出您的 Theo Agents，包含状态和步骤计数
`get_agent`	获取智能体的完整定义（触发器 + 有序步骤）
`run_agent`	立即调度一个智能体——在后台运行，完成时通知您
`list_agent_runs`	列出一个智能体最近的执行运行记录
`get_agent_run_status`	获取单次运行的状态及每个节点的进度

Theo Sheets

工具	描述
`list_sheets`	列出您的 Theo Sheets 电子表格项目
`inspect_sheet`	检查一个表格——每个标签页的维度、标题行、采样单元格和公式、布局
`get_sheet`	将工作表提取为结构化的行（标题 + 数据行）
`read_sheet_range`	读取精确的 A1 范围的值（及可选的公式），以网格和 CSV 格式返回
`create_sheet`	从标题和行创建一个实时电子表格（Excel 级别的网格 + 公式）
`update_sheet`	通过应用结构化的电子表格编辑操作来编辑表格——保存为可回滚的提交
`apply_sheet_ops`	应用结构化的电子表格编辑操作——或提出一个合并门控的更改
`edit_sheet`	使用自然语言指令编辑表格（Theo 规划并应用操作）
`list_sheet_commits`	列出表格的 Git 风格更改提交（已应用/已提议/已合并）
`diff_sheet_commit`	显示提交或提议的单元格级差异
`resolve_sheet_proposal`	合并或拒绝待处理的更改提议
`rollback_sheet`	将实时表格回滚到先前的提交（可逆）

看板

工具	描述
`create_board`	创建一个看板 + 日历项目板
`list_boards`	列出您的项目看板
`get_board`	获取看板的列表（列）和卡片
`update_board`	更新看板的名称、描述或列表列
`delete_board`	软删除一个看板（可恢复）
`duplicate_board`	复制一个看板及其列表、规则和卡片
`add_board_card`	向看板添加一张卡片（帖子/任务/想法/事件）
`list_board_cards`	列出一个看板的卡片，可按计划范围筛选
`update_board_card`	编辑一张卡片——移动列表、重新安排、更改状态/颜色
`delete_board_card`	从看板中软删除一张卡片

Theo Symphony

工具	描述
`create_song`	使用 Theo Symphony 生成一首歌曲——返回一个用于轮询的作业
`get_song_status`	轮询歌曲作业；完成后返回音频和封面艺术版本

笔记

工具	描述
`get_note_content`	将笔记内容提取为 Markdown
`append_to_note`	将 Markdown 内容追加到现有笔记
`clip_to_note`	将网页内容（URL + HTML）作为剪辑保存到笔记中

模板

工具	描述
`list_templates`	浏览模板库
`use_template`	从模板创建新项目

账户

工具	描述
`whoami`	获取已认证用户的个人资料信息
`get_credits`	检查剩余的 AI 额度余额

资源

资源提供 AI 客户端无需调用工具即可检索的只读上下文。

资源	描述
`projects`	您最近项目的分页列表
`project`	通过 ID 获取单个项目的完整数据
`templates`	可浏览的模板目录

工作原理

┌────────────────────┐   Streamable HTTP    ┌────────────────────────────┐
│   Your AI client    │   + Bearer API key   │   OpenCharts MCP (hosted)  │
│  Warp · Claude ·    │ ───────────────────► │                            │
│  Cursor · VS Code · │                      │  Projects · Code Canvas ·  │
│  Windsurf · Codex · │ ◄─────────────────── │  Agents · Sheets · Boards ·│
│  Amp · OpenCode     │      tool results    │  Symphony · Notes · AI     │
└────────────────────┘                      └────────────────────────────┘

每个请求都通过您的 API 密钥进行认证，并作用于您自己的 OpenCharts 账户。由于服务器是托管的，工具界面会自动保持最新——无需客户端更新。使用 Theo AI 或生成功能的工具（例如 ask_theo、extract_flowchart、generate_code_canvas、build_agent、create_song）会消耗您套餐中的 AI 额度。

速率限制与额度

每位用户每分钟 120 个请求。
AI 和生成工具会消耗 AI 额度——随时使用 get_credits 工具检查您的余额。

发现与注册表

为客户端、爬虫和注册表发布了机器可读的元数据（不含机密信息）：

https://www.opencharts.com/.well-known/mcp — 发现清单
https://www.opencharts.com/.well-known/mcp/server-card.json — 服务器卡片
https://www.opencharts.com/.well-known/oauth-protected-resource — 受保护资源元数据
文档：opencharts.com/help/mcp-server

故障排除

307 重定向 / "无授权支持" / 401 — 确保 URL 严格为 https://www.opencharts.com/api/mcp（带有 www.）。顶级主机在重定向时会剥离 Authorization 头部。同时确认您的密钥处于活动状态，并带有 Bearer 前缀发送。
429 Too Many Requests — 您已达到每分钟 120 个请求的限制；请等待并重试。
客户端中缺少工具 — 完全重启客户端（或关闭/开启 OpenCharts 服务器），以便其重新获取工具列表。确认您的密钥包含 read、write 和 ai 作用域（默认密钥包含所有三个）。
会话中途 JWT 过期 — 会话 JWT 大约 15 分钟后过期；对于长时间运行的集成，请使用持久的 API 密钥。

兼容的客户端

适用于任何支持模型上下文协议的客户端，包括：

Warp — 智能开发环境
Claude Desktop 和 Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

链接

🌐 网站：opencharts.com
📖 MCP 文档：opencharts.com/help/mcp-server
🔑 获取 API 密钥：opencharts.com/theo-agents/mcp
💬 社区：opencharts.com/community
🐛 问题反馈：GitHub Issues

许可证

本文档采用 CC-BY-4.0 许可。OpenCharts MCP 服务器是一个托管产品——有关条款和定价，请参阅 opencharts.com。