Utiliser Catalyst depuis Claude, ChatGPT et votre IDE (MCP)

Comment connecter Catalyst à Claude, ChatGPT, Claude Code, Cursor ou VS Code via son serveur MCP, ce que l'assistant peut faire et ce à quoi il ne peut jamais toucher.

· 9 min read

Catalyst dispose d'un serveur MCP. Une fois connecté, vous pouvez interroger l'assistant IA que vous utilisez déjà sur la qualité de vos données, en langage courant, et il répond à partir de votre espace de travail Catalyst :

Cette page est le guide de configuration. Elle couvre chaque client pris en charge, les jetons d'accès personnels, la liste complète des outils, l'offre nécessaire et ce que l'assistant n'a pas le droit de faire.

Qu'est-ce que MCP

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA d'appeler des outils dans un autre produit. Catalyst publie un ensemble d'outils (lister les jeux de données, lire un contrat, lancer une exécution, etc.), et l'assistant choisit lesquels appeler pour répondre à votre question.

Le serveur est hébergé par Catalyst. Vous le connectez par son URL, sans rien installer :

https://ctlst.eu/mcp

Il existe deux façons de se connecter. Les clients compatibles OAuth (claude.ai, Claude Desktop et ChatGPT) ouvrent une page de connexion Catalyst, où vous choisissez l'espace de travail et le niveau d'accès. Les autres, ou ceux pour qui un en-tête est plus simple (Claude Code, Cursor, VS Code), utilisent un jeton d'accès personnel.

Connecter claude.ai ou Claude Desktop

  1. Ouvrez Settings → Connectors et choisissez Add custom connector.
  2. Donnez-lui un nom, par exemple « Catalyst », et collez https://ctlst.eu/mcp comme URL.
  3. Cliquez sur connecter. Une page Catalyst s'ouvre. Connectez-vous si ce n'est pas déjà fait.
  4. Choisissez l'espace de travail que l'assistant peut utiliser, puis lecture ou lecture et écriture. L'écriture n'est proposée que si votre rôle dans cet espace de travail est Editor ou Admin.
  5. Approuvez. Vous revenez dans Claude, et les outils Catalyst sont disponibles dans les nouvelles conversations.

Un connecteur ajouté dans claude.ai est aussi disponible dans Claude Desktop si vous vous connectez avec le même compte.

Connecter ChatGPT

  1. Dans les paramètres de ChatGPT, activez le mode développeur pour les connecteurs.
  2. Créez un connecteur personnalisé, nommez-le « Catalyst » et utilisez https://ctlst.eu/mcp comme URL du serveur, avec OAuth comme méthode d'authentification.
  3. ChatGPT ouvre la même page de consentement Catalyst : connectez-vous, choisissez un espace de travail, lecture ou lecture et écriture, et approuvez.
  4. Activez le connecteur dans une conversation et posez votre question.

ChatGPT demande normalement une confirmation avant d'exécuter un outil qui modifie quelque chose, comme l'ajout d'une règle.

Créer un jeton d'accès personnel

Claude Code, Cursor et VS Code envoient un jeton dans un en-tête Authorization. Pour en créer un :

  1. Dans Catalyst, allez dans Settings → AI assistants.
  2. Créez un jeton. Donnez-lui un nom que vous reconnaîtrez plus tard, par exemple « Cursor sur mon portable ».
  3. Choisissez la portée : read (lecture) ou write (écriture). L'écriture nécessite le rôle Editor ou Admin.
  4. Choisissez sa durée de vie. Par défaut 90 jours, et toute valeur de 1 à 365 jours est possible. Les jetons expirent toujours.
  5. Copiez le jeton. Il commence par cat_pat_ et n'est affiché qu'une seule fois. Catalyst n'en conserve qu'une empreinte (hash) et ne peut donc pas vous le réafficher.

Un jeton vous appartient et est lié à un seul espace de travail. Il n'a jamais plus de droits que votre rôle dans cet espace de travail, et il cesse de fonctionner si vous le quittez. Vous pouvez le révoquer à tout moment depuis la même page, où les administrateurs voient aussi tous les jetons de l'espace de travail et peuvent les révoquer.

Traitez le jeton comme un mot de passe. Ne le mettez dans aucun fichier que vous committez dans Git.

Connecter Claude Code

Exécutez cette commande une fois, en remplaçant <token> par votre jeton :

claude mcp add --transport http catalyst https://ctlst.eu/mcp --header "Authorization: Bearer <token>"

Lancez ensuite Claude Code et posez vos questions sur votre espace de travail. claude mcp list indique si le serveur est connecté.

Connecter Cursor

Ajoutez Catalyst à ~/.cursor/mcp.json (pour tous les projets) ou à .cursor/mcp.json (pour un projet) :

{
  "mcpServers": {
    "catalyst": {
      "url": "https://ctlst.eu/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Redémarrez Cursor ou rechargez ses paramètres MCP : les outils Catalyst apparaissent dans la liste d'outils de l'agent.

Connecter VS Code

VS Code lit .vscode/mcp.json dans votre projet. Cette version demande le jeton une fois et le garde hors du fichier :

{
  "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}"
      }
    }
  }
}

Démarrez le serveur depuis le fichier ou la palette de commandes, collez le jeton quand il vous est demandé, et utilisez Catalyst depuis le mode agent de Copilot.

Ce que l'assistant peut faire

Chaque outil indique au client s'il se contente de lire ou s'il modifie quelque chose. Les clients peuvent donc exécuter les lectures directement et vous demander avant une écriture.

Outils de lecture (toutes les offres)

OutilCe qu'il fait
get_workspace_overviewLe score de santé de l'espace de travail et ses chiffres clés
list_datasetsLes jeux de données de l'espace de travail
get_datasetUn jeu de données et ses détails
get_contractLe contrat ODCS actuel d'un jeu de données, en YAML
list_contract_versionsLes versions enregistrées d'un contrat
diff_contract_versionsCe qui a changé entre deux versions d'un contrat
validate_contractVérifie un contrat sans l'enregistrer
list_rulesLes règles d'un jeu de données
list_runsLes exécutions de validation récentes
get_runUne exécution avec le résultat de chaque contrôle
wait_for_runAttend jusqu'à 60 secondes la fin d'une exécution
get_rule_suggestionsLes règles que Catalyst propose à partir des colonnes du jeu de données
list_duplicate_checksLes contrôles de doublons de l'espace de travail (Team et Enterprise, comme dans l'application)
get_duplicate_checkUn contrôle de doublons et ses résultats (Team et Enterprise)
get_quality_reportLe rapport de qualité (Team et Enterprise, comme dans l'application)

Outils d'écriture (Team et Enterprise)

OutilCe qu'il fait
trigger_runLance une exécution de validation. Elle est décomptée de votre quota mensuel d'exécutions.
add_ruleAjoute une règle à un jeu de données
update_ruleModifie une règle existante
save_contractEnregistre une nouvelle version du contrat d'un jeu de données
start_duplicate_scanLance une recherche de doublons

Les outils d'écriture nécessitent un jeton ou une connexion avec accès en écriture, le rôle Editor ou Admin, et une offre Team ou Enterprise. Les exécutions lancées ainsi apparaissent dans l'historique avec le déclencheur « AI assistant ».

Le serveur fournit aussi deux prompts que les clients peuvent proposer comme raccourcis : triage_failed_run, qui passe en revue une exécution en échec, et harden_contract, qui examine un contrat et propose les règles manquantes.

Offres

Starter (gratuit)TeamEnterprise
Outils de lectureOuiOuiOui
Outils d'écriture (exécutions, règles, contrats, recherches de doublons)NonOuiOui

Les exécutions lancées par un assistant sont décomptées du même quota mensuel que celles que vous lancez dans l'application. Catalyst ne facture rien côté IA : le modèle tourne dans votre propre compte Claude, ChatGPT ou celui de votre IDE.

Sécurité et confidentialité

L'assistant travaille avec les mêmes permissions que vous dans l'application, et certaines choses lui restent interdites quels que soient le jeton ou le rôle.

Quand votre assistant récupère des données dans Catalyst, ces données sont envoyées à votre fournisseur d'IA parce que vous l'avez demandé. Elles sont traitées dans le cadre de votre propre accord avec ce fournisseur. Voir la politique de confidentialité pour plus de détails.

Exemples de prompts

Quelques-uns qui fonctionnent bien :

Questions fréquentes

Catalyst est-il référencé dans l'annuaire de connecteurs de Claude ou de ChatGPT ?

Pas encore. Pour l'instant, vous l'ajoutez vous-même comme connecteur personnalisé avec l'URL https://ctlst.eu/mcp, ce qui prend environ une minute.

Quelle offre me faut-il ?

N'importe laquelle. La lecture des jeux de données, contrats, règles et exécutions fonctionne avec l'offre gratuite Starter. Les contrôles de doublons et le rapport de qualité sont des fonctions Team et Enterprise, dans l'assistant comme dans l'application. Lancer des exécutions, ajouter ou modifier des règles, enregistrer des contrats et lancer des recherches de doublons nécessite Team ou Enterprise.

L'assistant peut-il voir mes données ?

Il voit ce que Catalyst stocke à propos de vos données : noms des jeux de données et des colonnes, contrats, règles, résultats d'exécution et nombre de violations. Les échantillons de lignes en échec ne sont inclus que si un administrateur de l'espace de travail les active. Il ne voit jamais les identifiants de connexion et ne peut pas interroger directement votre entrepôt.

L'assistant peut-il supprimer ou casser quelque chose ?

Il ne peut rien supprimer, ni créer ou modifier de règles SQL personnalisées. Avec un accès en écriture, il peut ajouter et modifier des règles, enregistrer des versions de contrat et lancer des exécutions ou des recherches de doublons. Les versions de contrat sont conservées, chaque modification figure dans le journal d'audit, et la plupart des clients demandent une confirmation avant une écriture.

Ai-je besoin d'un jeton si j'utilise claude.ai ou ChatGPT ?

Non. Les deux se connectent via OAuth : vous approuvez la connexion sur une page Catalyst et y choisissez l'espace de travail et le niveau d'accès. Les jetons servent aux clients qui envoient un en-tête, comme Claude Code, Cursor et VS Code.

Est-ce que cela fonctionne avec d'autres clients MCP ?

Ce guide couvre les clients ci-dessus. D'autres clients capables de se connecter à un serveur MCP distant en HTTP, avec OAuth ou un en-tête Authorization, devraient pouvoir utiliser la même URL.