Xata MCP server

Servidor MCP

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

El servidor MCP de Xata permite que asistentes de IA y agentes interactúen con tus organizaciones, proyectos y ramas de Xata utilizando el Protocolo de Contexto de Modelo (MCP).

¿Qué es el servidor MCP de Xata?

• Un servidor MCP alojado que se ejecuta junto con 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 HTTP Streamable.

URL del servidor:

https://api.xata.tech/mcp

El servidor utiliza el transporte HTTP Streamable. No hay un endpoint SSE ni una 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	Soporte para OAuth de MCP (registro dinámico de clientes)
Clave de API	Automatización, CI, agentes sin interfaz gráfica	Soporte para cabeceras HTTP personalizadas

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 cabeceras personalizadas pueden autenticarse con una clave de API de Xata en su lugar:

Authorization: Bearer YOUR_XATA_API_KEY

Advertencia

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 secreto de tu cliente; nunca la confirmes en el control de versiones.

Configura tu cliente MCP

Cursor

Consejo

Cursor ofrece un enlace profundo para una configuración rápida de OAuth:

<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' }}>Añadir a Cursor

Alternativamente, puedes añadirlo manualmente:

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

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

4. 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

Luego 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.

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

Alternativamente, añádelo a tu configuración manualmente:

{
  "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)

Consejo

Abre el diálogo de conector personalizado de Claude con los detalles de Xata prellenados:

<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' }}>Conectar Xata a Claude

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

Alternativamente, añade Xata como conector personalizado manualmente:

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

Nota

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

ChatGPT

Conecta ChatGPT a Xata usando un conector personalizado:

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

https://api.xata.tech/mcp

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

CLI de Codex

Añade el servidor de Xata:

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

Nota

El comando add puede abrir un navegador y reportar un error de OAuth. Si eso ocurre, continúa con el comando de inicio de sesión 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 actualice su sesión de Xata sin requerir otra autorización del navegador.

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

CLI de Antigravity

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

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

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

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

OpenCode

Añade el servidor de 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"
    }
  }
}

Luego 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

Luego inicia amp: se te pedirá que te autentiques en el navegador. Ejecuta /mcp list tools para confirmar que el servidor está conectado.

Windsurf

1. 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).
2. Añade la entrada del servidor de Xata:

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

3. 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

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

2. Zed te pedirá que te autentiques contra el servidor usando el flujo estándar de OAuth de MCP.

Cline

1. Abre Cline en VS Code y haz clic en el icono de MCP Servers.
2. 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 el JSON de configuración directamente:

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

Nota

El tipo de transporte debe ser streamableHttp (camelCase). Omitirlo hace que Cline recurra al transporte SSE heredado, que el servidor MCP de Xata no admite.

Otros clientes MCP

Cualquier cliente MCP puede conectarse si admite:

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

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

Verifica la conexión

Después de conectarte, pregúntale a tu asistente:

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

El asistente debería llamar a search_operations con {"query":"list branches"} y devolver la operación listBranches, que se puede invocar a través de call_read_operation. Si lo hace, la conexión está funcionando.

Herramientas disponibles

El servidor MCP de Xata expone las siguientes herramientas:

Herramienta	Descripción
search_operations	Encuentra una operación de la API REST de Xata por intención (por ejemplo, "listar ramas" o "invitar miembro").
describe_operation	Devuelve los parámetros y los esquemas de solicitud/respuesta para 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 declaraciones que mutan datos requieren tanto write=true como confirm=true.
describe_schema	Lista las tablas y columnas de una rama.
list_skills	Lista las habilidades disponibles de Xata: flujos de trabajo guiados para tareas comunes de varios pasos.
get_skill	Lee las instrucciones para una habilidad específica.
search_xata	Busca en la documentación de Xata.
query_docs_filesystem_xata	Lee páginas de 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 automatización, usa una clave de API dedicada y gírala regularmente.
• Algunas herramientas pueden modificar tus datos: call_write_operation y call_destructive_operation pueden cambiar o eliminar recursos (la última requiere confirm=true), y run_sql puede mutar datos cuando se llama con ambos write=true y confirm=true. Revisa las acciones que tu asistente propone antes de aprobarlas y mantén a un humano en el circuito para cualquier escritura o eliminación.

Solución de problemas

La autenticación falla o se repite en bucle. Elimina el servidor de Xata de tu cliente, reinicia el cliente y vuelve a añadir el servidor para activar un flujo de OAuth 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 sea exactamente https://api.xata.tech/mcp y que tu cliente admita HTTP Streamable. Los clientes solo compatibles con SSE no son compatibles.

El servidor no aparece en tu cliente. Revisa 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 los cambios de configuración.