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

Dùng thử MCP nàyĐược tài trợ

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

Tạo sơ đồ, bảng trắng, ghi chú và bài thuyết trình — tạo các dự án có cấu trúc trực tiếp thông qua create_flowchart, create_whiteboard, create_notes hoặc create_presentation.
Xây dựng toàn bộ trang web hoặc ứng dụng từ mô tả — sử dụng generate_code_canvas để bắt đầu xây dựng Code Canvas, sau đó thăm dò get_code_canvas_status để lấy kết quả.
Quản lý Theo Agents từ đầu đến cuối — tạo, cấu hình trigger, kích hoạt, chạy và giám sát các agent bằng các công cụ như build_agent, configure_agent_trigger, run_agent và get_agent_run_status.
Làm việc với bảng tính trực tiếp (Theo Sheets) — tạo, kiểm tra, đọc phạm vi, áp dụng chỉnh sửa có cấu trúc và hoàn tác thay đổi bằng cách sử dụng create_sheet, read_sheet_range, apply_sheet_ops và rollback_sheet.
Tạo hình ảnh và video trực tiếp — gọi generate_image để lấy URL công khai ngay lập tức hoặc generate_video và thăm dò get_video_status để lấy các clip đã hoàn thành.
Kiểm tra tài khoản và số dư tín dụng AI của bạn — xác minh kết nối của bạn bằng whoami và theo dõi mức sử dụng qua 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, hình ảnh & video 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 bằng 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 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), bài hát (Theo Symphony), và hình ảnh & video (Theo Media) — tất cả được hỗ trợ bởi Theo, AI của OpenCharts. Khi xây dựng trang web hoặc ứng dụng, trợ lý của bạn có thể tạo hình ảnh và video clip thực tế trực tiếp và thả các URL trả về thẳng vào mã thay vì để lại placeholder.

Đâ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 đ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 làm mất 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" 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ị 59 công cụ trên 11 nhóm. Các công cụ sử dụng Theo AI hoặc tạo sinh tiêu tốn 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 (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)

Theo Agents

Công cụ	Mô tả
`build_agent`	Xây dựng một Theo Agent 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 Theo Agent xác định từ các bước có cấu trúc + 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 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 để ngừng kích hoạt
`delete_agent`	Xóa mềm tác nhân (khôi phục trong 30 ngày)
`list_agents`	Liệt kê các Theo Agent 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 (kích hoạt + các bước có 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 thành
`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 độ 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 commit 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 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 commit 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 commit hoặc đề xuất
`resolve_sheet_proposal`	Hợp nhất hoặc từ chối đề xuất thay đổi đang chờ xử lý
`rollback_sheet`	Quay lại bảng tính trực tiếp về commit 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 bảng (có thể khôi phục)
`duplicate_board`	Nhân bản 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ê 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 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ề 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

Theo Media

Công cụ	Mô tả
`generate_image`	Tạo hình ảnh từ lời nhắc — trả về URL công khai để nhúng hoặc lưu (sử dụng thay vì placeholder)
`generate_video`	Tạo video clip ngắn từ lời nhắc — trả về công việc để thăm dò
`get_video_status`	Thăm dò công việc video; trả về URL clip hoàn chỉnh khi hoàn tất

Ghi chú

Công cụ	Mô tả
`get_note_content`	Trích xuất nội dung 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 clip 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ẫu

Tài khoản

Công cụ	Mô tả
`whoami`	Lấy thông tin hồ sơ 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 tài khoản OpenCharts của chính 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, generate_image, generate_video) tiêu tốn 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 tốn 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 và cơ quan đă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 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 bật/tắ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à sản phẩm được lưu trữ — xem opencharts.com để biết điều khoản và giá cả.