Installer, client par client

Le serveur de Sarutobi est un endpoint HTTP standard. Ce qui change d'un agent à l'autre, c'est uniquement la façon de lui déclarer une adresse — le reste, découverte, autorisation et vérification, vient du protocole.

L'adresse à donner

https://sarutobi.ascencia.re/api/mcp

Ce qui se passe, quel que soit le client

Vous donnez l'adresse au client, de la façon décrite dans sa section.
Le client interroge le serveur, découvre qu'il faut s'autoriser, et s'enregistre tout seul. Rien à créer de votre côté.
Votre navigateur s'ouvre sur l'écran de consentement de Sarutobi.
Vous choisissez l'organisation et cochez ce que l'agent pourra lire. L'écriture arrive décochée.
Le client repart avec un jeton. Il n'y a rien à copier.

Ce que vous décochez n'est pas refusé à l'agent : il ne le voit pas. La liste d'outils est filtrée par les permissions accordées — un agent sans person:read n'a aucun outil de personnes dans son catalogue.

L'écran d'autorisation

C'est le même pour tous les clients, et c'est le seul moment où vous décidez quelque chose. Le nom affiché est celui que le client a déclaré en s'enregistrant.

Capture à venir

L'écran de consentement de Sarutobi : le nom du client demandeur, le sélecteur d'organisation, et la liste des permissions — celles d'écriture décochées.

Si votre client n'a pas de navigateur

Un job de CI ne can pas afficher un écran de consentement. Créez alors un jeton depuis Mon compte → Agents et présentez-le en en-tête. C'est la seule différence : partout où une section ci-dessous montre une adresse, ajoutez l'en-tête.

Le même serveur, avec un jeton

Authorization: Bearer st_mcp_...

Par commande

Le client a une sous-commande qui enregistre un serveur distant.

Claude Code

L'agent en terminal. Le plus direct pour interroger ses mesures pendant qu'on code.

Dans un terminal, une seule commande suffit.

claude mcp add --transport http sarutobi https://sarutobi.ascencia.re/api/mcp

Ouvrir le gestionnaire MCP de Claude Code et lancer l’autorisation pour « sarutobi ».
Capture à venir
Le panneau « /mcp » de Claude Code : la ligne « sarutobi » sélectionnée, et l’entrée « Authenticate ».
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Retaper « /mcp » : « sarutobi » est marqué connecté et ses outils sont listés en dessous.
Capture à venir
Le panneau « /mcp » après autorisation : « sarutobi » connecté, ses outils listés.
Poser une première question : « liste mes sites ».

Documentation MCP de Claude Code

OpenAI Codex

L'agent d'OpenAI, en terminal comme en extension. OAuth par défaut.

Déclarer le serveur dans « ~/.codex/config.toml », puis lancer la connexion.
```
codex mcp login sarutobi
```
Ouvrir le gestionnaire MCP de OpenAI Codex et lancer l’autorisation pour « sarutobi ».
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Lancer « codex mcp list » : « sarutobi » apparaît authentifié.
Capture à venir
La sortie de « codex mcp list », « sarutobi » marqué authentifié.
Poser une première question : « liste mes sites ».

Documentation MCP de OpenAI Codex

Gemini CLI

L'agent de Google en ligne de commande.

Déclarer le serveur dans « ~/.gemini/settings.json ».

Configuration MCP

{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}

Ouvrir le gestionnaire MCP de Gemini CLI et lancer l’autorisation pour « sarutobi ».
Capture à venir
Gemini CLI après « /mcp », le serveur en attente d’autorisation.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Taper « /mcp » : « sarutobi » est listé avec le nombre d’outils qu’il expose.
Capture à venir
Gemini CLI après « /mcp » : « sarutobi » connecté et ses outils listés.
Poser une première question : « liste mes sites ».

Documentation MCP de Gemini CLI

Par fichier

Le client lit un fichier JSON où l'on déclare l'URL et les en-têtes.

Cursor

L'éditeur. Le serveur vaut pour un projet ou pour tous.

Créer ou ouvrir « ~/.cursor/mcp.json » — ou « .cursor/mcp.json » pour un seul projet.
~/.cursor/mcp.json
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Cursor détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
Le panneau MCP de Cursor, « sarutobi » détecté et son bouton de connexion.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Réglages → MCP : « sarutobi » porte une pastille verte et ses outils sont comptés.
Capture à venir
Le même panneau après autorisation : pastille verte et outils listés.
Poser une première question : « liste mes sites ».

Documentation MCP de Cursor

VS Code

Par GitHub Copilot, en mode agent.

Une commande, ou le fichier « .vscode/mcp.json » du projet.

code --add-mcp '{"name":"sarutobi","type":"http","url":"https://sarutobi.ascencia.re/api/mcp"}'

VS Code détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
VS Code : le bouton « Start » affiché au-dessus du serveur dans « .vscode/mcp.json ».
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Ouvrir le chat en mode agent, dérouler la liste des outils : « sarutobi » y a sa section.
Capture à venir
La liste des outils du chat agent, section « sarutobi » cochée.
Poser une première question : « liste mes sites ».

Documentation MCP de VS Code

Windsurf

L'éditeur de Codeium, serveurs déclarés pour Cascade.

Panneau Cascade → Plugins → Ajouter un serveur, ou le fichier « mcp_config.json ».
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Windsurf détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
Le panneau Plugins de Windsurf, « sarutobi » ajouté, avant connexion.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Panneau Cascade → Plugins : « sarutobi » est actif et ses outils comptés.
Capture à venir
Le même panneau, « sarutobi » actif.
Poser une première question : « liste mes sites ».

Documentation MCP de Windsurf

Cline

L'extension autonome de VS Code.

Icône MCP du panneau Cline → Configure MCP Servers, puis éditer le JSON.

Configuration MCP

{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}

Cline détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
L’écran « Configure MCP Servers » de Cline, configuration collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Panneau Cline → MCP Servers : « sarutobi » est vert et ses outils listés.
Capture à venir
Le panneau « MCP Servers » de Cline, « sarutobi » connecté.
Poser une première question : « liste mes sites ».

Documentation MCP de Cline

Roo Code

L'agent multi-modes, dérivé de Cline.

Panneau Roo Code → MCP → Edit Global MCP, puis éditer le JSON.

Configuration MCP

{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}

Roo Code détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
L’écran « Edit Global MCP » de Roo Code, configuration collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Panneau Roo Code → MCP : « sarutobi » est actif et ses outils listés.
Capture à venir
Le panneau MCP de Roo Code, « sarutobi » actif.
Poser une première question : « liste mes sites ».

Documentation MCP de Roo Code

Kiro

L'IDE agentique d'AWS, orienté spécification.

Créer « .kiro/settings/mcp.json » dans le projet, ou son équivalent global.

Configuration MCP

{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}

Kiro détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
Kiro après création de « .kiro/settings/mcp.json », le serveur détecté.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Panneau MCP de Kiro : « sarutobi » est en vert.
Capture à venir
Le panneau MCP de Kiro, « sarutobi » en vert.
Poser une première question : « liste mes sites ».

Documentation MCP de Kiro

Trae

L'IDE adaptatif, serveurs déclarés par fichier.

Réglages → MCP → Ajouter, puis coller la configuration.

Configuration MCP

{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}

Trae détecte le serveur au rechargement. Lancer la connexion depuis son panneau MCP.
Capture à venir
L’écran d’ajout MCP de Trae, configuration collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Réglages → MCP : « sarutobi » figure dans la liste avec ses outils.
Capture à venir
La liste MCP de Trae, « sarutobi » ajouté.
Poser une première question : « liste mes sites ».

Documentation MCP de Trae

Par l'interface

Le serveur s'ajoute depuis les réglages du client, sans fichier à éditer.

Claude

Applications de bureau et web, par connecteur personnalisé.

Réglages → Connecteurs → Ajouter un connecteur personnalisé, puis coller l’adresse.
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Capture à venir
La fenêtre « Ajouter un connecteur personnalisé » de Claude, champ d’adresse rempli.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Ouvrir une conversation : « sarutobi » figure parmi les connecteurs disponibles.
Capture à venir
Les réglages Connecteurs de Claude, « sarutobi » listé et actif.
Poser une première question : « liste mes sites ».

Documentation MCP de Claude

Zed

L'éditeur rapide, serveurs de contexte dans les réglages.

Réglages → Serveurs de contexte → Ajouter un serveur distant.
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Capture à venir
La fenêtre « Ajouter un serveur distant » de Zed, adresse collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Réglages → Serveurs de contexte : « sarutobi » est en cours d’exécution.
Capture à venir
La liste des serveurs de contexte de Zed, « sarutobi » en cours d’exécution.
Poser une première question : « liste mes sites ».

Documentation MCP de Zed

Warp

Le terminal agentique, serveurs ajoutés depuis les réglages.

Réglages → AI → MCP servers → Add, puis coller l’adresse.
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Capture à venir
L’écran « Add MCP server » de Warp, adresse collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Réglages → AI → MCP servers : « sarutobi » affiche l’état connecté.
Capture à venir
La liste MCP de Warp, « sarutobi » connecté.
Poser une première question : « liste mes sites ».

Documentation MCP de Warp

JetBrains

IntelliJ, WebStorm et consorts, via l'assistant IA.

Réglages → Tools → AI Assistant → MCP, puis ajouter un serveur distant.
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Capture à venir
La fenêtre d’ajout de serveur MCP de l’assistant JetBrains, adresse collée.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Réglages → Tools → AI Assistant → MCP : « sarutobi » est vert et ses outils comptés.
Capture à venir
La liste MCP des réglages JetBrains, « sarutobi » connecté.
Poser une première question : « liste mes sites ».

Documentation MCP de JetBrains

Goose

L'agent ouvert de Block, extensible par extensions.

Lancer « goose configure », choisir « Add Extension » puis « Remote Extension ».
```
goose configure
```
Capture à venir
Le terminal pendant « goose configure », au choix « Remote Extension ».
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Relancer « goose configure » → « Toggle Extensions » : « sarutobi » est activée.
Capture à venir
La liste des extensions de Goose, « sarutobi » activée.
Poser une première question : « liste mes sites ».

Documentation MCP de Goose

Replit

L'environnement en ligne et son agent.

Panneau Integrations de l’espace de travail → ajouter un serveur MCP distant.
Configuration MCP
```
{
  "mcpServers": {
    "sarutobi": {
      "url": "https://sarutobi.ascencia.re/api/mcp"
    }
  }
}
```
Capture à venir
Le panneau Integrations de Replit, ajout d’un serveur MCP distant.
Votre navigateur s'ouvre sur Sarutobi. Choisissez l'organisation, cochez les permissions, validez — c'est l'écran du haut de page.
Panneau Integrations : « sarutobi » est listé comme connecté.
Capture à venir
Le panneau Integrations, « sarutobi » connecté.
Poser une première question : « liste mes sites ».

Documentation MCP de Replit