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 avec un token scopé : 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.

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 provisionné ?

Un déploiement self-host se scaffold avec `kastel init` puis se construit avec `kastel onboard` ; un accès géré se provisionne depuis la console. Dans les deux cas, écrivez-nous : on vous oriente.

Nous contacter

Récupérez l’URL MCP et un token

Depuis la console de votre instance (page « Connecter votre IA ») pour un accès géré, ou en ligne de commande pour un self-host (`kastel token issue`, puis `kastel connect` pour générer directement le bloc de connexion de votre IA). L’URL se termine toujours par `/mcp` ; le token est propre à l’IA que vous branchez et ne voit que les départements pour lesquels il est autorisé.

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. Ouvrez la section correspondante plus bas sur cette page.

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.

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 de la page « Connecter votre IA » de la console sera ajoutée ici après son ouverture publique.

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 token, un scope

Chaque IA branchée reçoit un token propre à son usage. Le token 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 de token : remplacez Claude par Cursor ou l’inverse sans rien reconstruire.

Claude Code

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"

claude.ai (connecteur personnalisé)

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

Claude Desktop

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

Cursor

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

ChatGPT / connecteurs OpenAI

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

Client MCP générique

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

Ce que voit votre IA

Une fois le token créé, Kastel génère automatiquement ce bloc pour votre entreprise (nom réel, départements visibles sous ce token). Exemple ci-dessous : le rendu exact pour une entreprise fictive à trois départements.

Exemple généré pour « Demo Corp » (commerce, finance, logistique)

markdown

## Regle : Kastel est ta source de verite sur Demo Corp
Avant TOUTE reponse touchant Demo Corp (process, decisions, clients, chiffres), interroge Kastel. Ne reponds jamais de memoire 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. Cite toujours les pages sources.
Limites : ton token 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 resultats. Pour enrichir Kastel, propose via les actions gouvernees (`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.

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é, 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 contacter Voir le programme intégrateurs