OpenCharts MCP

officiel

Branchez votre agent IA à OpenCharts—créez des feuilles de calcul, des tableaux, de la musique et des automatisations depuis Claude Code, Codex ou Cursor sans quitter votre terminal.

GitHub

Que pouvez-vous faire avec Open Charts MCP ?

Créer et gérer des projets — Créez des diagrammes, des tableaux blancs, des notes, des présentations, etc. à l'aide d'outils comme create_flowchart, create_whiteboard, create_notes et create_presentation.
Travailler avec des feuilles de calcul — Inspectez, lisez, créez et modifiez des Theo Sheets avec prise en charge des formules à l'aide de inspect_sheet, get_sheet, create_sheet, update_sheet et edit_sheet.
Créer et exécuter des automatisations — Créez, configurez, activez et exécutez des Theo Agents avec build_agent, create_agent, configure_agent_trigger et run_agent.
Gérer les tableaux Kanban — Créez des tableaux, ajoutez et mettez à jour des cartes, et gérez les listes avec create_board, add_board_card, update_board_card et list_board_cards.
Générer des sites web et des chansons — Créez des sites web ou des applications complets avec generate_code_canvas et composez de la musique avec create_song, puis interrogez l'état avec get_code_canvas_status et get_song_status.
Vérifier le compte et les crédits — Vérifiez votre connexion avec whoami et surveillez l'utilisation des crédits IA avec get_credits.

Documentation

Serveur MCP OpenCharts

Créez des organigrammes, des notes, des diapositives, des feuilles, des tableaux, des sites, des agents et des chansons dans OpenCharts — directement depuis votre client IA.

Site Web · Documentation · Obtenir une clé API · Problèmes

Qu'est-ce que c'est ?

OpenCharts exécute un serveur public et hébergé Model Context Protocol (MCP) qui place l'intégralité du produit OpenCharts dans n'importe quel client IA compatible MCP. Connectez-vous une fois avec une clé API et votre assistant peut créer et gérer de véritables projets OpenCharts pour vous — organigrammes, tableaux blancs, notes, présentations, feuilles de calcul (Theo Sheets), tableaux Kanban + calendrier, sites Web complets et applications (Code Canvas), automatisations (Theo Agents) et chansons (Theo Symphony) — le tout propulsé par Theo, l'IA d'OpenCharts.

Il s'agit d'un serveur distant via HTTP Streamable — il n'y a rien à installer ou à exécuter localement. Pointez votre client vers le point de terminaison, collez votre clé API, et c'est parti.

Ce dépôt est la documentation publique de ce serveur. Le serveur lui-même est hébergé par OpenCharts ; vous ne l'exécutez pas vous-même.

Vous voulez vous connecter en moins d'une minute ? Utilisez le guide intégré à l'application sur opencharts.com/help/mcp-server ou la page de configuration sur opencharts.com/theo-agents/mcp.

Démarrage rapide

Créez une clé API sur opencharts.com/theo-agents/mcp. Copiez-la immédiatement — la clé complète n'est affichée qu'une seule fois.
Ajoutez le serveur à votre client IA en utilisant l'extrait de configuration correspondant ci-dessous, en remplaçant {{YOUR_API_KEY}} par votre clé.
Vérifiez la connexion en demandant à votre assistant d'appeler l'outil whoami — il devrait retourner votre compte OpenCharts.

Point de terminaison

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

Transport : HTTP Streamable (POST)
Auth : Authorization: Bearer <API key> (un JWT provenant d'une session OpenCharts active fonctionne également)

⚠️ Utilisez toujours l'hôte www.. L'hôte apex opencharts.com émet une redirection 307 qui supprime l'en-tête Authorization et interrompt l'authentification. Utilisez exactement https://www.opencharts.com/api/mcp.

Connectez votre client IA

Le serveur fonctionne avec n'importe quel client compatible MCP. Copiez l'extrait correspondant et remplacez-le par votre clé API. Vous préférez laisser votre assistant le configurer ? La page d'aide contient une « invite de configuration IA » en un seul collage pour chaque client ci-dessous.

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)

Ajoutez à .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

Dans l'extension 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}}"
      }
    }
  }
}

Outils

Le serveur expose 56 outils répartis en 10 groupes. Les outils qui utilisent Theo AI ou la génération consomment des crédits IA.

Projets

Outil	Description
`list_projects`	Lister vos projets avec pagination et filtres
`get_project`	Obtenir les données complètes d'un projet par ID
`create_flowchart`	Créer un projet d'organigramme avec des nœuds et des arêtes
`create_whiteboard`	Créer un tableau blanc avec des formes et éléments natifs
`create_notes`	Créer un projet de notes à partir de Markdown
`create_presentation`	Créer un diaporama à partir d'un plan
`update_project`	Mettre à jour les métadonnées ou le contenu (notes, organigramme, tableau blanc ou présentation)
`delete_project`	Supprimer temporairement un projet (récupération sous 30 jours)

Code Canvas

Outil	Description
`generate_code_canvas`	Créer un site Web ou une application complète (HTML/React) à partir d'une description — retourne un job à interroger
`get_code_canvas_status`	Interroger une construction Code Canvas ; retourne le projet + l'URL d'ouverture une fois prêt

IA

Outil	Description
`ask_theo`	Envoyer un message IA en un seul tour (mode rapide ou réflexion)
`extract_flowchart`	Extraire un organigramme d'un document téléchargé (PDF, image, PPTX)

Theo Agents

Outil	Description
`build_agent`	Créer un Theo Agent à partir d'une description — s'exécute en arrière-plan, vous notifie une fois prêt
`get_agent_build_status`	Interrogation optionnelle pour un job `build_agent` ; retourne l'agent + l'URL d'ouverture une fois terminé
`create_agent`	Créer un Theo Agent de manière déterministe à partir d'étapes structurées + déclencheur
`update_agent`	Modifier le nom, la description ou la liste d'étapes d'un agent
`configure_agent_trigger`	Définir le déclencheur d'un agent (manuel, planifié, webhook, événement, telegram)
`activate_agent`	Activer un agent (initialise la première exécution planifiée)
`deactivate_agent`	Désactiver un agent pour que les déclencheurs cessent de se déclencher
`delete_agent`	Supprimer temporairement un agent (récupération sous 30 jours)
`list_agents`	Lister vos Theo Agents avec leur statut + nombre d'étapes
`get_agent`	Obtenir la définition complète d'un agent (déclencheur + étapes ordonnées)
`run_agent`	Lancer un agent maintenant — s'exécute en arrière-plan, vous notifie à la fin
`list_agent_runs`	Lister les exécutions récentes d'un agent
`get_agent_run_status`	Obtenir le statut d'une seule exécution + la progression par nœud

Theo Sheets

Outil	Description
`list_sheets`	Lister vos projets de feuilles de calcul Theo Sheets
`inspect_sheet`	Inspecter une feuille — dimensions par onglet, ligne d'en-tête, cellules et formules échantillonnées, disposition
`get_sheet`	Extraire une feuille de calcul sous forme de lignes structurées (en-têtes + lignes de données)
`read_sheet_range`	Lire les valeurs d'une plage A1 exacte (+ formules optionnelles) sous forme de grille + CSV
`create_sheet`	Créer une feuille de calcul en direct (grille de qualité Excel + formules) à partir d'en-têtes et de lignes
`update_sheet`	Modifier une feuille en appliquant des opérations d'édition structurées — enregistré comme un commit annulable
`apply_sheet_ops`	Appliquer des opérations d'édition structurées — ou proposer un changement avec fusion contrôlée
`edit_sheet`	Modifier une feuille avec une instruction en langage naturel (Theo planifie + applique les opérations)
`list_sheet_commits`	Lister les commits de changement de type git d'une feuille (appliqués / proposés / fusionnés)
`diff_sheet_commit`	Afficher la différence au niveau des cellules pour un commit ou une proposition
`resolve_sheet_proposal`	Fusionner ou rejeter une proposition de changement en attente
`rollback_sheet`	Revenir à un commit antérieur de la feuille en direct (réversible)

Tableaux

Outil	Description
`create_board`	Créer un tableau de projet Kanban + calendrier
`list_boards`	Lister vos tableaux de projet
`get_board`	Obtenir les listes (colonnes) et les cartes d'un tableau
`update_board`	Mettre à jour le nom, la description ou les colonnes de liste d'un tableau
`delete_board`	Supprimer temporairement un tableau (récupérable)
`duplicate_board`	Dupliquer un tableau avec ses listes, règles et cartes
`add_board_card`	Ajouter une carte (publication/tâche/idée/événement) à un tableau
`list_board_cards`	Lister les cartes d'un tableau, éventuellement par plage de dates
`update_board_card`	Modifier une carte — déplacer la liste, replanifier, changer le statut/la couleur
`delete_board_card`	Supprimer temporairement une carte d'un tableau

Theo Symphony

Outil	Description
`create_song`	Générer une chanson avec Theo Symphony — retourne un job à interroger
`get_song_status`	Interroger un job de chanson ; retourne les versions audio + pochette une fois terminé

Notes

Outil	Description
`get_note_content`	Extraire le contenu d'une note en Markdown
`append_to_note`	Ajouter du contenu Markdown à une note existante
`clip_to_note`	Enregistrer du contenu Web (URL + HTML) en tant qu'extrait dans une note

Modèles

Outil	Description
`list_templates`	Parcourir la galerie de modèles
`use_template`	Créer un nouveau projet à partir d'un modèle

Compte

Outil	Description
`whoami`	Obtenir les informations de profil de l'utilisateur authentifié
`get_credits`	Vérifier le solde de crédits IA restant

Ressources

Les ressources fournissent un contexte en lecture seule qu'un client IA peut récupérer sans appeler d'outil.

Ressource	Description
`projects`	Liste paginée de vos projets récents
`project`	Données complètes d'un seul projet par ID
`templates`	Catalogue de modèles consultable

Comment ça fonctionne

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

Chaque requête est authentifiée par votre clé API et agit sur votre propre compte OpenCharts. Comme le serveur est hébergé, la surface d'outils reste à jour automatiquement — aucune mise à jour du client n'est requise. Les outils qui utilisent Theo AI ou la génération (par exemple ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) consomment des crédits IA de votre forfait.

Limites de débit et crédits

120 requêtes par minute par utilisateur.
Les outils d'IA et de génération consomment des crédits IA — vérifiez votre solde à tout moment avec l'outil get_credits.

Découverte et registre

Des métadonnées lisibles par machine sont publiées pour les clients, les robots d'indexation et les registres (aucun secret) :

https://www.opencharts.com/.well-known/mcp — manifeste de découverte
https://www.opencharts.com/.well-known/mcp/server-card.json — fiche serveur
https://www.opencharts.com/.well-known/oauth-protected-resource — métadonnées de ressource protégée
Documentation : opencharts.com/help/mcp-server

Dépannage

Redirection 307 / « pas de support d'autorisation » / 401 — assurez-vous que l'URL est exactement https://www.opencharts.com/api/mcp (avec www.). L'hôte apex supprime l'en-tête Authorization lors de la redirection. Confirmez également que votre clé est active et envoyée avec le préfixe Bearer .
429 Too Many Requests — vous avez atteint la limite de 120 req/min ; attendez et réessayez.
Outils manquants dans votre client — redémarrez complètement le client (ou désactivez/réactivez le serveur OpenCharts) pour qu'il récupère à nouveau la liste d'outils. Confirmez que votre clé porte les portées read, write et ai (les clés par défaut incluent les trois).
JWT expiré en cours de session — les JWT de session expirent après environ 15 minutes ; utilisez une clé API persistante pour les intégrations de longue durée.

Clients compatibles

Fonctionne avec tout client prenant en charge le Model Context Protocol, y compris :

Warp — environnement de développement agentique
Claude Desktop & Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Liens

🌐 Site Web : opencharts.com
📖 Documentation MCP : opencharts.com/help/mcp-server
🔑 Obtenir une clé API : opencharts.com/theo-agents/mcp
💬 Communauté : opencharts.com/community
🐛 Problèmes : Problèmes GitHub

Licence

Cette documentation est sous licence CC-BY-4.0. Le serveur MCP OpenCharts est un produit hébergé — consultez opencharts.com pour les conditions et les tarifs.