OpenCharts MCP
offiziellVerbinde deinen KI-Agenten mit OpenCharts – erstelle Tabellen, Boards, Musik und Automatisierungen direkt aus Claude Code, Codex oder Cursor, ohne dein Terminal zu verlassen.
Was kann man mit OpenCharts MCP machen?
- Erstellen Sie Flussdiagramme, Whiteboards, Notizen und Präsentationen — generieren Sie strukturierte Projekte direkt über
create_flowchart,create_whiteboard,create_notesodercreate_presentation. - Erstellen Sie vollständige Websites oder Apps aus einer Beschreibung — verwenden Sie
generate_code_canvas, um einen Code-Canvas-Build zu starten, und fragen Sie dannget_code_canvas_statusnach dem Ergebnis ab. - Verwalten Sie Theo Agents durchgängig — erstellen, konfigurieren Sie Trigger für, aktivieren, führen Sie Agents aus und überwachen Sie sie mit Tools wie
build_agent,configure_agent_trigger,run_agentundget_agent_run_status. - Arbeiten Sie mit Live-Tabellenkalkulationen (Theo Sheets) — erstellen, prüfen, lesen Sie Bereiche, wenden Sie strukturierte Bearbeitungen an und machen Sie Änderungen rückgängig mit
create_sheet,read_sheet_range,apply_sheet_opsundrollback_sheet. - Generieren Sie Bilder und Videos inline — rufen Sie
generate_imagefür sofortige öffentliche URLs odergenerate_videoauf und fragen Sieget_video_statusnach fertigen Clips ab. - Überprüfen Sie Ihr Konto und Ihr KI-Guthaben — bestätigen Sie Ihre Verbindung mit
whoamiund überwachen Sie die Nutzung überget_credits.
Dokumentation
OpenCharts MCP Server
Erstellen Sie Flowcharts, Notizen, Folien, Tabellen, Boards, Websites, Agents, Songs, Bilder und Videos in OpenCharts – direkt aus Ihrem KI-Client.
Website · Dokumentation · API-Schlüssel erhalten · Probleme
Was ist das?
OpenCharts betreibt einen öffentlichen, gehosteten Model Context Protocol (MCP) Server, der das gesamte OpenCharts-Produkt in jeden MCP-kompatiblen KI-Client bringt. Einmal mit einem API-Schlüssel verbinden, und Ihr Assistent kann in Ihrem Auftrag echte OpenCharts-Projekte erstellen und verwalten – Flowcharts, Whiteboards, Notizen, Präsentationen, Tabellenkalkulationen (Theo Sheets), Kanban- und Kalender-Boards, vollständige Websites und Apps (Code Canvas), Automatisierungen (Theo Agents), Songs (Theo Symphony) sowie Bilder und Videos (Theo Media) – alles unterstützt von Theo, der OpenCharts-KI. Beim Erstellen einer Website oder App kann Ihr Assistent echte Bilder und Videoclips inline generieren und die zurückgegebenen URLs direkt in den Code einfügen, anstatt Platzhalter zu hinterlassen.
Es handelt sich um einen Remote-Server über Streamable HTTP – es muss nichts installiert oder lokal ausgeführt werden. Verweisen Sie Ihren Client auf den Endpunkt, fügen Sie Ihren API-Schlüssel ein, und legen Sie los.
Dieses Repository ist die öffentliche Dokumentation für diesen Server. Der Server selbst wird von OpenCharts gehostet; Sie betreiben ihn nicht selbst.
Möchten Sie sich in weniger als einer Minute verbinden? Verwenden Sie die In-App-Anleitung unter opencharts.com/help/mcp-server oder die Einrichtungsseite unter opencharts.com/theo-agents/mcp.
Schnellstart
- Erstellen Sie einen API-Schlüssel unter opencharts.com/theo-agents/mcp. Kopieren Sie ihn sofort – der vollständige Schlüssel wird nur einmal angezeigt.
- Fügen Sie den Server zu Ihrem KI-Client hinzu, indem Sie den passenden Konfigurationsausschnitt unten verwenden und
{{YOUR_API_KEY}}durch Ihren Schlüssel ersetzen. - Überprüfen Sie die Verbindung, indem Sie Ihren Assistenten bitten, das Tool
whoamiaufzurufen – es sollte Ihr OpenCharts-Konto zurückgeben.
Endpunkt
https://www.opencharts.com/api/mcp
- Transport: Streamable HTTP (
POST) - Auth:
Authorization: Bearer <API key>(ein JWT aus einer aktiven OpenCharts-Sitzung funktioniert ebenfalls)
⚠️ Verwenden Sie immer den
www.Host. Der Apexopencharts.comgibt eine 307-Weiterleitung aus, die denAuthorizationHeader entfernt und die Authentifizierung unterbricht. Verwenden Sie genauhttps://www.opencharts.com/api/mcp.
Verbinden Sie Ihren KI-Client
Der Server funktioniert mit jedem MCP-kompatiblen Client. Kopieren Sie den passenden Ausschnitt und tauschen Sie Ihren API-Schlüssel ein. Möchten Sie die Einrichtung lieber Ihrem Assistenten überlassen? Die Hilfeseite enthält einen „KI-Einrichtungs-Prompt“ zum einmaligen Einfügen für jeden unten aufgeführten Client.
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)
Zu .vscode/mcp.json hinzufügen:
{
"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
In der VS Code-Erweiterung 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}}"
}
}
}
}
Tools
Der Server stellt 59 Tools in 11 Gruppen bereit. Tools, die Theo AI oder Generierung verwenden, verbrauchen KI-Guthaben.
Projekte
| Tool | Beschreibung |
|---|---|
list_projects | Listen Sie Ihre Projekte mit Paginierung und Filtern auf |
get_project | Rufen Sie vollständige Projektdaten nach ID ab |
create_flowchart | Erstellen Sie ein Flowchart-Projekt mit Knoten und Kanten |
create_whiteboard | Erstellen Sie ein Whiteboard mit nativen Formen und Elementen |
create_notes | Erstellen Sie ein Notizprojekt aus Markdown |
create_presentation | Erstellen Sie ein Foliendeck aus einer Gliederung |
update_project | Aktualisieren Sie Metadaten oder Inhalte (Notizen, Flowchart, Whiteboard oder Präsentation) |
delete_project | Löschen Sie ein Projekt vorläufig (30-Tage-Wiederherstellung) |
Code Canvas
| Tool | Beschreibung |
|---|---|
generate_code_canvas | Erstellen Sie eine vollständige Website oder App (HTML/React) aus einer Beschreibung – gibt einen abzufragenden Job zurück |
get_code_canvas_status | Fragen Sie einen Code Canvas-Build ab; gibt das Projekt + die offene URL zurück, wenn es fertig ist |
KI
| Tool | Beschreibung |
|---|---|
ask_theo | Senden Sie eine einmalige KI-Nachricht (Schnell- oder Denkmodus) |
extract_flowchart | Extrahieren Sie ein Flowchart aus einem hochgeladenen Dokument (PDF, Bild, PPTX) |
Theo Agents
| Tool | Beschreibung |
|---|---|
build_agent | Erstellen Sie einen Theo Agent aus einer Beschreibung – läuft im Hintergrund und benachrichtigt Sie, wenn er fertig ist |
get_agent_build_status | Optionale Abfrage für einen build_agent Job; gibt den Agenten + die offene URL zurück, wenn er fertig ist |
create_agent | Erstellen Sie einen Theo Agent deterministisch aus strukturierten Schritten + Auslöser |
update_agent | Patchen Sie den Namen, die Beschreibung oder die Schrittliste eines Agenten |
configure_agent_trigger | Legen Sie den Auslöser eines Agenten fest (manuell, Zeitplan, Webhook, Ereignis, Telegram) |
activate_agent | Aktivieren Sie einen Agenten (startet den ersten geplanten Lauf) |
deactivate_agent | Deaktivieren Sie einen Agenten, sodass Auslöser nicht mehr feuern |
delete_agent | Löschen Sie einen Agenten vorläufig (30-Tage-Wiederherstellung) |
list_agents | Listen Sie Ihre Theo Agents mit Status + Schrittanzahl auf |
get_agent | Rufen Sie die vollständige Definition eines Agenten ab (Auslöser + geordnete Schritte) |
run_agent | Führen Sie einen Agenten jetzt aus – läuft im Hintergrund und benachrichtigt Sie bei Abschluss |
list_agent_runs | Listen Sie die letzten Ausführungsläufe eines Agenten auf |
get_agent_run_status | Rufen Sie den Status eines einzelnen Laufs + den Fortschritt pro Knoten ab |
Theo Sheets
| Tool | Beschreibung |
|---|---|
list_sheets | Listen Sie Ihre Theo Sheets-Tabellenkalkulationsprojekte auf |
inspect_sheet | Untersuchen Sie ein Sheet – Abmessungen pro Registerkarte, Kopfzeile, Beispielzellen + Formeln, Layout |
get_sheet | Extrahieren Sie ein Arbeitsblatt als strukturierte Zeilen (Kopfzeilen + Datenzeilen) |
read_sheet_range | Lesen Sie die Werte eines exakten A1-Bereichs (+ optionale Formeln) als Raster + CSV |
create_sheet | Erstellen Sie eine Live-Tabelle (Grid + Formeln auf Excel-Niveau) aus Kopfzeilen und Zeilen |
update_sheet | Bearbeiten Sie ein Sheet, indem Sie strukturierte Tabellenbearbeitungsoperationen anwenden – gespeichert als rückgängig machbarer Commit |
apply_sheet_ops | Wenden Sie strukturierte Tabellenbearbeitungsoperationen an – oder schlagen Sie eine Merge-gesteuerte Änderung vor |
edit_sheet | Bearbeiten Sie ein Sheet mit einer natürlichsprachlichen Anweisung (Theo plant + wendet Operationen an) |
list_sheet_commits | Listen Sie die Git-artigen Änderungs-Commits eines Sheets auf (angewendet / vorgeschlagen / zusammengeführt) |
diff_sheet_commit | Zeigen Sie den Diff auf Zellenebene für einen Commit oder Vorschlag an |
resolve_sheet_proposal | Führen Sie einen ausstehenden Änderungsvorschlag zusammen oder lehnen Sie ihn ab |
rollback_sheet | Setzen Sie das Live-Sheet auf einen früheren Commit zurück (umkehrbar) |
Boards
| Tool | Beschreibung |
|---|---|
create_board | Erstellen Sie ein Kanban- + Kalender-Projektboard |
list_boards | Listen Sie Ihre Projektboards auf |
get_board | Rufen Sie die Listen (Spalten) und Karten eines Boards ab |
update_board | Aktualisieren Sie den Namen, die Beschreibung oder die Listenspalten eines Boards |
delete_board | Löschen Sie ein Board vorläufig (wiederherstellbar) |
duplicate_board | Duplizieren Sie ein Board mit seinen Listen, Regeln und Karten |
add_board_card | Fügen Sie eine Karte (Beitrag/Aufgabe/Idee/Ereignis) zu einem Board hinzu |
list_board_cards | Listen Sie die Karten eines Boards auf, optional nach Zeitplanbereich |
update_board_card | Bearbeiten Sie eine Karte – Liste verschieben, umplanen, Status/Farbe ändern |
delete_board_card | Löschen Sie eine Karte vorläufig aus einem Board |
Theo Symphony
| Tool | Beschreibung |
|---|---|
create_song | Generieren Sie einen Song mit Theo Symphony – gibt einen abzufragenden Job zurück |
get_song_status | Fragen Sie einen Song-Job ab; gibt Audio- + Cover-Art-Versionen zurück, wenn er abgeschlossen ist |
Theo Media
| Tool | Beschreibung |
|---|---|
generate_image | Generieren Sie ein Bild aus einer Eingabeaufforderung – gibt eine öffentliche URL zum Einbetten oder Speichern zurück (anstelle von Platzhaltern verwenden) |
generate_video | Generieren Sie einen kurzen Videoclip aus einer Eingabeaufforderung – gibt einen abzufragenden Job zurück |
get_video_status | Fragen Sie einen Video-Job ab; gibt die fertige Clip-URL zurück, wenn er abgeschlossen ist |
Notizen
| Tool | Beschreibung |
|---|---|
get_note_content | Extrahieren Sie den Inhalt einer Notiz als Markdown |
append_to_note | Hängen Sie Markdown-Inhalte an eine bestehende Notiz an |
clip_to_note | Speichern Sie Webinhalte (URL + HTML) als Clip in einer Notiz |
Vorlagen
| Tool | Beschreibung |
|---|---|
list_templates | Durchsuchen Sie die Vorlagengalerie |
use_template | Erstellen Sie ein neues Projekt aus einer Vorlage |
Konto
| Tool | Beschreibung |
|---|---|
whoami | Rufen Sie die Profilinformationen des authentifizierten Benutzers ab |
get_credits | Überprüfen Sie das verbleibende KI-Guthaben |
Ressourcen
Ressourcen bieten schreibgeschützten Kontext, den ein KI-Client abrufen kann, ohne ein Tool aufzurufen.
| Ressource | Beschreibung |
|---|---|
projects | Paginierte Liste Ihrer letzten Projekte |
project | Vollständige Daten für ein einzelnes Projekt nach ID |
templates | Durchsuchbarer Vorlagenkatalog |
So funktioniert es
┌────────────────────┐ 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 │
└────────────────────┘ └────────────────────────────┘
Jede Anfrage wird durch Ihren API-Schlüssel authentifiziert und wirkt sich auf Ihr eigenes OpenCharts-Konto aus. Da der Server gehostet wird, bleibt die Tool-Oberfläche automatisch aktuell – keine Client-Updates erforderlich. Tools, die Theo AI oder Generierung verwenden (z. B. ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song, generate_image, generate_video), verbrauchen KI-Guthaben aus Ihrem Plan.
Ratenbegrenzungen & Guthaben
- 120 Anfragen pro Minute pro Benutzer.
- KI- und Generierungstools verbrauchen KI-Guthaben – überprüfen Sie Ihren Kontostand jederzeit mit dem Tool
get_credits.
Erkennung & Registrierung
Maschinenlesbare Metadaten werden für Clients, Crawler und Registries veröffentlicht (keine Geheimnisse):
https://www.opencharts.com/.well-known/mcp– Erkennungsmanifesthttps://www.opencharts.com/.well-known/mcp/server-card.json– Serverkartehttps://www.opencharts.com/.well-known/oauth-protected-resource– Metadaten geschützter Ressourcen- Dokumentation: opencharts.com/help/mcp-server
Fehlerbehebung
307Weiterleitung / „keine Autorisierungsunterstützung“ /401– stellen Sie sicher, dass die URL genauhttps://www.opencharts.com/api/mcp(mitwww.) ist. Der Apex-Host entfernt denAuthorizationHeader bei der Weiterleitung. Bestätigen Sie außerdem, dass Ihr Schlüssel aktiv ist und mit dem PräfixBearergesendet wird.429 Too Many Requests– Sie haben das Limit von 120 Anfragen/Minute erreicht; warten Sie und versuchen Sie es erneut.- Tools fehlen in Ihrem Client – starten Sie den Client vollständig neu (oder schalten Sie den OpenCharts-Server aus/ein), damit er die Tool-Liste erneut abruft. Bestätigen Sie, dass Ihr Schlüssel die Bereiche
read,writeundaiumfasst (Standardschlüssel enthalten alle drei). - JWT während der Sitzung abgelaufen – Sitzungs-JWTs laufen nach ca. 15 Minuten ab; verwenden Sie einen persistenten API-Schlüssel für lang laufende Integrationen.
Kompatible Clients
Funktioniert mit jedem Client, der das Model Context Protocol unterstützt, einschließlich:
- Warp – agentische Entwicklungsumgebung
- Claude Desktop & Claude Code
- Cursor
- VS Code (GitHub Copilot)
- Windsurf (Codeium)
- Codex (OpenAI)
- Amp
- OpenCode
Links
- 🌐 Website: opencharts.com
- 📖 MCP-Dokumentation: opencharts.com/help/mcp-server
- 🔑 API-Schlüssel erhalten: opencharts.com/theo-agents/mcp
- 💬 Community: opencharts.com/community
- 🐛 Probleme: GitHub Issues
Lizenz
Diese Dokumentation ist unter CC-BY-4.0 lizenziert. Der OpenCharts MCP Server ist ein gehostetes Produkt – siehe opencharts.com für Bedingungen und Preise.