OpenCharts MCP

官方

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

GitHub

试用此 MCP赞助

你可以用 OpenCharts MCP 做什么？

创建流程图、白板、笔记和演示文稿 — 通过 create_flowchart、create_whiteboard、create_notes 或 create_presentation 直接生成结构化项目。
根据描述构建完整网站或应用 — 使用 generate_code_canvas 启动 Code Canvas 构建，然后轮询 get_code_canvas_status 获取结果。
端到端管理 Theo Agents — 使用 build_agent、configure_agent_trigger、run_agent 和 get_agent_run_status 等工具创建、配置触发器、激活、运行和监控代理。
处理实时电子表格（Theo Sheets） — 使用 create_sheet、read_sheet_range、apply_sheet_ops 和 rollback_sheet 创建、检查、读取范围、应用结构化编辑并回滚更改。
内联生成图像和视频 — 调用 generate_image 获取即时公共 URL，或调用 generate_video 并轮询 get_video_status 获取完成的剪辑。
检查账户和 AI 积分余额 — 使用 whoami 验证连接，并通过 get_credits 监控使用情况。

文档

OpenCharts MCP 服务器

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

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

这是什么？

OpenCharts 运行着一个公共的、托管的模型上下文协议 (MCP) 服务器，它将整个 OpenCharts 产品置于任何兼容 MCP 的 AI 客户端中。只需使用 API 密钥连接一次，您的助手就可以代表您构建和管理真实的 OpenCharts 项目——流程图、白板、笔记、演示文稿、电子表格 (Theo Sheets)、看板 + 日历板、完整的网站和应用 (Code Canvas)、自动化 (Theo Agents)、歌曲 (Theo Symphony) 以及图像和视频 (Theo Media)——所有这些都由 OpenCharts 的 AI Theo 提供支持。在构建站点或应用时，您的助手可以内联生成真实的图像和视频片段，并将返回的 URL 直接放入代码中，而不是留下占位符。

它是一个基于可流式 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}}"
      }
    }
  }
}

工具

该服务器在 11 个组中公开了 59 个工具。使用 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`	轮询一个歌曲作业；完成后返回音频 + 封面艺术版本

Theo Media

工具	描述
`generate_image`	根据提示生成一张图像——返回一个可嵌入或保存的公共 URL（用于替代占位符）
`generate_video`	根据提示生成一个短视频片段——返回一个待轮询的作业
`get_video_status`	轮询一个视频作业；完成后返回完成的片段 URL

笔记

工具	描述
`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、generate_image、generate_video）会消耗您套餐中的 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 了解条款和定价。