Conecta herramientas de IA a Espobase
El conector de Espobase permite que Claude, ChatGPT, Cursor, VS Code y otras herramientas compatibles con el Model Context Protocol (MCP) trabajen con tus proyectos: leer el esquema y la referencia de API, generar tipos, ejecutar consultas de solo lectura, revisar registros y uso, y proponer cambios en la base de datos que tú apruebas.
Conectar
Claude (claude.ai, Claude Desktop) y ChatGPT: agrega un conector personalizado con la URL del servidor que aparece abajo y haz clic en Conectar. Inicias sesión en Espobase (correo, GitHub, Google, Apple o SSO), revisas lo que la herramienta puede hacer y autorizas el acceso. No hay claves que copiar.
https://app.espobase.com/api/mcp
En Claude: Settings › Connectors › Add custom connector. En ChatGPT: Settings › Connectors (o Apps).
Claude Code, Cursor, VS Code y otros clientes MCP: crea un token de acceso personal en el panel (Configuración de la cuenta › Desarrollador), donde también encontrarás la configuración lista para pegar de cada herramienta. Por ejemplo, en Claude Code:
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
Necesitas una cuenta de Espobase; el conector funciona en todos los planes.
Lo que una herramienta conectada puede y no puede hacer
- Actúa como tú: solo en las organizaciones y proyectos a los que tienes acceso, con tu rol.
- Solo ve lo que permitiste en la pantalla de consentimiento (por ejemplo, el esquema, los registros o SQL de solo lectura).
- El SQL siempre es de solo lectura: las instrucciones que cambiarían datos o la estructura se rechazan, aunque seas el propietario del proyecto.
- Puede proponer cambios en la base de datos, pero nunca aplicarlos. Tú revisas el SQL y lo aplicas desde la pestaña de IA de tu proyecto.
- Nunca recibe contraseñas de base de datos, claves secretas de API ni otras credenciales.
- Puedes desconectarla en cualquier momento en Configuración de la cuenta › Desarrollador › Apps conectadas; el acceso termina de inmediato.
Herramientas
| whoami | Tu cuenta de Espobase y tus organizaciones. |
| list_projects | Los proyectos a los que tienes acceso, con estado, entorno, región y tu rol. |
| get_project | Los detalles de un proyecto. |
| get_schema | Tablas, columnas, relaciones, seguridad a nivel de fila y políticas (solo la estructura). |
| get_api_reference | Endpoints REST, filtros, autenticación y uso del SDK para escribir código del cliente. |
| generate_typescript_types | espobase.types.ts para consultas tipadas con @espobase/client. |
| run_read_only_sql | Consultas SELECT, ejecutadas con el usuario de solo lectura de la base de datos del proyecto. |
| get_logs | Registros de solicitudes recientes (rutas, estado, tiempos; nunca cuerpos ni secretos). |
| get_usage | Solicitudes a la API, ancho de banda, almacenamiento de base de datos y de archivos, uso de IA. |
| list_storage | Buckets, carpetas y nombres de archivos (no su contenido). |
| propose_schema_change | Un plan (tablas, relaciones, políticas…) y su SQL, para que lo revises y lo apliques. |
| create_project | Un proyecto nuevo, si permitiste la creación de proyectos. |
Cosas que puedes pedir
- “Lista mis proyectos de Espobase y resume el esquema de la base de datos de mi proyecto principal.”
- “¿Qué tablas de mi proyecto tienen seguridad a nivel de fila pero todavía no tienen políticas?”
- “Escribe una página de Next.js que liste los últimos 20 pedidos de mi proyecto de Espobase usando @espobase/client.”
- “¿Cuántas solicitudes a la API atendió mi proyecto esta semana y hubo errores en los registros?”
- “Propón una tabla todos en la que cada usuario que inició sesión solo vea sus propias tareas.”
Tus datos
Cuando le preguntas algo a tu herramienta de IA, el conector devuelve la respuesta a esa herramienta: por ejemplo, nombres de tablas y columnas, resultados de consultas, entradas de registro o nombres de archivos. Luego, el proveedor de IA trata ese contenido según sus propios términos y su política de privacidad. Espobase nunca recibe tu conversación con la herramienta de IA. Solo recibe lo que envía cada llamada a una herramienta: por ejemplo, la consulta SQL que hay que ejecutar o, en propose_schema_change, tu solicitud de cambio, que se guarda en el historial de IA del proyecto igual que las solicitudes escritas en el panel. Las llamadas a herramientas se registran (qué endpoint, cuándo y el estado del resultado) por seguridad y para auditoría.
Lee la política de privacidad de Espobase para saber cómo tratamos tu información.
Solución de problemas
- Una herramienta dice que falta un permiso (scope): desconéctala y vuelve a conectarla (o crea un token con ese permiso).
- Tu organización exige inicio de sesión único (SSO): inicia sesión en Espobase con SSO antes de conectar.
- Un proyecto no aparece en la lista: puede que solo tengas acceso a algunos proyectos; pregúntale a un administrador de la organización.
¿Necesitas ayuda? Contacta a soporte.