OpenCharts MCP

offiziell

Verbinde 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_notes oder create_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 dann get_code_canvas_status nach 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_agent und get_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_ops und rollback_sheet.
  • Generieren Sie Bilder und Videos inline — rufen Sie generate_image für sofortige öffentliche URLs oder generate_video auf und fragen Sie get_video_status nach fertigen Clips ab.
  • Überprüfen Sie Ihr Konto und Ihr KI-Guthaben — bestätigen Sie Ihre Verbindung mit whoami und überwachen Sie die Nutzung über get_credits.

Dokumentation

OpenCharts

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

License Website MCP


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

  1. 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.
  2. 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.
  3. Überprüfen Sie die Verbindung, indem Sie Ihren Assistenten bitten, das Tool whoami aufzurufen – 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 Apex opencharts.com gibt eine 307-Weiterleitung aus, die den Authorization Header entfernt und die Authentifizierung unterbricht. Verwenden Sie genau https://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

ToolBeschreibung
list_projectsListen Sie Ihre Projekte mit Paginierung und Filtern auf
get_projectRufen Sie vollständige Projektdaten nach ID ab
create_flowchartErstellen Sie ein Flowchart-Projekt mit Knoten und Kanten
create_whiteboardErstellen Sie ein Whiteboard mit nativen Formen und Elementen
create_notesErstellen Sie ein Notizprojekt aus Markdown
create_presentationErstellen Sie ein Foliendeck aus einer Gliederung
update_projectAktualisieren Sie Metadaten oder Inhalte (Notizen, Flowchart, Whiteboard oder Präsentation)
delete_projectLöschen Sie ein Projekt vorläufig (30-Tage-Wiederherstellung)

Code Canvas

ToolBeschreibung
generate_code_canvasErstellen Sie eine vollständige Website oder App (HTML/React) aus einer Beschreibung – gibt einen abzufragenden Job zurück
get_code_canvas_statusFragen Sie einen Code Canvas-Build ab; gibt das Projekt + die offene URL zurück, wenn es fertig ist

KI

ToolBeschreibung
ask_theoSenden Sie eine einmalige KI-Nachricht (Schnell- oder Denkmodus)
extract_flowchartExtrahieren Sie ein Flowchart aus einem hochgeladenen Dokument (PDF, Bild, PPTX)

Theo Agents

ToolBeschreibung
build_agentErstellen Sie einen Theo Agent aus einer Beschreibung – läuft im Hintergrund und benachrichtigt Sie, wenn er fertig ist
get_agent_build_statusOptionale Abfrage für einen build_agent Job; gibt den Agenten + die offene URL zurück, wenn er fertig ist
create_agentErstellen Sie einen Theo Agent deterministisch aus strukturierten Schritten + Auslöser
update_agentPatchen Sie den Namen, die Beschreibung oder die Schrittliste eines Agenten
configure_agent_triggerLegen Sie den Auslöser eines Agenten fest (manuell, Zeitplan, Webhook, Ereignis, Telegram)
activate_agentAktivieren Sie einen Agenten (startet den ersten geplanten Lauf)
deactivate_agentDeaktivieren Sie einen Agenten, sodass Auslöser nicht mehr feuern
delete_agentLöschen Sie einen Agenten vorläufig (30-Tage-Wiederherstellung)
list_agentsListen Sie Ihre Theo Agents mit Status + Schrittanzahl auf
get_agentRufen Sie die vollständige Definition eines Agenten ab (Auslöser + geordnete Schritte)
run_agentFühren Sie einen Agenten jetzt aus – läuft im Hintergrund und benachrichtigt Sie bei Abschluss
list_agent_runsListen Sie die letzten Ausführungsläufe eines Agenten auf
get_agent_run_statusRufen Sie den Status eines einzelnen Laufs + den Fortschritt pro Knoten ab

Theo Sheets

ToolBeschreibung
list_sheetsListen Sie Ihre Theo Sheets-Tabellenkalkulationsprojekte auf
inspect_sheetUntersuchen Sie ein Sheet – Abmessungen pro Registerkarte, Kopfzeile, Beispielzellen + Formeln, Layout
get_sheetExtrahieren Sie ein Arbeitsblatt als strukturierte Zeilen (Kopfzeilen + Datenzeilen)
read_sheet_rangeLesen Sie die Werte eines exakten A1-Bereichs (+ optionale Formeln) als Raster + CSV
create_sheetErstellen Sie eine Live-Tabelle (Grid + Formeln auf Excel-Niveau) aus Kopfzeilen und Zeilen
update_sheetBearbeiten Sie ein Sheet, indem Sie strukturierte Tabellenbearbeitungsoperationen anwenden – gespeichert als rückgängig machbarer Commit
apply_sheet_opsWenden Sie strukturierte Tabellenbearbeitungsoperationen an – oder schlagen Sie eine Merge-gesteuerte Änderung vor
edit_sheetBearbeiten Sie ein Sheet mit einer natürlichsprachlichen Anweisung (Theo plant + wendet Operationen an)
list_sheet_commitsListen Sie die Git-artigen Änderungs-Commits eines Sheets auf (angewendet / vorgeschlagen / zusammengeführt)
diff_sheet_commitZeigen Sie den Diff auf Zellenebene für einen Commit oder Vorschlag an
resolve_sheet_proposalFühren Sie einen ausstehenden Änderungsvorschlag zusammen oder lehnen Sie ihn ab
rollback_sheetSetzen Sie das Live-Sheet auf einen früheren Commit zurück (umkehrbar)

Boards

ToolBeschreibung
create_boardErstellen Sie ein Kanban- + Kalender-Projektboard
list_boardsListen Sie Ihre Projektboards auf
get_boardRufen Sie die Listen (Spalten) und Karten eines Boards ab
update_boardAktualisieren Sie den Namen, die Beschreibung oder die Listenspalten eines Boards
delete_boardLöschen Sie ein Board vorläufig (wiederherstellbar)
duplicate_boardDuplizieren Sie ein Board mit seinen Listen, Regeln und Karten
add_board_cardFügen Sie eine Karte (Beitrag/Aufgabe/Idee/Ereignis) zu einem Board hinzu
list_board_cardsListen Sie die Karten eines Boards auf, optional nach Zeitplanbereich
update_board_cardBearbeiten Sie eine Karte – Liste verschieben, umplanen, Status/Farbe ändern
delete_board_cardLöschen Sie eine Karte vorläufig aus einem Board

Theo Symphony

ToolBeschreibung
create_songGenerieren Sie einen Song mit Theo Symphony – gibt einen abzufragenden Job zurück
get_song_statusFragen Sie einen Song-Job ab; gibt Audio- + Cover-Art-Versionen zurück, wenn er abgeschlossen ist

Theo Media

ToolBeschreibung
generate_imageGenerieren Sie ein Bild aus einer Eingabeaufforderung – gibt eine öffentliche URL zum Einbetten oder Speichern zurück (anstelle von Platzhaltern verwenden)
generate_videoGenerieren Sie einen kurzen Videoclip aus einer Eingabeaufforderung – gibt einen abzufragenden Job zurück
get_video_statusFragen Sie einen Video-Job ab; gibt die fertige Clip-URL zurück, wenn er abgeschlossen ist

Notizen

ToolBeschreibung
get_note_contentExtrahieren Sie den Inhalt einer Notiz als Markdown
append_to_noteHängen Sie Markdown-Inhalte an eine bestehende Notiz an
clip_to_noteSpeichern Sie Webinhalte (URL + HTML) als Clip in einer Notiz

Vorlagen

ToolBeschreibung
list_templatesDurchsuchen Sie die Vorlagengalerie
use_templateErstellen Sie ein neues Projekt aus einer Vorlage

Konto

ToolBeschreibung
whoamiRufen 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.

RessourceBeschreibung
projectsPaginierte Liste Ihrer letzten Projekte
projectVollständige Daten für ein einzelnes Projekt nach ID
templatesDurchsuchbarer 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 – Erkennungsmanifest
  • https://www.opencharts.com/.well-known/mcp/server-card.json – Serverkarte
  • https://www.opencharts.com/.well-known/oauth-protected-resource – Metadaten geschützter Ressourcen
  • Dokumentation: opencharts.com/help/mcp-server

Fehlerbehebung

  • 307 Weiterleitung / „keine Autorisierungsunterstützung“ / 401 – stellen Sie sicher, dass die URL genau https://www.opencharts.com/api/mcp (mit www.) ist. Der Apex-Host entfernt den Authorization Header bei der Weiterleitung. Bestätigen Sie außerdem, dass Ihr Schlüssel aktiv ist und mit dem Präfix Bearer gesendet 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, write und ai umfasst (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:

Links

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.