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:

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

  1. Abre Settings → Connectors y elige Add custom connector.
  2. Ponle un nombre, por ejemplo "Catalyst", y pega https://ctlst.eu/mcp como URL.
  3. Pulsa conectar. Se abre una página de Catalyst. Inicia sesión si aún no lo has hecho.
  4. 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.
  5. 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

  1. En los ajustes de ChatGPT, activa el modo desarrollador para los conectores.
  2. Crea un conector personalizado, llámalo "Catalyst" y usa https://ctlst.eu/mcp como URL del servidor, con OAuth como método de autenticación.
  3. 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.
  4. 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:

  1. En Catalyst, ve a Settings → AI assistants.
  2. Crea un token. Dale un nombre que reconozcas más adelante, como "Cursor en mi portátil".
  3. Elige el alcance: read (lectura) o write (escritura). La escritura requiere el rol Editor o Admin.
  4. 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.
  5. 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)

HerramientaQué hace
get_workspace_overviewLa puntuación de salud del espacio de trabajo y sus cifras principales
list_datasetsLos datasets del espacio de trabajo
get_datasetUn dataset y sus detalles
get_contractEl contrato ODCS actual de un dataset, en YAML
list_contract_versionsLas versiones guardadas de un contrato
diff_contract_versionsQué cambió entre dos versiones de un contrato
validate_contractComprueba un contrato sin guardarlo
list_rulesLas reglas de un dataset
list_runsLas ejecuciones de validación recientes
get_runUna ejecución con el resultado de cada comprobación
wait_for_runEspera hasta 60 segundos a que termine una ejecución
get_rule_suggestionsLas reglas que Catalyst propone a partir de las columnas del dataset
list_duplicate_checksLas comprobaciones de duplicados del espacio de trabajo (Team y Enterprise, como en la aplicación)
get_duplicate_checkUna comprobación de duplicados y sus resultados (Team y Enterprise)
get_quality_reportEl informe de calidad (Team y Enterprise, como en la aplicación)

Herramientas de escritura (Team y Enterprise)

HerramientaQué hace
trigger_runLanza una ejecución de validación. Cuenta para tu cuota mensual de ejecuciones.
add_ruleAñade una regla a un dataset
update_ruleCambia una regla existente
save_contractGuarda una versión nueva del contrato de un dataset
start_duplicate_scanInicia 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)TeamEnterprise
Herramientas de lecturaSíSíSí
Herramientas de escritura (ejecuciones, reglas, contratos, búsquedas de duplicados)NoSí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.

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:

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.