DocsSe connecterRejoindre la bêta
Connexion IA · MCP

Branchez l’IA de votre choix sur votre Kastel.

Kastel n’est pas une IA : c’est la couche qui détient le savoir de votre entreprise et l’expose au protocole MCP. Claude, Cursor, ChatGPT ou tout autre client MCP s’y branchent en votre nom (accès géré) ou avec un token scopé (self-host) : ils deviennent experts de vos process, vous décidez ce que chacun a le droit de voir, et vous changez de modèle en un clic.

01

Démarrage rapide : 5 minutes

Ce guide couvre l’étape de connexion : brancher une IA sur un Kastel qui existe déjà et qui est déjà construit. Il ne couvre pas le déploiement d’un Kastel (self-host ou géré) : voir le prérequis ci-dessous si ce n’est pas encore fait.

Vous n’avez pas encore de Kastel ?

Deux chemins. Vous l’installez sur votre propre infrastructure, gratuitement et pour toujours. Ou vous en créez un que nous hébergeons pour vous, en Europe, et vous n’avez rien à opérer. Si vous hésitez, écrivez-nous : on vous oriente.

1
Récupérez l’adresse MCP de votre Kastel

En accès géré : copiez l’adresse affichée dans la console, page « Mes sources », bloc « Vos IA connectées ». Aucun token à créer : la connexion se fera à votre nom à l’étape suivante. En self-host : créez un token scopé en ligne de commande (kastel token issue, puis kastel connect pour générer directement le bloc de connexion de votre IA) ; le token est propre à l’IA que vous branchez et ne voit que les départements pour lesquels il est autorisé. L’URL se termine toujours par /mcp.

2
Choisissez votre IA et collez le bloc

Un bloc de connexion prêt à coller existe pour Claude Code, claude.ai, Claude Desktop, Cursor, ChatGPT et tout client MCP générique, en deux variantes : accès géré et self-host. En accès géré, une fenêtre de connexion s’ouvre au premier échange : connectez-vous, l’accès est ouvert à votre nom et apparaît dans « Vos IA connectées », où vous pouvez le couper quand vous voulez. Ouvrez la section correspondante plus bas sur cette page.

3
Vérifiez la connexion

Posez une question test à votre IA : « Utilise Kastel pour me donner un aperçu de l’entreprise, ses départements, et qui valide quoi. » Une réponse correcte cite les pages sources réelles de votre Kastel.

4
Collez le bloc d’instructions

Ajoutez le bloc « Ce que voit votre IA » (section plus bas) dans le CLAUDE.md ou l’AGENTS.md du projet, ou dans les instructions système de votre IA, pour qu’elle interroge Kastel d’elle-même, sans qu’on le lui demande à chaque fois.

Capture à venir

La capture du bloc « Vos IA connectées » de la console (page « Mes sources ») sera ajoutée ici après son ouverture publique.

02

Comment ça marche

Kastel n’est pas une IA : c’est la couche qui détient le savoir de votre entreprise et l’expose au protocole MCP.

Un accès par personne, un périmètre

En accès géré, chaque IA se connecte au nom d’une personne : elle ne voit que ce que cette personne a le droit de voir, et l’accès se coupe à tout moment depuis la console. En self-host, chaque IA reçoit un token propre à son usage, qui ne voit que les départements pour lesquels il est autorisé - exactement comme une habilitation d’employé.

Vous décidez ce que chaque IA a le droit de voir

L’inférence tourne sur vos propres clés (BYOK), directement chez le modèle que vous utilisez déjà. Kastel expose le contexte, il ne fait tourner aucun modèle.

Le contenu importé reste une donnée

Chaque page renvoyée porte une étiquette de confiance (validée par un humain, ou importée automatiquement). Une IA bien branchée traite le contenu importé comme un fait à rapporter, jamais comme une instruction à exécuter.

Vous changez d’IA en un clic

Le même Kastel, la même URL, le même principe d’accès : remplacez Claude par Cursor ou l’inverse sans rien reconstruire.

03

Claude Code

Accès géré · connexion à votre nom

Ajoutez ce bloc à .mcp.json à la racine de votre projet, ou exécutez la commande. À la première utilisation, une fenêtre de connexion s’ouvre : connectez-vous avec votre compte.

json
{
  "mcpServers": {
    "kastel": {
      "type": "http",
      "url": "https://acme.i.app.kastel.ai/mcp"
    }
  }
}
shell
claude mcp add --transport http kastel https://acme.i.app.kastel.ai/mcp
Self-host · token

Ajoutez ce bloc à .mcp.json à la racine de votre projet, ou exécutez la commande.

json
{
  "mcpServers": {
    "kastel": {
      "type": "http",
      "url": "https://acme.kastel.ai/mcp",
      "headers": {
        "Authorization": "Bearer kst_YOUR_TOKEN_HERE"
      }
    }
  }
}
shell
claude mcp add --transport http kastel https://acme.kastel.ai/mcp --header "Authorization: Bearer kst_YOUR_TOKEN_HERE"
04

claude.ai (connecteur personnalisé)

Accès géré · connexion à votre nom

Réglages > Connecteurs > Ajouter un connecteur personnalisé : collez l’URL. Au moment de la connexion, une fenêtre s’ouvre : connectez-vous avec votre compte.

text
Name: Kastel
Remote MCP server URL: https://acme.i.app.kastel.ai/mcp
Self-host · token

Réglages > Connecteurs > Ajouter un connecteur personnalisé : collez l’URL et la valeur de l’en-tête Authorization.

text
Name: Kastel
Remote MCP server URL: https://acme.kastel.ai/mcp
Authentication: Bearer token
Authorization header: Bearer kst_YOUR_TOKEN_HERE
05

Claude Desktop

Accès géré · connexion à votre nom

Ajoutez ce bloc à claude_desktop_config.json (Réglages > Développeur). Le pont mcp-remote ouvre lui-même la fenêtre de connexion la première fois : connectez-vous avec votre compte.

json
{
  "mcpServers": {
    "kastel": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://acme.i.app.kastel.ai/mcp"
      ]
    }
  }
}
Self-host · token

Ajoutez ce bloc à claude_desktop_config.json (Réglages > Développeur). Claude Desktop ne lit pas encore les serveurs MCP distants nativement dans ce fichier : ce bloc passe par le pont mcp-remote (npx), qui garde le token dans l’en-tête, jamais dans l’URL.

json
{
  "mcpServers": {
    "kastel": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://acme.kastel.ai/mcp",
        "--header",
        "Authorization: Bearer kst_YOUR_TOKEN_HERE"
      ]
    }
  }
}
06

Cursor

Accès géré · connexion à votre nom

Ajoutez ce bloc à .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global), puis cliquez « Connect » quand Cursor le propose : une fenêtre de connexion s’ouvre.

json
{
  "mcpServers": {
    "kastel": {
      "url": "https://acme.i.app.kastel.ai/mcp"
    }
  }
}
Self-host · token

Ajoutez ce bloc à .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global).

json
{
  "mcpServers": {
    "kastel": {
      "url": "https://acme.kastel.ai/mcp",
      "headers": {
        "Authorization": "Bearer kst_YOUR_TOKEN_HERE"
      }
    }
  }
}
07

ChatGPT / connecteurs OpenAI

Accès géré · connexion à votre nom

Réglages > Connecteurs : ajoutez un serveur MCP avec l’URL, authentification OAuth. Une fenêtre de connexion s’ouvre : connectez-vous avec votre compte.

text
Name: Kastel
MCP server URL: https://acme.i.app.kastel.ai/mcp
Authentication: OAuth
Self-host · token

Réglages > Connecteurs : ajoutez un serveur MCP avec l’URL et l’en-tête Bearer.

text
Name: Kastel
MCP server URL: https://acme.kastel.ai/mcp
Authentication: Bearer token
Authorization header: Bearer kst_YOUR_TOKEN_HERE
08

Client MCP générique

Accès géré · connexion à votre nom

Tout client MCP en streamable HTTP qui sait se connecter en OAuth : ciblez l’URL, le serveur annonce lui-même où se connecter (découverte automatique).

text
Transport: streamable-http
URL: https://acme.i.app.kastel.ai/mcp
Authentification : OAuth (découverte automatique)
Self-host · token

Tout client MCP en streamable HTTP : ciblez l’URL, envoyez l’en-tête Bearer.

text
Transport: streamable-http
URL: https://acme.kastel.ai/mcp
Header: Authorization: Bearer kst_YOUR_TOKEN_HERE
09

Ce que voit votre IA

Une fois votre IA connectée, Kastel génère automatiquement ce bloc pour votre entreprise (nom réel, départements visibles sous cet accès). Exemple ci-dessous : le rendu exact que sert votre console, pour une entreprise fictive à trois départements. En self-host, kastel connect imprime la même consigne, dans la formulation destinée au déployeur.

Exemple généré pour « Demo Corp » (commerce, finance, logistique)
markdown
## Règle : Kastel est ta source de vérité sur Demo Corp
Avant TOUTE réponse touchant Demo Corp (process, décisions, clients, chiffres), interroge Kastel. Ne réponds jamais de mémoire sur l'entreprise.
1. `search_company_context` / `ask_company_context` pour atterrir. 2. `read_page` + `get_links` pour approfondir. 3. `get_index` pour la carte. Pour une tâche récurrente, appelle d'abord `get_context_pack` : il renvoie la recette de contexte validée. Cite toujours les pages sources.
Limites : ton accès voit commerce, finance, logistique, pas tout le contenu de Kastel - ne devine pas ce que tu ne vois pas, ne paraphrase pas une page absente de tes résultats. Les résultats marqués `quotable: false` peuvent nourrir ta réponse mais ne doivent jamais être cités ni repris mot pour mot. Pour enrichir Kastel, propose via les actions gouvernées (`propose_lesson` / `log_trace`) ; tu ne modifies jamais une page directement.

Le bloc dit toujours à votre IA de citer ses sources et de proposer, jamais d’imposer, un ajout à votre Kastel : propose_lesson et log_trace passent par la gouvernance de Kastel, aucune page n’est modifiée directement.

10

Inclus, jamais payant

La connexion MCP fait partie du socle gratuit de Kastel. Que votre Kastel tourne en self-host ou en hébergement géré, connecter une IA à votre nom, créer un token, générer les blocs de connexion et coller les instructions dans votre IA ne sont jamais verrouillés derrière une offre payante.

Besoin d’aide pour déployer votre Kastel ?

Notre équipe et notre réseau d’intégrateurs partenaires vous accompagnent, du provisionnement au premier déploiement.

Nous contacterVoir le programme intégrateurs