Pyxaura Pyxaura
Commencer

Connecter Pyxaura à votre éditeur (MCP)

MCP (Model Context Protocol) permet à un assistant IA d'éditeur — VS Code, Claude Desktop,
Cursor... — d'appeler directement les tools Pyxaura (recherche documentaire, Q&A sourcée, carte
structurelle d'un dépôt de code) sans configuration réseau complexe côté client.

1. Créer un jeton MCP

Rendez-vous sur Paramètres → Jetons MCP (connecté à votre compte).

  1. Donnez un nom explicite au jeton (ex. « VS Code — poste perso »).
  2. Dépôt Git (optionnel, recommandé pour un usage code) : si ce jeton sert à connecter l'assistant de votre éditeur à un dépôt Git précis, sélectionnez-le dans la liste. Le jeton sera alors strictement limité à ce dépôt — il ne pourra jamais lire les autres sources du même space (autres dépôts, Google Drive, Notion...), même si elles appartiennent au même compte. C'est le réglage recommandé : un jeton MCP dédié par dépôt Git.
  3. Choisissez une expiration (90 jours par défaut) et les scopes nécessaires — le preset par défaut suffit pour la quasi-totalité des usages (recherche, Q&A, carte de dépôt).
  4. Cliquez sur Créer le jeton. La clé n'est affichée qu'une seule fois : copiez-la immédiatement, ou générez-en une nouvelle en cas de perte (l'ancien jeton restera valide tant qu'il n'est pas révoqué explicitement).

2. Configurer votre éditeur

VS Code

Créez (ou complétez) .vscode/mcp.json à la racine de votre projet :

{
  "servers": {
    "pyxaura": {
      "command": "pyxaura-mcp",
      "env": {
        "PYXAURA_API_KEY": "VOTRE_CLE_MCP",
        "PYXAURA_BASE_URL": "https://pyxaura.com/api/v1"
      }
    }
  }
}

Claude Desktop

Ajoutez la même entrée dans claude_desktop_config.json :

{
  "mcpServers": {
    "pyxaura": {
      "command": "pyxaura-mcp",
      "env": {
        "PYXAURA_API_KEY": "VOTRE_CLE_MCP",
        "PYXAURA_BASE_URL": "https://pyxaura.com/api/v1"
      }
    }
  }
}

Installation du serveur MCP

Le serveur MCP (pyxaura-mcp) est un petit relais stdio ↔ HTTP, distribué comme gem Ruby :

gem install pyxaura-mcp-server

Ces deux valeurs (clé + URL de base) sont pré-remplies automatiquement dans les blocs
copier-coller affichés sur la page Jetons MCP juste après la création d'un jeton.

3. Les tools disponibles

Tool MCP Ce qu'il fait Portée
pyxaura_repo_map Carte structurelle d'un dépôt Git indexé (fichiers centraux, classes/méthodes, résumé de rôle), en un seul appel. Sources de type Git uniquement
pyxaura_search Recherche hybride rapide (sans génération LLM) dans des documents indexés Documents indexés hors dépôt Git
pyxaura_query Réponse rédigée avec citations, à partir des documents indexés Documents indexés hors dépôt Git
pyxaura_list_spaces Liste les spaces accessibles avec le jeton courant —
pyxaura_list_sources Liste les sources d'un space, leur type et leur statut de synchro —

Explorer le code d'un dépôt Git

Pour un dépôt connecté en Git, utilisez pyxaura_repo_map : il fournit directement la carte du
projet (fichiers centraux, classes, méthodes, relations) en un seul appel. pyxaura_search/
pyxaura_query restent utiles pour d'éventuels documents indexés par ailleurs dans le même space
(specs, wiki, CGV...) via un autre connecteur (upload, Google Drive, Notion, web...), mais pas
pour rechercher dans le code source lui-même.

4. Un jeton par dépôt — pourquoi et comment

Un jeton MCP scopé à un dépôt Git (créé via le champ Dépôt Git de l'étape 1) ne peut jamais
accéder aux autres sources du space, même si elles appartiennent au même compte. C'est le réglage
recommandé dès que le jeton sert un usage "assistant de code" dans un projet précis : il limite le
rayon d'exposition en cas de fuite de la clé (ex. commit accidentel) au seul dépôt concerné.

Un jeton non scopé (aucun dépôt sélectionné) garde accès à tout le space — pratique pour un
usage généraliste (Q&A sur plusieurs sources à la fois), mais à éviter dès qu'un usage "code" est
identifié.

5. Configurer AGENTS.md (ou équivalent) dans votre dépôt

Pour que votre agent (Kilo, Claude Code, Cursor...) sache utiliser les tools Pyxaura sans
qu'on ait à le lui rappeler à chaque session, ajoutez à la racine de votre dépôt un fichier
d'instructions (AGENTS.md, .kilo/AGENTS.md, ou l'équivalent reconnu par votre outil). Un
template prêt à l'emploi est fourni dans le SDK :
sdk/mcp-server/examples/AGENTS.md.example.

Remplacez <SPACE_ID> (et <SOURCE_ID> si vous scopez à un dépôt Git précis) par les valeurs
réelles, consultables via pyxaura_list_spaces/pyxaura_list_sources une fois le jeton configuré.

6. Dépannage

  • pyxaura_repo_map renvoie une carte vide ou périmée : vérifiez last_synced_at via pyxaura_list_sources — une synchro peut être en cours ou en échec (voir l'onglet source dans l'app).
  • pyxaura_search/pyxaura_query renvoient des résultats hors sujet : vérifiez que votre jeton n'est pas scopé à tout le space alors que vous cherchiez uniquement dans un dépôt Git — le code n'y est de toute façon pas indexé (voir §3) ; si le space contient plusieurs sources sans rapport entre elles, créez un jeton scopé à la seule source pertinente (§4).
  • 403 forbidden_scope : le scope requis par le tool appelé n'est pas coché sur le jeton, ou le jeton est scopé à une autre source/space que celui demandé.
  • La clé n'est plus affichée : elle n'est visible qu'une fois à la création ; révoquez le jeton perdu et créez-en un nouveau plutôt que de tenter de le retrouver.