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.

GitHub

Was kann man mit Open Charts MCP machen?

Projekte erstellen und verwalten — Erstellen Sie Flussdiagramme, Whiteboards, Notizen, Präsentationen und mehr mit Werkzeugen wie create_flowchart, create_whiteboard, create_notes und create_presentation.
Mit Tabellenkalkulationen arbeiten — Überprüfen, lesen, erstellen und bearbeiten Sie Theo Sheets mit Formelunterstützung mithilfe von inspect_sheet, get_sheet, create_sheet, update_sheet und edit_sheet.
Automatisierungen erstellen und ausführen — Erstellen, konfigurieren, aktivieren und führen Sie Theo Agents aus mit build_agent, create_agent, configure_agent_trigger und run_agent.
Kanban-Boards verwalten — Erstellen Sie Boards, fügen Sie Karten hinzu und aktualisieren Sie sie, und verwalten Sie Listen mit create_board, add_board_card, update_board_card und list_board_cards.
Websites und Songs generieren — Erstellen Sie vollständige Websites oder Apps mit generate_code_canvas und Musik mit create_song, und fragen Sie dann den Status mit get_code_canvas_status und get_song_status ab.
Konto und Credits prüfen — Überprüfen Sie Ihre Verbindung mit whoami und überwachen Sie die KI-Credit-Nutzung mit get_credits.

Dokumentation

OpenCharts MCP Server

Erstellen Sie Flussdiagramme, Notizen, Folien, Tabellen, Boards, Websites, Agenten & Songs 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 – Flussdiagramme, Whiteboards, Notizen, Präsentationen, Tabellenkalkulationen (Theo Sheets), Kanban- & Kalender-Boards, vollständige Websites & Apps (Code Canvas), Automatisierungen (Theo Agents) und Songs (Theo Symphony) – alles unterstützt von Theo, der OpenCharts-KI.

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 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 56 Tools in 10 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 Flussdiagramm-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, Flussdiagramm, 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 Flussdiagramm 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, 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`	Ändern 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 die erste geplante Ausführung)
`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 + Schrittzahlen 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, benachrichtigt Sie nach 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 Zellebene 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, neu planen, 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

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), verbrauchen KI-Guthaben aus Ihrem Tarif.

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 für geschützte 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 lautet (mit www.). 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 und wieder 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 mitten in 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

Lizenz

Diese Dokumentation ist lizenziert unter CC-BY-4.0. Der OpenCharts MCP Server ist ein gehostetes Produkt – siehe opencharts.com für Bedingungen und Preise.