Usa Catalyst desde Claude, ChatGPT y tu IDE (MCP)
Cómo conectar Catalyst a Claude, ChatGPT, Claude Code, Cursor o VS Code mediante su servidor MCP, qué puede hacer el asistente y qué no puede tocar nunca.
· 9 min read
Catalyst tiene un servidor MCP. Una vez conectado, puedes preguntarle al asistente de IA que ya usas por la calidad de tus datos, en lenguaje normal, y te responde a partir de tu espacio de trabajo de Catalyst:
- "¿Qué datasets fallaron anoche y por qué?"
- "Añade una regla not-null en
customers.emaily vuelve a ejecutar la comprobación." - "Muéstrame el contrato actual de
ordersy sugiere las reglas que faltan." - "Busca duplicados en
contactsy resume los grupos más grandes."
Esta página es la guía de configuración. Cubre cada cliente compatible, los tokens de acceso personal, la lista completa de herramientas, el plan que necesitas y lo que el asistente no puede hacer.
Qué es MCP
El Model Context Protocol (MCP) es un estándar abierto que permite a un asistente de IA llamar a herramientas de otro producto. Catalyst publica un conjunto de herramientas (listar datasets, leer un contrato, lanzar una ejecución, etc.) y el asistente decide a cuáles llamar para responder a tu pregunta.
El servidor lo aloja Catalyst. Lo conectas con una URL y no hay nada que instalar:
https://ctlst.eu/mcp
Hay dos formas de iniciar sesión. Los clientes compatibles con OAuth (claude.ai, Claude Desktop y ChatGPT) abren una página de inicio de sesión de Catalyst, donde eliges el espacio de trabajo y el nivel de acceso. Los que no lo son, o donde una cabecera resulta más sencilla (Claude Code, Cursor, VS Code), usan un token de acceso personal.
Conectar claude.ai o Claude Desktop
- Abre Settings → Connectors y elige Add custom connector.
- Ponle un nombre, por ejemplo "Catalyst", y pega
https://ctlst.eu/mcpcomo URL. - Pulsa conectar. Se abre una página de Catalyst. Inicia sesión si aún no lo has hecho.
- Elige el espacio de trabajo que puede usar el asistente y escoge lectura o lectura y escritura. La escritura solo aparece si tu rol en ese espacio de trabajo es Editor o Admin.
- Aprueba. Vuelves a Claude y las herramientas de Catalyst están disponibles en los chats nuevos.
Un conector añadido en claude.ai también está disponible en Claude Desktop si inicias sesión con la misma cuenta.
Conectar ChatGPT
- En los ajustes de ChatGPT, activa el modo desarrollador para los conectores.
- Crea un conector personalizado, llámalo "Catalyst" y usa
https://ctlst.eu/mcpcomo URL del servidor, con OAuth como método de autenticación. - ChatGPT abre la misma página de consentimiento de Catalyst: inicia sesión, elige un espacio de trabajo, escoge lectura o lectura y escritura, y aprueba.
- Activa el conector en un chat y haz tu pregunta.
ChatGPT normalmente te pide confirmación antes de ejecutar una herramienta que cambia algo, como añadir una regla.
Crear un token de acceso personal
Claude Code, Cursor y VS Code envían un token en una cabecera Authorization. Para crear uno:
- En Catalyst, ve a Settings → AI assistants.
- Crea un token. Dale un nombre que reconozcas más adelante, como "Cursor en mi portátil".
- Elige el alcance: read (lectura) o write (escritura). La escritura requiere el rol Editor o Admin.
- Elige cuánto dura. Por defecto son 90 días, y puedes escoger cualquier valor entre 1 y 365 días. Los tokens siempre caducan.
- Copia el token. Empieza por
cat_pat_y solo se muestra una vez. Catalyst guarda un hash, así que no puede volver a enseñártelo.
Un token te pertenece a ti y a un único espacio de trabajo. Nunca tiene más permisos que tu rol en ese espacio de trabajo y deja de funcionar si sales de él. Puedes revocarlo en cualquier momento desde la misma página, donde los administradores también ven y pueden revocar todos los tokens del espacio de trabajo.
Trata el token como una contraseña. No lo incluyas en archivos que subas a Git.
Conectar Claude Code
Ejecuta esto una vez, con tu token en lugar de <token>:
claude mcp add --transport http catalyst https://ctlst.eu/mcp --header "Authorization: Bearer <token>"
Después abre Claude Code y pregunta por tu espacio de trabajo. claude mcp list muestra si el servidor está conectado.
Conectar Cursor
Añade Catalyst a ~/.cursor/mcp.json (para todos los proyectos) o a .cursor/mcp.json (para un proyecto):
{
"mcpServers": {
"catalyst": {
"url": "https://ctlst.eu/mcp",
"headers": {
"Authorization": "Bearer <token>"
}
}
}
}
Reinicia Cursor o recarga sus ajustes de MCP, y las herramientas de Catalyst aparecen en la lista de herramientas del agente.
Conectar VS Code
VS Code lee .vscode/mcp.json en tu proyecto. Esta versión pide el token una vez y lo mantiene fuera del archivo:
{
"inputs": [
{
"type": "promptString",
"id": "catalyst-token",
"description": "Catalyst personal access token",
"password": true
}
],
"servers": {
"catalyst": {
"type": "http",
"url": "https://ctlst.eu/mcp",
"headers": {
"Authorization": "Bearer ${input:catalyst-token}"
}
}
}
}
Inicia el servidor desde el archivo o desde la paleta de comandos, pega el token cuando te lo pida y usa Catalyst desde el modo agente de Copilot.
Qué puede hacer el asistente
Cada herramienta indica al cliente si solo lee o también cambia algo, así que los clientes pueden ejecutar las lecturas directamente y preguntarte antes de una escritura.
Herramientas de lectura (todos los planes)
| Herramienta | Qué hace |
|---|---|
get_workspace_overview | La puntuación de salud del espacio de trabajo y sus cifras principales |
list_datasets | Los datasets del espacio de trabajo |
get_dataset | Un dataset y sus detalles |
get_contract | El contrato ODCS actual de un dataset, en YAML |
list_contract_versions | Las versiones guardadas de un contrato |
diff_contract_versions | Qué cambió entre dos versiones de un contrato |
validate_contract | Comprueba un contrato sin guardarlo |
list_rules | Las reglas de un dataset |
list_runs | Las ejecuciones de validación recientes |
get_run | Una ejecución con el resultado de cada comprobación |
wait_for_run | Espera hasta 60 segundos a que termine una ejecución |
get_rule_suggestions | Las reglas que Catalyst propone a partir de las columnas del dataset |
list_duplicate_checks | Las comprobaciones de duplicados del espacio de trabajo (Team y Enterprise, como en la aplicación) |
get_duplicate_check | Una comprobación de duplicados y sus resultados (Team y Enterprise) |
get_quality_report | El informe de calidad (Team y Enterprise, como en la aplicación) |
Herramientas de escritura (Team y Enterprise)
| Herramienta | Qué hace |
|---|---|
trigger_run | Lanza una ejecución de validación. Cuenta para tu cuota mensual de ejecuciones. |
add_rule | Añade una regla a un dataset |
update_rule | Cambia una regla existente |
save_contract | Guarda una versión nueva del contrato de un dataset |
start_duplicate_scan | Inicia una búsqueda de duplicados |
Las herramientas de escritura necesitan un token o un inicio de sesión con acceso de escritura, el rol Editor o Admin, y un plan Team o Enterprise. Las ejecuciones lanzadas así aparecen en el historial con el origen "AI assistant".
El servidor incluye además dos prompts que los clientes pueden ofrecer como atajos: triage_failed_run, que repasa una ejecución fallida, y harden_contract, que revisa un contrato y propone las reglas que faltan.
Planes
| Starter (gratis) | Team | Enterprise | |
|---|---|---|---|
| Herramientas de lectura | Sí | Sí | Sí |
| Herramientas de escritura (ejecuciones, reglas, contratos, búsquedas de duplicados) | No | Sí | Sí |
Las ejecuciones lanzadas por un asistente cuentan para la misma cuota mensual que las que lanzas desde la aplicación. Catalyst no cobra por la parte de IA: el modelo se ejecuta en tu propia cuenta de Claude, ChatGPT o de tu IDE.
Seguridad y privacidad
El asistente trabaja con los mismos permisos que tú en la aplicación, y hay cosas que quedan fuera de su alcance sea cual sea el token o el rol.
- Las muestras de filas fallidas están desactivadas por defecto. El asistente ve los resultados pass y fail y los recuentos de violaciones, no las filas en sí. Un administrador del espacio de trabajo puede activar las muestras en Settings → AI assistants, y entonces el asistente recibe hasta cinco filas de ejemplo por comprobación, con los valores largos recortados. Las comprobaciones de duplicados siguen el mismo ajuste: sin él, el asistente solo ve recuentos y puntuaciones.
- Sin credenciales de conexión. Ninguna herramienta puede crear, leer ni probar una conexión, así que las contraseñas y claves de tu almacén nunca llegan al asistente.
- Sin borrados. No hay ninguna herramienta que borre nada.
- Sin reglas de SQL personalizado. El asistente puede leer y ejecutar las reglas de SQL personalizado que ya existen, pero no puede crear ni cambiar ninguna, y se rechaza un contrato que añada o edite una.
- Todo queda auditado. Cada cambio hecho a través del asistente aparece en el registro de auditoría, con el cliente que lo hizo.
- Los tokens caducan y se pueden revocar. Duran 90 días por defecto y 365 como máximo. Puedes revocar un token o una aplicación conectada (claude.ai, ChatGPT) en cualquier momento en Settings → AI assistants.
Cuando tu asistente obtiene datos de Catalyst, esos datos van a tu proveedor de IA porque tú lo pediste. Se tratan conforme a tu propio acuerdo con ese proveedor. Consulta la política de privacidad para más detalles.
Prompts de ejemplo
Algunos que funcionan bien:
- "Dame un resumen del espacio de trabajo. ¿Qué datasets fallan y desde cuándo?"
- "¿Por qué falló la última ejecución de
orders? Muestra las comprobaciones que fallaron y qué comprueban." - "Compara las dos últimas versiones del contrato de
customers." - "Mira las sugerencias de reglas para
invoicesy añade las que tratan de columnas obligatorias." (acceso de escritura) - "Ejecuta las comprobaciones de
ordersy avísame cuando terminen." (acceso de escritura) - "¿Tiene
total_amountdeordersuna regla de rango? Si no, propón una en ODCS."
Preguntas frecuentes
¿Está Catalyst en el directorio de conectores de Claude o de ChatGPT?
Todavía no. Por ahora lo añades tú como conector personalizado con la URL https://ctlst.eu/mcp, lo que lleva un minuto.
¿Qué plan necesito?
Cualquiera. Consultar datasets, contratos, reglas y ejecuciones funciona en el plan gratuito Starter. Las comprobaciones de duplicados y el informe de calidad son funciones de Team y Enterprise, tanto en el asistente como en la aplicación. Lanzar ejecuciones, añadir o editar reglas, guardar contratos e iniciar búsquedas de duplicados requiere Team o Enterprise.
¿Puede el asistente ver mis datos?
Ve lo que Catalyst guarda sobre tus datos: nombres de datasets y columnas, contratos, reglas, resultados de ejecuciones y recuentos de violaciones. Las muestras de filas fallidas solo se incluyen si un administrador del espacio de trabajo las activa. Nunca ve las credenciales de conexión y no puede consultar tu almacén directamente.
¿Puede el asistente borrar o romper algo?
No puede borrar nada, ni crear o cambiar reglas de SQL personalizado. Con acceso de escritura puede añadir y editar reglas, guardar versiones de contratos e iniciar ejecuciones o búsquedas de duplicados. Las versiones de los contratos se conservan, cada cambio queda en el registro de auditoría y la mayoría de los clientes te piden confirmación antes de una escritura.
¿Necesito un token si uso claude.ai o ChatGPT?
No. Ambos inician sesión con OAuth: apruebas la conexión en una página de Catalyst y ahí eliges el espacio de trabajo y el nivel de acceso. Los tokens son para clientes que envían una cabecera, como Claude Code, Cursor y VS Code.
¿Funciona con otros clientes MCP?
Esta guía cubre los clientes de arriba. Otros clientes que puedan conectarse a un servidor MCP remoto por HTTP, con OAuth o una cabecera Authorization, deberían poder usar la misma URL.