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

Essayer ce MCPSponsorisé

Que pouvez-vous faire avec OpenCharts MCP ?

Créez des organigrammes, des tableaux blancs, des notes et des présentations — générez des projets structurés directement via create_flowchart, create_whiteboard, create_notes ou create_presentation.
Construisez des sites web ou des applications complets à partir d'une description — utilisez generate_code_canvas pour lancer une construction Code Canvas, puis interrogez get_code_canvas_status pour obtenir le résultat.
Gérez les Theo Agents de bout en bout — créez, configurez des déclencheurs, activez, exécutez et surveillez des agents avec des outils comme build_agent, configure_agent_trigger, run_agent et get_agent_run_status.
Travaillez avec des feuilles de calcul en direct (Theo Sheets) — créez, inspectez, lisez des plages, appliquez des modifications structurées et annulez des changements en utilisant create_sheet, read_sheet_range, apply_sheet_ops et rollback_sheet.
Générez des images et des vidéos en ligne — appelez generate_image pour obtenir des URL publiques instantanées ou generate_video et interrogez get_video_status pour les clips terminés.
Vérifiez votre compte et votre solde de crédits IA — vérifiez votre connexion avec whoami et surveillez l'utilisation via get_credits.

Documentation

Serveur MCP OpenCharts

Créez des organigrammes, des notes, des diapositives, des feuilles de calcul, des tableaux, des sites, des agents, des chansons, des images et des vidéos 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 et applications complets (Code Canvas), automatisations (Theo Agents), chansons (Theo Symphony) et images et vidéos (Theo Media) — le tout propulsé par Theo, l'IA d'OpenCharts. Lors de la création d'un site ou d'une application, votre assistant peut générer de véritables images et clips vidéo en ligne et insérer les URL renvoyées directement dans le code au lieu de laisser des espaces réservés.

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 renvoyer votre compte OpenCharts.

Point de terminaison

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

Transport : HTTP Streamable (POST)
Authentification : 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 59 outils répartis en 11 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 — renvoie une tâche à interroger
`get_code_canvas_status`	Interroger une construction Code Canvas ; renvoie 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 avertit une fois prêt
`get_agent_build_status`	Interrogation facultative pour une tâche `build_agent` ; renvoie 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 avertit une fois terminé
`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, mise en page
`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 facultatives) 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 soumis à fusion
`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 — renvoie une tâche à interroger
`get_song_status`	Interroger une tâche de chanson ; renvoie les versions audio + pochette une fois terminée

Theo Media

Outil	Description
`generate_image`	Générer une image à partir d'une invite — renvoie une URL publique à intégrer ou enregistrer (à utiliser à la place des espaces réservés)
`generate_video`	Générer un court clip vidéo à partir d'une invite — renvoie une tâche à interroger
`get_video_status`	Interroger une tâche vidéo ; renvoie l'URL du clip terminé une fois prêt

Notes

Outil	Description
`get_note_content`	Extraire le contenu d'une note au format 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 client 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, generate_image, generate_video) 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 / "aucun 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 basculez le serveur OpenCharts sur arrêt/marche) 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 et 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.