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

Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan OpenCharts MCP?

Buat diagram alir, papan tulis, catatan, dan presentasi — hasilkan proyek terstruktur secara langsung melalui create_flowchart, create_whiteboard, create_notes, atau create_presentation.
Bangun situs web atau aplikasi lengkap dari deskripsi — gunakan generate_code_canvas untuk memulai pembuatan Code Canvas, lalu polling get_code_canvas_status untuk hasilnya.
Kelola Theo Agents secara end-to-end — buat, konfigurasi pemicu, aktifkan, jalankan, dan pantau agen dengan alat seperti build_agent, configure_agent_trigger, run_agent, dan get_agent_run_status.
Bekerja dengan spreadsheet langsung (Theo Sheets) — buat, periksa, baca rentang, terapkan edit terstruktur, dan kembalikan perubahan menggunakan create_sheet, read_sheet_range, apply_sheet_ops, dan rollback_sheet.
Hasilkan gambar dan video secara inline — panggil generate_image untuk URL publik instan atau generate_video dan polling get_video_status untuk klip yang selesai.
Periksa akun dan saldo kredit AI Anda — verifikasi koneksi Anda dengan whoami dan pantau penggunaan melalui get_credits.

Dokumentasi

Server MCP OpenCharts

Bangun diagram alir, catatan, slide, sheet, papan, situs, agen, lagu, gambar & video 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), lagu (Theo Symphony), dan gambar & video (Theo Media) — semuanya didukung oleh Theo, AI OpenCharts. Saat membangun situs atau aplikasi, asisten Anda dapat menghasilkan citra dan klip video nyata secara inline dan langsung memasukkan URL yang dikembalikan ke dalam kode alih-alih meninggalkan placeholder.

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 — itu 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 puncak opencharts.com mengeluarkan pengalihan 307 yang menghapus header Authorization dan merusak autentikasi. Gunakan https://www.opencharts.com/api/mcp persis seperti itu.

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 mengaturnya? 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 59 alat di 11 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 proses 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 proses eksekusi terbaru agen
`get_agent_run_status`	Dapatkan status satu proses + 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 kisi + CSV
`create_sheet`	Buat spreadsheet langsung (kisi + rumus tingkat Excel) dari header dan baris
`update_sheet`	Edit sheet dengan menerapkan operasi edit spreadsheet terstruktur — disimpan sebagai komit yang dapat dikembalikan
`apply_sheet_ops`	Terapkan operasi edit spreadsheet terstruktur — atau usulkan perubahan dengan gerbang penggabungan
`edit_sheet`	Edit sheet dengan instruksi bahasa alami (Theo merencanakan + menerapkan operasi)
`list_sheet_commits`	Daftar komit perubahan bergaya 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

Theo Media

Alat	Deskripsi
`generate_image`	Hasilkan gambar dari prompt — mengembalikan URL publik untuk disematkan atau disimpan (gunakan alih-alih placeholder)
`generate_video`	Hasilkan klip video pendek dari prompt — mengembalikan pekerjaan untuk dipolling
`get_video_status`	Polling pekerjaan video; mengembalikan URL klip jadi 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 dari 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, generate_image, generate_video) 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-nya persis https://www.opencharts.com/api/mcp (dengan www.). Host puncak 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/mnt; tunggu dan coba lagi.
Alat hilang di klien Anda — mulai ulang klien sepenuhnya (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.