OpenCharts MCP

resmi

Hubungkan agen AI Anda ke OpenCharts—buat spreadsheet, papan, musik, dan otomatisasi dari Claude Code, Codex, atau Cursor tanpa meninggalkan terminal Anda.

GitHub

Apa yang bisa Anda lakukan dengan Open Charts MCP?

Membuat dan mengelola proyek — Bangun diagram alir, papan tulis, catatan, presentasi, dan lainnya menggunakan alat seperti create_flowchart, create_whiteboard, create_notes, dan create_presentation.
Bekerja dengan spreadsheet — Periksa, baca, buat, dan edit Theo Sheets dengan dukungan rumus menggunakan inspect_sheet, get_sheet, create_sheet, update_sheet, dan edit_sheet.
Membangun dan menjalankan otomatisasi — Buat, konfigurasi, aktifkan, dan jalankan Theo Agents dengan build_agent, create_agent, configure_agent_trigger, dan run_agent.
Mengelola papan Kanban — Buat papan, tambah dan perbarui kartu, serta kelola daftar dengan create_board, add_board_card, update_board_card, dan list_board_cards.
Menghasilkan situs web dan lagu — Bangun situs web atau aplikasi lengkap dengan generate_code_canvas dan buat musik dengan create_song, lalu periksa status dengan get_code_canvas_status dan get_song_status.
Periksa akun dan kredit — Verifikasi koneksi Anda dengan whoami dan pantau penggunaan kredit AI dengan get_credits.

Dokumentasi

Server MCP OpenCharts

Bangun diagram alir, catatan, slide, sheet, papan, situs, agen & lagu di OpenCharts — langsung dari klien AI Anda.

Situs Web · Dokumentasi · Dapatkan kunci API · Masalah

Apa ini?

OpenCharts menjalankan server Model Context Protocol (MCP) publik yang dihosting yang menempatkan seluruh produk OpenCharts di dalam klien AI yang kompatibel dengan MCP. Hubungkan sekali dengan kunci API dan asisten Anda dapat membangun serta mengelola proyek OpenCharts nyata atas nama Anda — diagram alir, papan tulis, catatan, presentasi, spreadsheet (Theo Sheets), papan Kanban + kalender, situs web & aplikasi lengkap (Code Canvas), otomatisasi (Theo Agents), dan lagu (Theo Symphony) — semuanya didukung oleh Theo, AI OpenCharts.

Ini adalah server jarak jauh melalui HTTP Streamable — tidak ada yang perlu diinstal atau dijalankan secara lokal. Arahkan klien Anda ke endpoint, tempelkan kunci API Anda, dan mulai.

Repositori ini adalah dokumentasi publik untuk server tersebut. Server itu sendiri dihosting oleh OpenCharts; Anda tidak menjalankannya sendiri.

Ingin terhubung dalam waktu kurang dari satu menit? Gunakan panduan dalam aplikasi di opencharts.com/help/mcp-server atau halaman pengaturan di opencharts.com/theo-agents/mcp.

Mulai cepat

Buat kunci API di opencharts.com/theo-agents/mcp. Salin segera — kunci lengkap hanya ditampilkan sekali.
Tambahkan server ke klien AI Anda menggunakan cuplikan konfigurasi yang cocok di bawah, ganti {{YOUR_API_KEY}} dengan kunci Anda.
Verifikasi koneksi dengan meminta asisten Anda memanggil alat whoami — seharusnya mengembalikan akun OpenCharts Anda.

Endpoint

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

Transport: HTTP Streamable (POST)
Auth: Authorization: Bearer <API key> (JWT dari sesi OpenCharts yang aktif juga berfungsi)

⚠️ Selalu gunakan host www.. Host apex opencharts.com mengeluarkan pengalihan 307 yang menghapus header Authorization dan merusak autentikasi. Gunakan https://www.opencharts.com/api/mcp persis.

Hubungkan klien AI Anda

Server bekerja dengan klien apa pun yang kompatibel dengan MCP. Salin cuplikan yang cocok dan tukar dengan kunci API Anda. Lebih suka membiarkan asisten Anda yang menyambungkannya? Halaman bantuan memiliki "prompt pengaturan AI" sekali tempel untuk setiap klien di bawah.

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)

Tambahkan ke .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

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

Alat

Server mengekspos 56 alat di 10 grup. Alat yang menggunakan Theo AI atau generasi mengonsumsi kredit AI.

Proyek

Alat	Deskripsi
`list_projects`	Daftar proyek Anda dengan paginasi dan filter
`get_project`	Dapatkan data proyek lengkap berdasarkan ID
`create_flowchart`	Buat proyek diagram alir dengan node dan edge
`create_whiteboard`	Buat papan tulis dengan bentuk dan elemen asli
`create_notes`	Buat proyek catatan dari Markdown
`create_presentation`	Buat dek slide dari kerangka
`update_project`	Perbarui metadata atau konten (catatan, diagram alir, papan tulis, atau presentasi)
`delete_project`	Hapus sementara proyek (pemulihan 30 hari)

Code Canvas

Alat	Deskripsi
`generate_code_canvas`	Bangun situs web atau aplikasi lengkap (HTML/React) dari deskripsi — mengembalikan pekerjaan untuk dipolling
`get_code_canvas_status`	Polling build Code Canvas; mengembalikan proyek + URL terbuka saat siap

AI

Alat	Deskripsi
`ask_theo`	Kirim pesan AI sekali jalan (mode cepat atau pikir)
`extract_flowchart`	Ekstrak diagram alir dari dokumen yang diunggah (PDF, gambar, PPTX)

Theo Agents

Alat	Deskripsi
`build_agent`	Bangun Agen Theo dari deskripsi — berjalan di latar belakang, memberi tahu Anda saat siap
`get_agent_build_status`	Polling opsional untuk pekerjaan `build_agent`; mengembalikan agen + URL terbuka saat selesai
`create_agent`	Buat Agen Theo secara deterministik dari langkah terstruktur + pemicu
`update_agent`	Perbaiki nama, deskripsi, atau daftar langkah agen
`configure_agent_trigger`	Atur pemicu agen (manual, jadwal, webhook, acara, telegram)
`activate_agent`	Aktifkan agen (menyemai eksekusi terjadwal pertama)
`deactivate_agent`	Nonaktifkan agen agar pemicu berhenti menyala
`delete_agent`	Hapus sementara agen (pemulihan 30 hari)
`list_agents`	Daftar Agen Theo Anda dengan status + jumlah langkah
`get_agent`	Dapatkan definisi lengkap agen (pemicu + langkah terurut)
`run_agent`	Kirim agen sekarang — berjalan di latar belakang, memberi tahu Anda saat selesai
`list_agent_runs`	Daftar eksekusi terbaru agen
`get_agent_run_status`	Dapatkan status eksekusi tunggal + kemajuan per-node

Theo Sheets

Alat	Deskripsi
`list_sheets`	Daftar proyek spreadsheet Theo Sheets Anda
`inspect_sheet`	Periksa sheet — dimensi per-tab, baris header, sampel sel + rumus, tata letak
`get_sheet`	Ekstrak lembar kerja sebagai baris terstruktur (header + baris data)
`read_sheet_range`	Baca nilai rentang A1 yang tepat (+ rumus opsional) sebagai grid + CSV
`create_sheet`	Buat spreadsheet langsung (grid + rumus tingkat Excel) dari header dan baris
`update_sheet`	Edit sheet dengan menerapkan operasi edit spreadsheet terstruktur — disimpan sebagai komit yang dapat di-rollback
`apply_sheet_ops`	Terapkan operasi edit spreadsheet terstruktur — atau usulkan perubahan dengan merge-gated
`edit_sheet`	Edit sheet dengan instruksi bahasa alami (Theo merencanakan + menerapkan operasi)
`list_sheet_commits`	Daftar komit perubahan gaya-git sheet (diterapkan / diusulkan / digabung)
`diff_sheet_commit`	Tampilkan diff tingkat sel untuk komit atau proposal
`resolve_sheet_proposal`	Gabung atau tolak proposal perubahan yang tertunda
`rollback_sheet`	Kembalikan sheet langsung ke komit sebelumnya (dapat dibalikkan)

Papan

Alat	Deskripsi
`create_board`	Buat papan proyek Kanban + kalender
`list_boards`	Daftar papan proyek Anda
`get_board`	Dapatkan daftar (kolom) dan kartu papan
`update_board`	Perbarui nama, deskripsi, atau kolom daftar papan
`delete_board`	Hapus sementara papan (dapat dipulihkan)
`duplicate_board`	Gandakan papan dengan daftar, aturan, dan kartunya
`add_board_card`	Tambahkan kartu (posting/tugas/ide/acara) ke papan
`list_board_cards`	Daftar kartu papan, opsional berdasarkan rentang jadwal
`update_board_card`	Edit kartu — pindahkan daftar, jadwalkan ulang, ubah status/warna
`delete_board_card`	Hapus sementara kartu dari papan

Theo Symphony

Alat	Deskripsi
`create_song`	Hasilkan lagu dengan Theo Symphony — mengembalikan pekerjaan untuk dipolling
`get_song_status`	Polling pekerjaan lagu; mengembalikan versi audio + sampul saat selesai

Catatan

Alat	Deskripsi
`get_note_content`	Ekstrak konten catatan sebagai Markdown
`append_to_note`	Tambahkan konten Markdown ke catatan yang ada
`clip_to_note`	Simpan konten web (URL + HTML) sebagai klip di dalam catatan

Template

Alat	Deskripsi
`list_templates`	Jelajahi galeri template
`use_template`	Buat proyek baru dari template

Akun

Alat	Deskripsi
`whoami`	Dapatkan informasi profil pengguna yang terautentikasi
`get_credits`	Periksa sisa saldo kredit AI

Sumber Daya

Sumber daya menyediakan konteks hanya-baca yang dapat diambil klien AI tanpa memanggil alat.

Sumber Daya	Deskripsi
`projects`	Daftar terhalaman proyek terbaru Anda
`project`	Data lengkap untuk satu proyek berdasarkan ID
`templates`	Katalog template yang dapat dijelajahi

Cara kerjanya

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

Setiap permintaan diautentikasi oleh kunci API Anda dan bertindak atas akun OpenCharts Anda sendiri. Karena server dihosting, permukaan alat tetap terkini secara otomatis — tidak perlu pembaruan klien. Alat yang menggunakan Theo AI atau generasi (misalnya ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) mengonsumsi kredit AI dari paket Anda.

Batas laju & kredit

120 permintaan per menit per pengguna.
Alat AI dan generasi mengonsumsi kredit AI — periksa saldo Anda kapan saja dengan alat get_credits.

Penemuan & registri

Metadata yang dapat dibaca mesin diterbitkan untuk klien, perayap, dan registri (tanpa rahasia):

https://www.opencharts.com/.well-known/mcp — manifes penemuan
https://www.opencharts.com/.well-known/mcp/server-card.json — kartu server
https://www.opencharts.com/.well-known/oauth-protected-resource — metadata sumber daya yang dilindungi
Dokumen: opencharts.com/help/mcp-server

Pemecahan masalah

Pengalihan 307 / "tidak ada dukungan otorisasi" / 401 — pastikan URL tepat https://www.opencharts.com/api/mcp (dengan www.). Host apex menghapus header Authorization saat pengalihan. Juga konfirmasi kunci Anda aktif dan dikirim dengan awalan Bearer .
429 Too Many Requests — Anda telah mencapai batas 120 req/menit; tunggu dan coba lagi.
Alat hilang di klien Anda — mulai ulang sepenuhnya klien (atau matikan/hidupkan server OpenCharts) sehingga mengambil ulang daftar alat. Konfirmasi kunci Anda membawa cakupan read, write, dan ai (kunci default mencakup ketiganya).
JWT kedaluwarsa di tengah sesi — JWT sesi kedaluwarsa setelah ~15 menit; gunakan kunci API persisten untuk integrasi jangka panjang.

Klien yang kompatibel

Bekerja dengan klien apa pun yang mendukung Model Context Protocol, termasuk:

Warp — lingkungan pengembangan agentik
Claude Desktop & Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Tautan

🌐 Situs Web: opencharts.com
📖 Dokumen MCP: opencharts.com/help/mcp-server
🔑 Dapatkan kunci API: opencharts.com/theo-agents/mcp
💬 Komunitas: opencharts.com/community
🐛 Masalah: GitHub Issues

Lisensi

Dokumentasi ini dilisensikan di bawah CC-BY-4.0. Server MCP OpenCharts adalah produk yang dihosting — lihat opencharts.com untuk ketentuan dan harga.