Baserow

Baserow MCP

Connectez votre agent IA à Baserow. Votre agent peut lire et modifier des tables dans un espace de travail Baserow, en utilisant uniquement les outils que vous autorisez lors de la connexion.

Ce dépôt installe le serveur MCP de Baserow ainsi qu'une courte compétence qui apprend à l'agent à l'utiliser. Il fonctionne avec Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi et d'autres agents.

URL du serveur

• baserow.io : https://api.baserow.io/mcp
• Auto-hébergé : l'URL de votre backend suivie de /mcp, par exemple https://baserow.example.com/mcp. Copiez-la depuis Mes paramètres → Serveur MCP dans Baserow.

Les exemples ci-dessous utilisent l'URL baserow.io. Sur Baserow auto-hébergé, utilisez votre propre URL à la place.

Démarrage rapide

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp détecte les agents que vous avez installés et demande auxquels ajouter Baserow. Décochez Claude Desktop s'il est listé et ajoutez Baserow là-bas comme connecteur personnalisé à la place. skills add copie la compétence baserow-basics dans les dossiers de compétences de vos agents. Sur Baserow auto-hébergé, exécutez aussi skills add, car seuls les plugins ci-dessous incluent la compétence.

Exigences pour l'auto-hébergement

• Une version de Baserow plus récente que 2.4.1. Les versions plus anciennes n'ont pas /mcp ni la connexion ; utilisez une clé de point de terminaison à la place.
• BASEROW_MCP_OAUTH_ENABLED=true sur le backend. Il est désactivé par défaut.
• Une URL de backend HTTPS publique, afin que les applications hébergées comme Claude.ai et ChatGPT puissent y accéder, et un HTTPS sortant depuis le backend, qui récupère les métadonnées client des applications.
• Votre proxy inverse envoie /mcp et les chemins sous /mcp/, /oauth/, /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource au backend. Faites correspondre /mcp exactement, pas comme préfixe : le frontend sert la page de connexion à /mcp-authorize/.

Voir Connexion OAuth MCP pour Baserow auto-hébergé.

Installation par agent

Agent	baserow.io	Auto-hébergé
Claude Code	Plugin	Même plugin, entrez votre URL lorsqu'on vous le demande
Claude.ai, Claude Desktop	Connecteur personnalisé	Identique, avec votre URL
ChatGPT	Serveur MCP personnalisé	Identique, avec votre URL
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Serveur uniquement
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Ajouter à Cursor	Fichier de configuration
VS Code	Ajouter à VS Code	Fichier de configuration
Goose	Ajouter à Goose	Démarrage rapide avec votre URL
OpenCode, Windsurf, Zed	Fichier de configuration	Identique, avec votre URL
Tout autre agent	Démarrage rapide	Identique, avec votre URL

Les plugins Codex, Copilot et Gemini ainsi que les boutons Ajouter pointent toujours vers baserow.io, donc sur Baserow auto-hébergé, ajoutez uniquement le serveur pour ces agents.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

Lorsqu'on vous demande l'URL, appuyez sur Échap pour conserver baserow.io, ou entrez votre URL auto-hébergée. Pour la modifier plus tard, exécutez /plugin configure baserow@baserow.

Claude.ai et Claude Desktop

Personnaliser → Connecteurs → + Ajouter → Ajouter un connecteur personnalisé. Nommez-le Baserow et entrez l'URL de votre serveur. Sur les plans Team et Enterprise, un propriétaire l'ajoute sous Paramètres de l'organisation → Connecteurs.

ChatGPT

Ouvrez Plugins, sélectionnez le bouton plus, puis Ajouter un serveur MCP personnalisé, et entrez l'URL de votre serveur. Les noms de menus changent souvent. Sur les plans Business et Enterprise, un administrateur doit d'abord autoriser les serveurs MCP personnalisés.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

Sur Baserow auto-hébergé, ajoutez uniquement le serveur : copilot mcp add --transport http baserow <your url>. Si le plugin est installé, désinstallez-le d'abord avec copilot plugin uninstall baserow ; son serveur remplace le vôtre sans avertissement.

Fichiers de configuration

Pour ajouter uniquement le serveur, sans le plugin :

• Cursor, ~/.cursor/mcp.json :

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json :

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, puis opencode mcp auth baserow :

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json :

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, paramètres :

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

Connexion

Votre agent ouvre une page Baserow dans votre navigateur. Connectez-vous, choisissez l'espace de travail et cochez les outils que l'agent peut utiliser. Les outils de lecture permettent à l'agent de parcourir les bases de données, les tables et les lignes ; les outils d'écriture lui permettent de créer, mettre à jour et supprimer des lignes. Seuls les outils de lecture sont cochés lors d'une première connexion.

Où commence la connexion :

• Claude Code : exécutez /mcp, choisissez plugin:baserow:baserow et authentifiez-vous.
• Codex : codex mcp login baserow.
• Gemini CLI : /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor et VS Code : le bouton Connecter ou Se connecter à côté du serveur.

Pour changer l'espace de travail ou les outils, reconnectez-vous : réauthentifiez le serveur dans votre agent, ou déconnectez l'application sous Mes paramètres → Serveur MCP dans Baserow et reconnectez-vous. Une simple reconnexion conserve l'ancienne connexion.

Dépannage

• Un outil manque, ou aucune base de données n'est listée. La connexion ne dispose que de l'espace de travail et des outils choisis lors de la connexion. Reconnectez-vous comme décrit ci-dessus. Les outils qui modifient les tables ou les champs ne sont pas disponibles via MCP.
• La connexion ne démarre jamais, ou le client indique que le serveur ne prend pas en charge OAuth ou l'enregistrement client. Sur Baserow auto-hébergé, vérifiez les exigences pour l'auto-hébergement.
• La connexion échoue avec une URL que vous avez saisie. Copiez l'URL exactement telle qu'elle apparaît dans Mes paramètres → Serveur MCP. Elle se termine par /mcp, sans barre oblique finale.
• Deux serveurs Baserow dans Claude Code. Si claude mcp list affiche le plugin:baserow:baserow du plugin et un serveur baserow que vous avez ajouté manuellement, conservez celui qui se connecte. claude plugin disable baserow@baserow désactive celui du plugin ; claude mcp remove baserow supprime le vôtre.

Clés de point de terminaison

Baserow 2.4.1 et plus ancien n'accepte qu'une clé de point de terminaison, et le plugin ne la configure pas. Copiez l'URL du point de terminaison depuis Mes paramètres → Serveur MCP. Elle se termine par /sse et contient votre clé. Ajoutez-la manuellement à un agent prenant en charge les serveurs SSE, comme Claude Code, Cursor ou VS Code ; Codex et Goose ne le prennent pas en charge :

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Les versions plus récentes acceptent également la clé comme en-tête sur /mcp, ce qui est utile pour les scripts :

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

La clé donne un accès complet à son espace de travail. -g l'écrit dans votre configuration utilisateur au lieu du dossier actuel, afin qu'elle ne puisse pas se retrouver dans un commit.

Confidentialité et support

• Politique de confidentialité : https://baserow.io/privacy-policy
• Conditions : https://baserow.io/terms-and-conditions
• Aide : forum communautaire ou contactez-nous

Développement

Dans scripts/, exécutez npm install, puis npm test et npm run check. CI exécute les mêmes vérifications. Les outils y résident afin que les installations de plugins n'installent pas leurs dépendances.

Le plugin Claude Code déclare son serveur dans .claude-plugin/plugin.json, afin de pouvoir utiliser l'URL que vous entrez. .mcp.json contient l'URL baserow.io pour d'autres outils qui lisent les plugins au format Claude, comme GitHub Copilot CLI et Cursor.

Licence

MIT