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 取得公開網址，或使用 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 提供支援。在建置網站或應用程式時，您的助理可以內嵌生成真實的圖片和影片片段，並將返回的網址直接放入程式碼中，而不是留下佔位符。

這是一個透過可串流 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 建置作業；完成時返回專案和開啟網址

AI

工具	說明
`ask_theo`	傳送單輪 AI 訊息（快速或思考模式）
`extract_flowchart`	從上傳的文件（PDF、圖片、PPTX）中擷取流程圖

Theo Agents

工具	說明
`build_agent`	從描述建立 Theo Agent——在背景執行，完成時通知您
`get_agent_build_status`	選擇性輪詢 `build_agent` 工作；完成時返回代理程式和開啟網址
`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`	從提示生成圖片——返回可嵌入或儲存的公開網址（用於取代佔位符）
`generate_video`	從提示生成短影片片段——返回一個待輪詢的工作
`get_video_status`	輪詢影片工作；完成時返回最終的片段網址

筆記

工具	說明
`get_note_content`	將筆記內容擷取為 Markdown
`append_to_note`	將 Markdown 內容附加到現有筆記
`clip_to_note`	將網頁內容（網址和 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 — 請確保網址精確為 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 了解條款和定價。