Xata MCP server

officiel

Le serveur MCP Xata permet aux assistants et agents IA d'interagir avec vos organisations, projets et branches de base de données Postgres Xata.

Voir sur xata.io

Que pouvez-vous faire avec Xata MCP ?

Trouver des opérations d’API — Demandez à votre assistant de localiser une opération de l’API REST Xata en fonction de son objectif, par exemple lister les branches ou inviter un membre.
Examiner les schémas des opérations — Obtenez les paramètres et les schémas de requête/réponse d’une opération spécifique de l’API Xata avant de l’appeler.
Exécuter des appels d’API en lecture seule — Appelez des opérations de l’API REST Xata en lecture seule, comme lister les branches, par l’intermédiaire de votre assistant.
Interroger les branches avec SQL — Exécutez du SQL sur une branche, en lecture seule par défaut ; toute écriture nécessite une confirmation explicite.
Explorer les schémas des branches — Listez les tables et les colonnes d’une branche pour en comprendre la structure.
Rechercher dans la documentation Xata — Recherchez dans la documentation Xata ou consultez des pages spécifiques en indiquant leur chemin.

Documentation

Serveur MCP

Connectez Cursor, Claude, VS Code et d’autres clients MCP à Xata

Le serveur MCP Xata permet aux assistants et agents IA d’interagir avec vos organisations, projets et branches Xata à l’aide du Model Context Protocol (MCP).

Qu’est-ce que le serveur MCP Xata ?

Un serveur MCP hébergé qui fonctionne avec l’API Xata : rien à installer ni à exécuter localement.
Authentification via OAuth dans votre navigateur, ou avec une clé API Xata dans les environnements sans interface.
Accessible depuis tout client MCP prenant en charge les serveurs distants via Streamable HTTP.

URL du serveur :

https://api.xata.tech/mcp

Le serveur utilise le transport Streamable HTTP. Il n’existe pas de point de terminaison SSE ni de version locale (npm) du serveur.

Authentification

Le serveur MCP prend en charge deux méthodes d’authentification :

Méthode	À utiliser pour	Exigence côté client
OAuth	Utilisation interactive dans un éditeur ou un chat	Prise en charge d’OAuth MCP (enregistrement dynamique du client)
Clé API	Automatisation, CI, agents sans interface	Prise en charge des en-têtes HTTP personnalisés

OAuth

Avec les clients compatibles avec OAuth, vous n’avez besoin que de l’URL du serveur. Lors de la première connexion de votre client, il s’enregistre auprès de Xata, ouvre une fenêtre de navigateur et vous demande de vous connecter à votre compte Xata et d’autoriser l’accès. Les jetons sont de courte durée et limités au serveur MCP.

Clé API

Les clients qui prennent en charge les en-têtes personnalisés peuvent s’authentifier à l’aide d’une clé API Xata :

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Créez une clé API dédiée à l’accès MCP plutôt que de réutiliser une clé existante. Stockez-la dans une variable d’environnement ou dans le gestionnaire de secrets de votre client — ne la validez jamais dans le contrôle de version.

Configurer votre client MCP

Cursor

[!TIP]

Cursor propose un lien direct pour configurer rapidement OAuth :

Ajouter à Cursor

Vous pouvez également l’ajouter manuellement :

Ouvrez la palette de commandes et recherchez « Cursor Settings ».
Sous Tools & MCP, cliquez sur New MCP Server.
Ajoutez le serveur Xata au fichier de configuration qui s’ouvre :

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Enregistrez le fichier. Cursor vous invite à vous authentifier — suivez les étapes dans le navigateur et autorisez l’accès à votre compte Xata.

Claude Code

Ajoutez le serveur depuis votre terminal :

claude mcp add --transport http xata https://api.xata.tech/mcp

Démarrez ensuite Claude Code et exécutez la commande slash /mcp. Sélectionnez le serveur xata et suivez les instructions du navigateur pour vous authentifier.

Pour utiliser une clé API plutôt qu’OAuth (par exemple, dans la CI) :

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

Les serveurs MCP dans VS Code nécessitent les extensions GitHub Copilot et GitHub Copilot Chat.

Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P).
Exécutez MCP: Add Server et choisissez HTTP.
Saisissez https://api.xata.tech/mcp comme URL et xata comme nom.

Vous pouvez également l’ajouter manuellement à votre configuration :

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Démarrez le serveur depuis MCP: List Servers et autorisez son authentification lorsque vous y êtes invité.

Claude (web et ordinateur)

[!TIP]

Ouvrez la boîte de dialogue des connecteurs personnalisés de Claude avec les informations de Xata déjà renseignées :

Connecter Xata à Claude

Vérifiez et confirmez le connecteur dans Claude, puis authentifiez-vous auprès de Xata.

Vous pouvez également ajouter Xata manuellement comme connecteur personnalisé :

Accédez à Settings → Connectors.
Cliquez sur Add custom connector.
Saisissez https://api.xata.tech/mcp comme URL du serveur et cliquez sur Add.
Suivez les instructions pour vous connecter à votre compte Xata.

[!NOTE]

Les connecteurs personnalisés utilisant MCP distant ne sont pas disponibles avec toutes les offres Claude et peuvent nécessiter l’intervention d’un propriétaire de l’organisation pour les ajouter aux offres d’équipe. Consultez la documentation de Claude pour en savoir plus.

ChatGPT

Connectez ChatGPT à Xata à l’aide d’un connecteur personnalisé :

Dans ChatGPT, accédez à Settings → Connectors → Advanced settings et activez Developer mode.
Dans l’onglet Connectors, créez un connecteur et saisissez l’URL du serveur :

https://api.xata.tech/mcp

Choisissez OAuth pour l’authentification et terminez le processus d’autorisation lorsque vous y êtes invité.
Dans chaque conversation où vous souhaitez utiliser Xata, cliquez sur le bouton + et activez le connecteur Xata sous Add sources.

Codex CLI

Ajoutez le serveur Xata :

codex mcp add xata --url https://api.xata.tech/mcp

[!NOTE]

La commande add peut ouvrir un navigateur et afficher une erreur OAuth. Si cela se produit, poursuivez avec la commande de connexion ci-dessous ; l’entrée du serveur xata a déjà été enregistrée.

Authentifiez-vous auprès de Xata en indiquant explicitement les portées OAuth :

codex mcp login xata --scopes mcp-client,offline_access

Terminez l’autorisation dans le navigateur. La portée offline_access permet à Codex de renouveler sa session Xata sans nécessiter une nouvelle autorisation dans le navigateur.

Démarrez ensuite codex, exécutez /mcp et vérifiez que xata est connecté et authentifié.

Antigravity CLI

Ajoutez Xata à votre configuration MCP globale :

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Pour activer Xata uniquement pour un projet, utilisez plutôt .agents/mcp_config.json à la racine de ce projet.

Démarrez agy et saisissez /mcp. Dans le gestionnaire MCP, utilisez Authenticate pour xata et suivez les instructions pour terminer l’authentification OAuth.

OpenCode

Ajoutez le serveur Xata à votre fichier de configuration OpenCode :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Authentifiez-vous ensuite depuis votre terminal :

opencode mcp auth xata

Amp

Ajoutez le serveur depuis votre terminal :

amp mcp add xata https://api.xata.tech/mcp

Démarrez ensuite amp — vous devriez être invité à vous authentifier dans le navigateur. Exécutez /mcp list tools pour confirmer que le serveur est connecté.

Windsurf

Dans Windsurf, ouvrez le panneau Cascade et cliquez sur l’icône MCP (marteau), puis sur Configure pour ouvrir le fichier de configuration brut (~/.codeium/windsurf/mcp_config.json).
Ajoutez l’entrée du serveur Xata :

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Enregistrez le fichier et cliquez sur Refresh dans la barre latérale Cascade. Terminez le processus OAuth lorsque la fenêtre du navigateur s’ouvre.

Zed

Ouvrez Settings → AI → MCP Servers et cliquez sur Add Server → Add Remote Server, ou modifiez directement votre fichier de paramètres :

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Zed vous invite à vous authentifier auprès du serveur via le processus OAuth MCP standard.

Cline

Ouvrez Cline dans VS Code et cliquez sur l’icône MCP Servers.
Dans l’onglet Remote Servers, saisissez xata comme nom, https://api.xata.tech/mcp comme URL et choisissez Streamable HTTP comme transport. Vous pouvez aussi modifier directement le JSON de configuration :

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

[!NOTE]

Le type de transport doit être streamableHttp (camelCase). Si vous l’omettez, Cline utilise le transport SSE hérité, qui n’est pas pris en charge par le serveur MCP Xata.

Autres clients MCP

Tout client MCP peut se connecter s’il prend en charge :

Les serveurs MCP distants via Streamable HTTP (et non SSE)
OAuth avec enregistrement dynamique du client, ou les en-têtes HTTP personnalisés pour l’authentification par clé API

Consultez la documentation de votre client pour savoir où configurer les serveurs MCP distants, et utilisez https://api.xata.tech/mcp comme URL.

Vérifier la connexion

Après la connexion, demandez à votre assistant :

Utilise le serveur MCP Xata pour trouver l’opération de l’API REST qui permet de répertorier les branches.

L’assistant devrait appeler search_operations avec {"query":"list branches"} et renvoyer l’opération listBranches, qui peut être invoquée via call_read_operation. Si c’est le cas, la connexion fonctionne.

Outils disponibles

Le serveur MCP Xata expose les outils suivants :

Outil	Description
`search_operations`	Trouver une opération de l’API REST Xata à partir d’une intention (par exemple, « répertorier les branches » ou « inviter un membre »).
`describe_operation`	Renvoyer les paramètres et les schémas de requête/réponse d’une opération spécifique.
`call_read_operation`	Invoquer une opération en lecture seule de l’API REST Xata.
`call_write_operation`	Invoquer une opération de l’API REST Xata qui crée ou met à jour des données.
`call_destructive_operation`	Invoquer une opération de l’API REST Xata qui détruit des données ou révoque un accès. Nécessite `confirm=true`.
`run_sql`	Exécuter du SQL sur une branche. En lecture seule par défaut ; les instructions qui modifient des données nécessitent à la fois `write=true` et `confirm=true`.
`describe_schema`	Répertorier les tables et les colonnes d’une branche.
`list_skills`	Répertorier les compétences Xata disponibles — des procédures guidées pour les tâches courantes en plusieurs étapes.
`get_skill`	Lire les instructions d’une compétence spécifique.
`search_xata`	Rechercher dans la documentation Xata.
`query_docs_filesystem_xata`	Lire les pages de documentation Xata par chemin.

Sécurité

Privilégiez OAuth pour les clients interactifs ; les jetons sont de courte durée et peuvent être révoqués en déconnectant le serveur dans votre client.
Pour l’automatisation, utilisez une clé API dédiée et renouvelez-la régulièrement.
Certains outils peuvent modifier vos données : call_write_operation et call_destructive_operation peuvent modifier ou supprimer des ressources (ce dernier nécessite confirm=true), et run_sql peut modifier des données lorsqu’il est appelé avec write=true et confirm=true. Examinez les actions proposées par votre assistant avant de les approuver et veillez à ce qu’une personne supervise toute écriture ou suppression.

Dépannage

L’authentification échoue sans cesse ou tourne en boucle. Supprimez le serveur Xata de votre client, redémarrez le client, puis ajoutez à nouveau le serveur pour lancer un nouveau processus OAuth.

Le navigateur affiche « Client not found » lors de l’authentification. Votre client MCP a peut-être enregistré une inscription OAuth qui n’est plus disponible sur le serveur d’authentification de Xata. Selon le client, supprimer puis ajouter à nouveau le serveur MCP peut ne pas effacer cette inscription. Effacez l’inscription OAuth enregistrée pour Xata dans votre client, puis redémarrez le serveur MCP Xata et authentifiez-vous à nouveau afin de permettre une nouvelle inscription.

Par exemple, dans VS Code :

Ouvrez la palette de commandes (Cmd+Shift+P / Ctrl+Shift+P).
Exécutez Authentication: Remove Dynamic Authentication Providers.
Sélectionnez le fournisseur associé à Xata, sans modifier les autres fournisseurs.
Redémarrez le serveur MCP Xata et terminez à nouveau l’authentification.

Le serveur se connecte, mais aucun outil n’apparaît. Vérifiez que vous avez terminé l’étape d’authentification — la plupart des outils nécessitent une session valide pour apparaître. Relancez le processus d’authentification de votre client, puis actualisez sa liste d’outils. Consultez Outils disponibles pour voir la liste complète.

Votre client ne parvient pas du tout à se connecter. Vérifiez que l’URL est exactement https://api.xata.tech/mcp et que votre client prend en charge Streamable HTTP. Les clients qui ne prennent en charge que SSE ne sont pas compatibles.

Le serveur n’apparaît pas dans votre client. Vérifiez la syntaxe du fichier de configuration MCP du client — la structure JSON varie selon les clients (mcpServers vs servers vs context_servers, url vs serverUrl) — et consultez les journaux du client. La plupart des clients nécessitent un redémarrage complet après toute modification de configuration.

Cette documentation est générée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.