Xata MCP server

Ir al contenido principal

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

​¿Qué es el servidor MCP de Xata?

• 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 HTTP transmitido.

URL del servidor:

https://api.xata.tech/mcp

El servidor usa el transporte HTTP transmitido. 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 MCP (registro dinámico de clientes)
Clave de API	Automatización, CI, agentes sin interfaz	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 en 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

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 incluyas en el control de código fuente.

​Configura tu cliente MCP

​Cursor

Cursor ofrece un enlace directo para una configuración rápida de OAuth:Añadir a Cursor

Alternativamente, puedes añadirlo manualmente:

1. Abre la paleta de comandos y busca “Configuración de Cursor”.
2. En Herramientas y MCP, haz clic en Nuevo servidor MCP.
3. Añade el servidor de Xata al archivo de configuración que se abre:

.cursor/mcp.json

{
  "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: Añadir servidor y elige HTTP.
3. Introduce https://api.xata.tech/mcp como la URL y xata como el nombre.

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

.vscode/mcp.json

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

Inicia el servidor desde MCP: Listar servidores y permite que se autentique cuando se te solicite.

​Claude (web y escritorio)

Añade Xata como un conector personalizado:

1. Ve a Configuración → Conectores.
2. Haz clic en Añadir conector personalizado.
3. Introduce https://api.xata.tech/mcp como la URL del servidor y haz clic en Añadir.
4. Sigue las indicaciones para iniciar sesión con tu cuenta de Xata.

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 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 Configuración → Conectores → Configuración avanzada y habilita el Modo desarrollador.
2. En la pestaña Conectores, 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 habilita el conector de Xata en Añadir fuentes.

​Codex CLI

Añade el servidor de Xata:

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

El comando add puede abrir un navegador y reportar un error de OAuth. Si eso sucede, 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 a Codex refrescar 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.

​Antigravity CLI

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

~/.gemini/config/mcp_config.json

{
  "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 Autenticar para xata y sigue las indicaciones para completar OAuth.

​OpenCode

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

~/.config/opencode/opencode.json

{
  "$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 debería 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 Configurar para abrir el archivo de configuración sin procesar (~/.codeium/windsurf/mcp_config.json).
2. Añade la entrada del servidor de Xata:

~/.codeium/windsurf/mcp_config.json

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

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

​Zed

1. Abre Configuración → IA → Servidores MCP y haz clic en Añadir servidor → Añadir servidor remoto, o edita tu archivo de configuración directamente:

settings.json

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

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

​Cline

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

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

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 sobre HTTP transmitido (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 la URL.

​Verifica la conexión

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

Usa el servidor MCP de Xata para decirme como quién estoy autenticado.

El asistente debería llamar a la herramienta user_info y devolver tu identidad de usuario (o la identidad de la clave de API, si te autenticaste con una clave). Si lo hace, la conexión está funcionando.

​Herramientas disponibles

El servidor MCP de Xata expone las siguientes herramientas:

Herramienta	Descripción
user_info	Devuelve la identidad del llamante autenticado — tu ID de usuario y correo electrónico para OAuth, o el ID de la clave de API.
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 esquemas de solicitud/respuesta para una operación específica.
call_read_operation	Invoca una operación de solo lectura de la API REST de Xata.
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 el acceso. Requiere confirm=true.
run_sql	Ejecuta SQL contra una rama. Solo lectura por defecto; pasa write=true para ejecutar sentencias que mutan datos.
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 para 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 automatización, usa una clave de API dedicada y rótala regularmente.
• 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 mutar datos cuando se llama con write=true. Revisa las acciones que tu asistente propone antes de aprobarlas, y mantén a un humano al tanto para cualquier escritura o eliminación.

​Solución de problemas

La autenticación sigue fallando o entra en bucle. Elimina el servidor de Xata de tu cliente, reinicia el cliente y añade el servidor de nuevo para desencadenar un flujo 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 refresca su lista de herramientas. Consulta Herramientas disponibles para 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 HTTP transmitido. Los clientes que solo admiten SSE no son compatibles. El servidor no aparece en tu cliente. Verifica 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.

¿Te fue útil esta página?

Anterior

Organizaciones

Siguiente