Xata MCP server

Serveur MCP

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

Le serveur MCP Xata permet aux assistants IA et aux agents d'interagir avec vos organisations, projets et branches Xata en utilisant le Model Context Protocol (MCP).

Qu'est-ce que le serveur MCP Xata ?

• Un serveur MCP hébergé qui fonctionne aux côtés de l'API Xata — rien à installer ou à exécuter localement.
• Authentifié via OAuth dans votre navigateur, ou avec une clé API Xata pour les environnements sans interface graphique.
• 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'y a 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	Utilisation	Exigence du client
OAuth	Utilisation interactive dans un éditeur/chat	Prise en charge de l'OAuth MCP (enregistrement dynamique du client)
Clé API	Automatisation, CI, agents sans interface graphique	Prise en charge des en-têtes HTTP personnalisés

OAuth

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

Clé API

Les clients prenant en charge les en-têtes personnalisés peuvent s'authentifier avec une clé API Xata à la place :

Authorization: Bearer YOUR_XATA_API_KEY

Avertissement

Créez une clé API dédiée pour l'accès MCP plutôt que de réutiliser une clé existante. Stockez-la dans une variable d'environnement ou dans le stockage secret de votre client — ne la commettez jamais dans le contrôle de source.

Configurer votre client MCP

Cursor

Astuce

Cursor propose un lien profond pour une configuration OAuth rapide :

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=xata&config=eyJ1cmwiOiJodHRwczovL2FwaS54YXRhLnRlY2gvbWNwIn0%3D" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', backgroundColor: '#111111', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}>

<span style={{ color: '#ffffff' }}>Ajouter à Cursor

Alternativement, vous pouvez l'ajouter manuellement :

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

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

4. Enregistrez le fichier. Cursor vous invite à vous authentifier — suivez le flux du navigateur et approuvez 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

Ensuite, démarrez 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 au lieu d'OAuth (par exemple, en 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.

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

Alternativement, ajoutez-le à votre configuration manuellement :

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

Démarrez le serveur depuis MCP: List Servers et autorisez-le à s'authentifier lorsque vous y êtes invité.

Claude (web et bureau)

Astuce

Ouvrez la boîte de dialogue du connecteur personnalisé de Claude avec les détails de Xata préremplis :

<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Xata&connectorUrl=https%3A%2F%2Fapi.xata.tech%2Fmcp" style={{ display: 'inline-flex', alignItems: 'center', padding: '8px 12px', backgroundColor: '#735adc', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}> <span style={{ color: '#ffffff' }}>Connecter Xata à Claude

Examinez et confirmez le connecteur dans Claude, puis authentifiez-vous avec Xata.

Alternativement, ajoutez Xata comme connecteur personnalisé manuellement :

1. Allez dans Settings → Connectors.
2. Cliquez sur Add custom connector.
3. Saisissez https://api.xata.tech/mcp comme URL du serveur et cliquez sur Add.
4. Suivez les invites pour vous connecter avec votre compte Xata.

Remarque

Les connecteurs personnalisés utilisant MCP distant ne sont pas disponibles sur tous les plans Claude, et peuvent nécessiter qu'un propriétaire d'organisation les ajoute sur les plans d'équipe. Voir la documentation Claude pour plus de détails.

ChatGPT

Connectez ChatGPT à Xata en utilisant un connecteur personnalisé :

1. Dans ChatGPT, allez dans Settings → Connectors → Advanced settings et activez Developer mode.
2. Sur l'onglet Connectors, créez un nouveau connecteur avec l'URL du serveur :

https://api.xata.tech/mcp

3. Choisissez OAuth pour l'authentification et terminez le flux d'autorisation lorsque vous y êtes invité.
4. 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

Remarque

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

Authentifiez-vous avec Xata en utilisant des portées OAuth explicites :

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

Terminez l'autorisation dans le navigateur. La portée offline_access permet à Codex de rafraîchir sa session Xata sans nécessiter une autre autorisation du navigateur.

Ensuite, démarrez 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 .agents/mcp_config.json à la racine de ce projet à la place.

Démarrez agy et saisissez /mcp. Dans le MCP Manager, utilisez Authenticate pour xata et suivez les invites pour terminer l'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"
    }
  }
}

Ensuite, authentifiez-vous depuis votre terminal :

opencode mcp auth xata

Amp

Ajoutez le serveur depuis votre terminal :

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

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

Windsurf

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

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

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

Zed

1. 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"
    }
  }
}

2. Zed vous invite à vous authentifier auprès du serveur en utilisant le flux OAuth MCP standard.

Cline

1. Ouvrez Cline dans VS Code et cliquez sur l'icône MCP Servers.
2. Dans l'onglet Remote Servers, saisissez xata comme nom, https://api.xata.tech/mcp comme URL et choisissez Streamable HTTP comme transport. Ou modifiez directement le JSON de configuration :

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

Remarque

Le type de transport doit être streamableHttp (camelCase). Son omission fait que Cline revient au transport SSE hérité, que le serveur MCP Xata ne prend pas en charge.

Autres clients MCP

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

• Les serveurs MCP distants via Streamable HTTP (pas SSE)
• OAuth avec enregistrement dynamique du client, ou 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 :

Utilisez le serveur MCP Xata pour trouver l'opération de l'API REST pour lister les branches.

L'assistant doit 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 par intention (par exemple, « lister les branches » ou « inviter un membre »).
describe_operation	Renvoyer les paramètres et les schémas de requête/réponse pour une opération spécifique.
call_read_operation	Invoquer une opération de l'API REST Xata en lecture seule.
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 l'accès. Nécessite confirm=true.
run_sql	Exécuter SQL sur une branche. Lecture seule par défaut ; les instructions qui modifient les données nécessitent à la fois write=true et confirm=true.
describe_schema	Lister les tables et colonnes d'une branche.
list_skills	Lister les compétences Xata disponibles — des flux de travail guidés pour les tâches courantes en plusieurs étapes.
get_skill	Lire les instructions pour 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 faites-la pivoter 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 à la fois write=true et confirm=true. Examinez les actions proposées par votre assistant avant de les approuver, et gardez un humain dans la boucle pour toute écriture ou suppression.

Dépannage

L'authentification échoue ou boucle. Supprimez le serveur Xata de votre client, redémarrez le client et ajoutez à nouveau le serveur pour déclencher un nouveau flux OAuth.

Le serveur se connecte mais aucun outil n'apparaît. Assurez-vous d'avoir terminé l'étape d'authentification — la plupart des outils nécessitent une session valide avant d'apparaître. Relancez le flux d'authentification de votre client, puis actualisez sa liste d'outils. Voir Outils disponibles pour l'ensemble complet.

Votre client ne peut pas se connecter du tout. Confirmez que l'URL est exactement https://api.xata.tech/mcp et que votre client prend en charge Streamable HTTP. Les clients uniquement SSE ne sont pas pris en charge.

Le serveur n'apparaît pas dans votre client. Vérifiez la syntaxe du fichier de configuration MCP du client — la forme JSON diffère entre les clients (mcpServers vs servers vs context_servers, url vs serverUrl) — et vérifiez les journaux du client. La plupart des clients nécessitent un redémarrage complet après les modifications de configuration.