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}}"
      }
    }
  }
}

工具

伺服器在 10 個群組中公開了 56 個工具。使用 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`	輪詢歌曲作業；完成時傳回音訊 + 封面藝術版本

筆記

工具	說明
`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 — 請確保網址精確為 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 了解條款和定價。