Xata MCP server

oficial

El servidor MCP de Xata permite que asistentes y agentes de IA interactúen con tus organizaciones, proyectos y ramas de bases de datos Postgres de Xata.

Ver en xata.io

¿Qué puedes hacer con Xata MCP?

Buscar operaciones de API — Pide a tu asistente que localice una operación de la API REST de Xata por intención, como listar ramas o invitar a un miembro.
Inspeccionar esquemas de operaciones — Obtén los parámetros y los esquemas de solicitud/respuesta de una operación específica de la API de Xata antes de llamarla.
Ejecutar llamadas de API de solo lectura — Invoca operaciones de solo lectura de la API REST de Xata, como listar ramas, a través de tu asistente.
Consultar ramas con SQL — Ejecuta SQL en una rama, de solo lectura de forma predeterminada, con escrituras que requieren confirmación explícita.
Explorar esquemas de ramas — Lista las tablas y columnas de una rama para comprender su estructura.
Buscar en la documentación de Xata — Busca en la documentación de Xata o lee páginas de documentación específicas por ruta.

Documentación

Servidor MCP

Conecta Cursor, Claude, VS Code y otros clientes MCP a Xata

El servidor Xata MCP permite que los asistentes y agentes de IA interactúen con tus organizaciones, proyectos y ramas de Xata mediante el Model Context Protocol (MCP).

¿Qué es el servidor Xata MCP?

Un servidor MCP alojado que se ejecuta junto a la API de Xata: no hay nada que instalar ni ejecutar localmente.
Autenticado mediante OAuth en tu navegador, o con una clave de API de Xata para entornos sin interfaz gráfica.
Accesible desde cualquier cliente MCP que admita servidores remotos a través de Streamable HTTP.

URL del servidor:

https://api.xata.tech/mcp

El servidor utiliza el transporte Streamable HTTP. No hay endpoint SSE ni versión local (npm) del servidor.

Autenticación

El servidor MCP admite dos métodos de autenticación:

Método	Cuándo usarlo	Requisito del cliente
OAuth	Uso interactivo en un editor/chat	Compatibilidad con OAuth de MCP (registro dinámico de clientes)
Clave de API	Automatización, CI, agentes sin interfaz gráfica	Compatibilidad con encabezados HTTP personalizados

OAuth

Con clientes compatibles con OAuth, solo necesitas la URL del servidor. Cuando tu cliente se conecta por primera vez, se registra con Xata, abre una ventana del navegador y te pide que inicies sesión en tu cuenta de Xata y apruebes el acceso. Los tokens son de corta duración y están limitados al servidor MCP.

Clave de API

Los clientes que admiten encabezados personalizados pueden autenticarse con una clave de API de Xata en su lugar:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Crea una clave de API dedicada para el acceso MCP en lugar de reutilizar una clave existente. Guárdala en una variable de entorno o en el almacenamiento de secretos de tu cliente; nunca la confirmes en el control de código fuente.

Configura tu cliente MCP

Cursor

[!TIP]

Cursor ofrece un enlace directo para una configuración rápida con OAuth:

Añadir a Cursor

Como alternativa, puedes añadirlo manualmente:

Abre la paleta de comandos y busca "Cursor Settings".
En Tools & MCP, haz clic en New MCP Server.
Añade el servidor Xata al archivo de configuración que se abre:

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

Guarda el archivo. Cursor te pedirá que te autentiques: sigue el flujo del navegador y aprueba el acceso a tu cuenta de Xata.

Claude Code

Añade el servidor desde tu terminal:

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

Después, inicia Claude Code y ejecuta el comando de barra /mcp. Selecciona el servidor xata y sigue las instrucciones del navegador para autenticarte.

Para usar una clave de API en lugar de OAuth (por ejemplo, en CI):

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

VS Code

Los servidores MCP en VS Code requieren las extensiones GitHub Copilot y GitHub Copilot Chat.

Abre la paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P).
Ejecuta MCP: Add Server y elige HTTP.
Introduce https://api.xata.tech/mcp como URL y xata como nombre.

Como alternativa, añádelo manualmente a tu configuración:

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

Inicia el servidor desde MCP: List Servers y permite que se autentique cuando se te solicite.

Claude (web y escritorio)

[!TIP]

Abre el diálogo de conectores personalizados de Claude con los datos de Xata ya rellenados:

Conectar Xata a Claude

Revisa y confirma el conector en Claude, y luego autentícate con Xata.

Como alternativa, añade Xata como conector personalizado manualmente:

Ve a Settings → Connectors.
Haz clic en Add custom connector.
Introduce https://api.xata.tech/mcp como URL del servidor y haz clic en Add.
Sigue las indicaciones para iniciar sesión con tu cuenta de Xata.

[!NOTE]

Los conectores personalizados que usan MCP remoto no están disponibles en todos los planes de Claude y pueden requerir que un propietario de la organización los añada en los planes de equipo. Consulta la documentación de Claude para más detalles.

ChatGPT

Conecta ChatGPT a Xata mediante un conector personalizado:

En ChatGPT, ve a Settings → Connectors → Advanced settings y activa Developer mode.
En la pestaña Connectors, crea un nuevo conector con la URL del servidor:

https://api.xata.tech/mcp

Elige OAuth para la autenticación y completa el flujo de autorización cuando se te solicite.
En cada chat en el que quieras usar Xata, haz clic en el botón + y activa el conector de Xata en Add sources.

Codex CLI

Añade el servidor Xata:

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

[!NOTE]

El comando add puede abrir un navegador y mostrar un error de OAuth. Si eso ocurre, continúa con el comando de inicio de sesión que aparece a continuación; la entrada del servidor xata ya se ha guardado.

Autentícate con Xata usando ámbitos OAuth explícitos:

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

Completa la autorización en el navegador. El ámbito offline_access permite que Codex renueve su sesión de Xata sin requerir otra autorización en el navegador.

Después, inicia codex, ejecuta /mcp y verifica que xata esté conectado y autenticado.

Antigravity CLI

Añade Xata a tu configuración global de MCP:

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

Para habilitar Xata solo en un proyecto, usa .agents/mcp_config.json en la raíz de ese proyecto en su lugar.

Inicia agy e introduce /mcp. En el MCP Manager, usa Authenticate para xata y sigue las indicaciones para completar OAuth.

OpenCode

Añade el servidor Xata a tu archivo de configuración de OpenCode:

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

Después, autentícate desde tu terminal:

opencode mcp auth xata

Amp

Añade el servidor desde tu terminal:

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

Después, inicia amp; debería pedirte que te autentiques en el navegador. Ejecuta /mcp list tools para confirmar que el servidor está conectado.

Windsurf

En Windsurf, abre el panel Cascade y haz clic en el icono de MCP (martillo), luego en Configure para abrir el archivo de configuración sin procesar (~/.codeium/windsurf/mcp_config.json).
Añade la entrada del servidor Xata:

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

Guarda el archivo y haz clic en Refresh en la barra lateral de Cascade. Completa el flujo de OAuth cuando se abra la ventana del navegador.

Zed

Abre Settings → AI → MCP Servers y haz clic en Add Server → Add Remote Server, o edita tu archivo de configuración directamente:

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

Zed te pedirá que te autentiques en el servidor mediante el flujo estándar de OAuth de MCP.

Cline

Abre Cline en VS Code y haz clic en el icono MCP Servers.
En la pestaña Remote Servers, introduce xata como nombre, https://api.xata.tech/mcp como URL y elige Streamable HTTP como transporte. O edita directamente el JSON de configuración:

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

[!NOTE]

El tipo de transporte debe ser streamableHttp (camelCase). Si se omite, Cline recurre al transporte SSE heredado, que el servidor Xata MCP no admite.

Otros clientes MCP

Cualquier cliente MCP puede conectarse si admite:

Servidores MCP remotos a través de Streamable HTTP (no SSE)
OAuth con registro dinámico de clientes, o encabezados HTTP personalizados para la autenticación con clave de API

Consulta la documentación de tu cliente para saber dónde configurar los servidores MCP remotos y usa https://api.xata.tech/mcp como URL.

Verifica la conexión

Después de conectarte, pide a tu asistente:

Usa el servidor Xata MCP para encontrar la operación de la API REST que lista las ramas.

El asistente debería llamar a search_operations con {"query":"list branches"} y devolver la operación listBranches, que se puede invocar mediante call_read_operation. Si lo hace, la conexión funciona.

Herramientas disponibles

El servidor Xata MCP expone las siguientes herramientas:

Herramienta	Descripción
`search_operations`	Encuentra una operación de la API REST de Xata por intención (por ejemplo, "list branches" o "invite member").
`describe_operation`	Devuelve los parámetros y los esquemas de solicitud/respuesta de una operación específica.
`call_read_operation`	Invoca una operación de la API REST de Xata de solo lectura.
`call_write_operation`	Invoca una operación de la API REST de Xata que crea o actualiza datos.
`call_destructive_operation`	Invoca una operación de la API REST de Xata que destruye datos o revoca acceso. Requiere `confirm=true`.
`run_sql`	Ejecuta SQL contra una rama. Solo lectura por defecto; las sentencias que modifican datos requieren tanto `write=true` como `confirm=true`.
`describe_schema`	Lista las tablas y columnas de una rama.
`list_skills`	Lista las habilidades de Xata disponibles: flujos de trabajo guiados para tareas comunes de varios pasos.
`get_skill`	Lee las instrucciones de una habilidad específica.
`search_xata`	Busca en la documentación de Xata.
`query_docs_filesystem_xata`	Lee páginas de la documentación de Xata por ruta.

Seguridad

Prefiere OAuth para clientes interactivos; los tokens son de corta duración y se pueden revocar desconectando el servidor en tu cliente.
Para la automatización, usa una clave de API dedicada y rótala con regularidad.
Algunas herramientas pueden modificar tus datos: call_write_operation y call_destructive_operation pueden cambiar o eliminar recursos (esta última requiere confirm=true), y run_sql puede modificar datos cuando se llama con write=true y confirm=true. Revisa las acciones que propone tu asistente antes de aprobarlas y mantén a una persona en el bucle para cualquier escritura o eliminación.

Solución de problemas

La autenticación sigue fallando o entra en bucle. Elimina el servidor Xata de tu cliente, reinicia el cliente y vuelve a añadir el servidor para activar un nuevo flujo de OAuth.

La autenticación muestra "Client not found" en el navegador. Es posible que tu cliente MCP tenga un registro OAuth guardado que ya no está disponible en el servidor de autenticación de Xata. Según el cliente, eliminar y volver a añadir el servidor MCP puede dejar intacto este registro. Borra el registro OAuth guardado de Xata en tu cliente, luego reinicia el servidor Xata MCP y autentícate de nuevo para permitir un registro nuevo.

Por ejemplo, en VS Code:

Abre la paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P).
Ejecuta Authentication: Remove Dynamic Authentication Providers.
Selecciona el proveedor asociado con Xata, dejando sin cambios los proveedores no relacionados.
Reinicia el servidor Xata MCP y completa la autenticación de nuevo.

El servidor se conecta pero no aparecen herramientas. Asegúrate de haber completado el paso de autenticación: la mayoría de las herramientas requieren una sesión válida antes de aparecer. Vuelve a ejecutar el flujo de autenticación de tu cliente y luego actualiza su lista de herramientas. Consulta Herramientas disponibles para ver el conjunto completo.

Tu cliente no puede conectarse en absoluto. Confirma que la URL es exactamente https://api.xata.tech/mcp y que tu cliente admite Streamable HTTP. Los clientes que solo admiten SSE no son compatibles.

El servidor no aparece en tu cliente. Comprueba la sintaxis del archivo de configuración MCP del cliente: la forma del JSON difiere entre clientes (mcpServers vs servers vs context_servers, url vs serverUrl) — y revisa los registros del cliente. La mayoría de los clientes requieren un reinicio completo después de cambios en la configuración.

Esta documentación está creada y alojada en Mintlify, una plataforma de documentación para desarrolladores.