OpenCharts MCP

chính thức

Kết nối AI agent của bạn với OpenCharts—tạo bảng tính, bảng, nhạc và tự động hóa từ Claude Code, Codex hoặc Cursor mà không cần rời khỏi terminal.

GitHub

Bạn có thể làm gì với Open Charts MCP?

Tạo và quản lý dự án — Xây dựng lưu đồ, bảng trắng, ghi chú, bài thuyết trình, v.v. bằng các công cụ như create_flowchart, create_whiteboard, create_notes, và create_presentation.
Làm việc với bảng tính — Kiểm tra, đọc, tạo và chỉnh sửa Theo Sheets với hỗ trợ công thức bằng cách sử dụng inspect_sheet, get_sheet, create_sheet, update_sheet, và edit_sheet.
Xây dựng và chạy tự động hóa — Tạo, cấu hình, kích hoạt và chạy Theo Agents với build_agent, create_agent, configure_agent_trigger, và run_agent.
Quản lý bảng Kanban — Tạo bảng, thêm và cập nhật thẻ, quản lý danh sách bằng create_board, add_board_card, update_board_card, và list_board_cards.
Tạo trang web và bài hát — Xây dựng trang web hoặc ứng dụng hoàn chỉnh với generate_code_canvas và tạo nhạc với create_song, sau đó kiểm tra trạng thái với get_code_canvas_status và get_song_status.
Kiểm tra tài khoản và tín dụng — Xác minh kết nối của bạn với whoami và theo dõi mức sử dụng tín dụng AI với get_credits.

Tài liệu

Máy chủ OpenCharts MCP

Xây dựng lưu đồ, ghi chú, slide, bảng tính, bảng, trang web, tác nhân & bài hát trong OpenCharts — trực tiếp từ ứng dụng AI của bạn.

Trang web · Tài liệu · Lấy khóa API · Vấn đề

Đây là gì?

OpenCharts chạy một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) công khai, được lưu trữ đặt toàn bộ sản phẩm OpenCharts vào bất kỳ ứng dụng AI tương thích MCP nào. Kết nối một lần với khóa API và trợ lý của bạn có thể xây dựng và quản lý các dự án OpenCharts thực sự thay mặt bạn — lưu đồ, bảng trắng, ghi chú, bài thuyết trình, bảng tính (Theo Sheets), bảng Kanban + lịch, trang web & ứng dụng đầy đủ (Code Canvas), tự động hóa (Theo Agents) và bài hát (Theo Symphony) — tất cả được hỗ trợ bởi Theo, AI của OpenCharts.

Đây là một máy chủ từ xa qua HTTP có thể truyền trực tuyến — không có gì để cài đặt hoặc chạy cục bộ. Trỏ ứng dụng của bạn đến điểm cuối, dán khóa API của bạn và bắt đầu.

Kho lưu trữ này là tài liệu công khai cho máy chủ đó. Bản thân máy chủ được lưu trữ bởi OpenCharts; bạn không tự chạy nó.

Muốn kết nối trong vòng chưa đầy một phút? Sử dụng hướng dẫn trong ứng dụng tại opencharts.com/help/mcp-server hoặc trang thiết lập tại opencharts.com/theo-agents/mcp.

Bắt đầu nhanh

Tạo khóa API tại opencharts.com/theo-agents/mcp. Sao chép ngay lập tức — khóa đầy đủ chỉ được hiển thị một lần.
Thêm máy chủ vào ứng dụng AI của bạn bằng cách sử dụng đoạn cấu hình phù hợp bên dưới, thay thế {{YOUR_API_KEY}} bằng khóa của bạn.
Xác minh kết nối bằng cách yêu cầu trợ lý của bạn gọi công cụ whoami — nó sẽ trả về tài khoản OpenCharts của bạn.

Điểm cuối

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

Phương thức truyền tải: HTTP có thể truyền trực tuyến (POST)
Xác thực: Authorization: Bearer <API key> (JWT từ phiên OpenCharts đang hoạt động cũng hoạt động)

⚠️ Luôn sử dụng máy chủ www.. Máy chủ gốc opencharts.com phát hành chuyển hướng 307, loại bỏ tiêu đề Authorization và phá vỡ xác thực. Sử dụng chính xác https://www.opencharts.com/api/mcp.

Kết nối ứng dụng AI của bạn

Máy chủ hoạt động với bất kỳ ứng dụng tương thích MCP nào. Sao chép đoạn mã phù hợp và thay thế bằng khóa API của bạn. Muốn để trợ lý của bạn thiết lập? Trang trợ giúp có "lời nhắc thiết lập AI" chỉ cần dán một lần cho mọi ứng dụng bên dưới.

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)

Thêm vào .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

Trong tiện ích mở rộng 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}}"
      }
    }
  }
}

Công cụ

Máy chủ hiển thị 56 công cụ trên 10 nhóm. Các công cụ sử dụng Theo AI hoặc tạo sinh tiêu thụ tín dụng AI.

Dự án

Công cụ	Mô tả
`list_projects`	Liệt kê các dự án của bạn với phân trang và bộ lọc
`get_project`	Lấy dữ liệu dự án đầy đủ theo ID
`create_flowchart`	Tạo dự án lưu đồ với các nút và cạnh
`create_whiteboard`	Tạo bảng trắng với các hình dạng và phần tử gốc
`create_notes`	Tạo dự án ghi chú từ Markdown
`create_presentation`	Tạo bộ slide từ dàn ý
`update_project`	Cập nhật siêu dữ liệu hoặc nội dung (ghi chú, lưu đồ, bảng trắng hoặc bài thuyết trình)
`delete_project`	Xóa mềm một dự án (có thể khôi phục trong 30 ngày)

Code Canvas

Công cụ	Mô tả
`generate_code_canvas`	Xây dựng trang web hoặc ứng dụng đầy đủ (HTML/React) từ mô tả — trả về một công việc để thăm dò
`get_code_canvas_status`	Thăm dò bản dựng Code Canvas; trả về dự án + URL mở khi sẵn sàng

AI

Công cụ	Mô tả
`ask_theo`	Gửi tin nhắn AI một lượt (chế độ nhanh hoặc suy nghĩ)
`extract_flowchart`	Trích xuất lưu đồ từ tài liệu đã tải lên (PDF, hình ảnh, PPTX)

Tác nhân Theo

Công cụ	Mô tả
`build_agent`	Xây dựng Tác nhân Theo từ mô tả — chạy nền, thông báo khi sẵn sàng
`get_agent_build_status`	Thăm dò tùy chọn cho công việc `build_agent`; trả về tác nhân + URL mở khi hoàn tất
`create_agent`	Tạo Tác nhân Theo một cách xác định từ các bước có cấu trúc + trình kích hoạt
`update_agent`	Vá tên, mô tả hoặc danh sách bước của tác nhân
`configure_agent_trigger`	Đặt trình kích hoạt của tác nhân (thủ công, lịch trình, webhook, sự kiện, telegram)
`activate_agent`	Kích hoạt tác nhân (gieo lần chạy theo lịch đầu tiên)
`deactivate_agent`	Hủy kích hoạt tác nhân để trình kích hoạt ngừng kích hoạt
`delete_agent`	Xóa mềm một tác nhân (có thể khôi phục trong 30 ngày)
`list_agents`	Liệt kê các Tác nhân Theo của bạn với trạng thái + số bước
`get_agent`	Lấy định nghĩa đầy đủ của tác nhân (trình kích hoạt + các bước theo thứ tự)
`run_agent`	Điều phối tác nhân ngay bây giờ — chạy nền, thông báo khi hoàn tất
`list_agent_runs`	Liệt kê các lần chạy thực thi gần đây của tác nhân
`get_agent_run_status`	Lấy trạng thái của một lần chạy + tiến trình từng nút

Theo Sheets

Công cụ	Mô tả
`list_sheets`	Liệt kê các dự án bảng tính Theo Sheets của bạn
`inspect_sheet`	Kiểm tra một bảng tính — kích thước từng tab, hàng tiêu đề, ô mẫu + công thức, bố cục
`get_sheet`	Trích xuất một trang tính dưới dạng các hàng có cấu trúc (tiêu đề + hàng dữ liệu)
`read_sheet_range`	Đọc giá trị của một phạm vi A1 chính xác (+ công thức tùy chọn) dưới dạng lưới + CSV
`create_sheet`	Tạo bảng tính trực tiếp (lưới cấp Excel + công thức) từ tiêu đề và hàng
`update_sheet`	Chỉnh sửa bảng tính bằng cách áp dụng các thao tác chỉnh sửa bảng tính có cấu trúc — được lưu dưới dạng một cam kết có thể hoàn tác
`apply_sheet_ops`	Áp dụng các thao tác chỉnh sửa bảng tính có cấu trúc — hoặc đề xuất một thay đổi có kiểm soát hợp nhất
`edit_sheet`	Chỉnh sửa bảng tính bằng hướng dẫn ngôn ngữ tự nhiên (Theo lập kế hoạch + áp dụng thao tác)
`list_sheet_commits`	Liệt kê các cam kết thay đổi kiểu git của bảng tính (đã áp dụng / đề xuất / đã hợp nhất)
`diff_sheet_commit`	Hiển thị sự khác biệt cấp ô cho một cam kết hoặc đề xuất
`resolve_sheet_proposal`	Hợp nhất hoặc từ chối một đề xuất thay đổi đang chờ xử lý
`rollback_sheet`	Hoàn nguyên bảng tính trực tiếp về một cam kết trước đó (có thể đảo ngược)

Bảng

Công cụ	Mô tả
`create_board`	Tạo bảng dự án Kanban + lịch
`list_boards`	Liệt kê các bảng dự án của bạn
`get_board`	Lấy danh sách (cột) và thẻ của bảng
`update_board`	Cập nhật tên, mô tả hoặc cột danh sách của bảng
`delete_board`	Xóa mềm một bảng (có thể khôi phục)
`duplicate_board`	Nhân bản một bảng với danh sách, quy tắc và thẻ của nó
`add_board_card`	Thêm thẻ (bài đăng/nhiệm vụ/ý tưởng/sự kiện) vào bảng
`list_board_cards`	Liệt kê các thẻ của bảng, tùy chọn theo phạm vi lịch trình
`update_board_card`	Chỉnh sửa thẻ — di chuyển danh sách, lên lịch lại, thay đổi trạng thái/màu sắc
`delete_board_card`	Xóa mềm một thẻ khỏi bảng

Theo Symphony

Công cụ	Mô tả
`create_song`	Tạo bài hát với Theo Symphony — trả về một công việc để thăm dò
`get_song_status`	Thăm dò công việc bài hát; trả về các phiên bản âm thanh + ảnh bìa khi hoàn tất

Ghi chú

Công cụ	Mô tả
`get_note_content`	Trích xuất nội dung của ghi chú dưới dạng Markdown
`append_to_note`	Thêm nội dung Markdown vào ghi chú hiện có
`clip_to_note`	Lưu nội dung web (URL + HTML) dưới dạng một đoạn cắt bên trong ghi chú

Mẫu

Công cụ	Mô tả
`list_templates`	Duyệt thư viện mẫu
`use_template`	Tạo dự án mới từ một mẫu

Tài khoản

Công cụ	Mô tả
`whoami`	Lấy thông tin hồ sơ của người dùng đã xác thực
`get_credits`	Kiểm tra số dư tín dụng AI còn lại

Tài nguyên

Tài nguyên cung cấp ngữ cảnh chỉ đọc mà ứng dụng AI có thể truy xuất mà không cần gọi công cụ.

Tài nguyên	Mô tả
`projects`	Danh sách phân trang các dự án gần đây của bạn
`project`	Dữ liệu đầy đủ cho một dự án theo ID
`templates`	Danh mục mẫu có thể duyệt

Cách thức hoạt động

┌────────────────────┐   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     │
└────────────────────┘                      └────────────────────────────┘

Mọi yêu cầu được xác thực bằng khóa API của bạn và hành động trên chính tài khoản OpenCharts của bạn. Vì máy chủ được lưu trữ, bề mặt công cụ luôn được cập nhật tự động — không cần cập nhật ứng dụng. Các công cụ sử dụng Theo AI hoặc tạo sinh (ví dụ: ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) tiêu thụ tín dụng AI từ gói của bạn.

Giới hạn tốc độ & tín dụng

120 yêu cầu mỗi phút cho mỗi người dùng.
Các công cụ AI và tạo sinh tiêu thụ tín dụng AI — kiểm tra số dư của bạn bất cứ lúc nào bằng công cụ get_credits.

Khám phá & đăng ký

Siêu dữ liệu có thể đọc bằng máy được công bố cho ứng dụng, trình thu thập dữ liệu và sổ đăng ký (không có bí mật):

https://www.opencharts.com/.well-known/mcp — tệp kê khai khám phá
https://www.opencharts.com/.well-known/mcp/server-card.json — thẻ máy chủ
https://www.opencharts.com/.well-known/oauth-protected-resource — siêu dữ liệu tài nguyên được bảo vệ
Tài liệu: opencharts.com/help/mcp-server

Khắc phục sự cố

Chuyển hướng 307 / "không hỗ trợ ủy quyền" / 401 — đảm bảo URL chính xác là https://www.opencharts.com/api/mcp (với www.). Máy chủ gốc loại bỏ tiêu đề Authorization khi chuyển hướng. Cũng xác nhận khóa của bạn đang hoạt động và được gửi với tiền tố Bearer .
429 Too Many Requests — bạn đã đạt đến giới hạn 120 yêu cầu/phút; chờ và thử lại.
Thiếu công cụ trong ứng dụng của bạn — khởi động lại hoàn toàn ứng dụng (hoặc tắt/bật máy chủ OpenCharts) để nó tìm nạp lại danh sách công cụ. Xác nhận khóa của bạn mang các phạm vi read, write và ai (khóa mặc định bao gồm cả ba).
JWT hết hạn giữa phiên — JWT phiên hết hạn sau ~15 phút; sử dụng khóa API cố định cho các tích hợp chạy dài.

Ứng dụng tương thích

Hoạt động với bất kỳ ứng dụng nào hỗ trợ Giao thức Ngữ cảnh Mô hình, bao gồm:

Warp — môi trường phát triển tác nhân
Claude Desktop & Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Liên kết

🌐 Trang web: opencharts.com
📖 Tài liệu MCP: opencharts.com/help/mcp-server
🔑 Lấy khóa API: opencharts.com/theo-agents/mcp
💬 Cộng đồng: opencharts.com/community
🐛 Vấn đề: GitHub Issues

Giấy phép

Tài liệu này được cấp phép theo CC-BY-4.0. Máy chủ OpenCharts MCP là một sản phẩm được lưu trữ — xem opencharts.com để biết điều khoản và giá cả.