Servidor MCP

Un servidor Model Context Protocol publicado como @capydb/mcp. Se ejecuta en local por stdio, o en remoto en https://mcp.capydb.dev/mcp por Streamable HTTP, y llama a la misma API del plano de control que el panel y la CLI, con el mismo alcance de organización, los mismos permisos y el mismo registro de auditoría.

Incluye un cliente escrito a mano en lugar de depender del SDK en tiempo de ejecución, así que la instalación es pequeña y el arranque inmediato.

Claude en la web, en el escritorio y en el móvil (y cualquier cliente que admita servidores MCP remotos) se conecta a https://mcp.capydb.dev/mcp. No hay nada que instalar ni ninguna clave que pegar: la primera vez que una herramienta necesita tu cuenta, el cliente te lleva al inicio de sesión de CapyDB en el navegador, donde eliges el espacio de trabajo que puede usar. Las bases de datos efímeras desechables funcionan antes de iniciar sesión.

La conexión es una clave de API de agente, que aparece en Ajustes → Claves de API y puedes revocar en cualquier momento. Caduca a los 90 días y entonces el cliente te pide que vuelvas a conectar. En Claude Code, añade la misma URL con el comando de abajo.

claude mcp add --transport http capydb https://mcp.capydb.dev/mcp

Añádelo a la configuración de servidores de cualquier cliente MCP. El servidor gestiona la autenticación por su cuenta: en el primer uso sin clave devuelve una URL de inicio de sesión por dispositivo para que la apruebes en el navegador.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

• -Claude en la web, en el escritorio y en el móvil a través del servidor remoto; Claude Code en remoto o en local
• -Cursor, Windsurf y otros editores con soporte MCP
• -Cualquier cliente que implemente el Model Context Protocol por stdio o Streamable HTTP: el servidor atiende tanto la revisión actual del protocolo como la anterior
• -Tu propio agente, a través de cualquier SDK de MCP

• -Proyectos: listar, crear e inspeccionar; bases de datos efímeras que puedes reclamar o destruir
• -Conexiones: obtener cadenas de conexión directas y con pooler, y las credenciales del almacén K/V
• -SQL: consultas de solo lectura y, en una herramienta aparte, sentencias que cambian datos, con resultados devueltos como JSON estructurado
• -Esquema: inspeccionar tablas, columnas, índices y extensiones
• -Previews: crear, listar, restablecer y eliminar bases de preview
• -Backups: crear y listar backups, exportar volcados, crear puntos de restauración, restaurar en una preview
• -Importaciones: iniciar y seguir una importación desde otro proveedor
• -Operación: uso, logs, observabilidad, alertas, jobs y recomendaciones de índices

Las herramientas de solo lectura se declaran de solo lectura y las destructivas se declaran destructivas, de modo que un cliente puede restringirlas. Un UPDATE o DELETE sin WHERE, o un TRUNCATE, lo rechaza el plano de control antes de ejecutarse, y el rechazo le dice al agente cómo corregir la llamada; el servidor MCP nunca se salta esa comprobación. Para cualquier cosa más arriesgada, la descripción de la herramienta le indica al agente que cree antes un punto de restauración.

Restaurar sobre una base de datos de producción no se expone como herramienta a propósito. Un agente puede restaurar en una preview y la promueves tú; no puede sobrescribir tus datos de producción por iniciativa propia.

Todo lo que el servidor dice sobre sí mismo va a la salida de error estándar, porque la salida estándar es el canal del protocolo. Si un cliente muestra una lista de herramientas vacía, la respuesta casi siempre está en el registro MCP del cliente y no en el servidor.