Docs / Intégration CLAUDE.md

Qu'est-ce que CLAUDE.md ?

CLAUDE.md est un fichier de configuration que Claude Code lit au démarrage d'une session dans un répertoire de projet. Il contient des instructions, des conventions et du contexte spécifiques au projet qui guident le comportement de Claude. Chaque développeur qui clone le dépôt obtient automatiquement la même configuration d'assistant IA.

En ajoutant le serveur MCP d'aqoon au CLAUDE.md de votre projet, chaque membre de l'équipe obtient un accès instantané à la base de connaissances de votre organisation directement dans Claude Code — aucune configuration manuelle requise.

Configuration

1. Créer une clé API

Allez dans Clés API dans la barre latérale et créez une clé avec accès complet. Copiez la valeur de la clé — vous ne la verrez qu'une seule fois.

2. Ajouter le serveur MCP à votre projet

Exécutez cette commande dans le répertoire de votre projet :

claude mcp add aqoon --transport http https://aqoon.ai/mcp/ \
  --header "Authorization: Bearer aqn_YOUR_API_KEY"

Cela crée un fichier .claude.json dans votre projet avec la configuration du serveur MCP.

3. Ajouter les instructions à CLAUDE.md

Créez ou modifiez CLAUDE.md à la racine de votre projet et ajoutez :

# Knowledge Base

This project uses aqoon for internal documentation search.
Use the aqoon MCP tools to search our knowledge base before
answering questions about company policies, procedures, or
internal documentation.

Available tools:
- search_documents: Search across all collections
- list_collections: See available document collections
- get_document_info: Get full document content
- search_by_tag: Find documents by tag

4. Committer les deux fichiers

git add CLAUDE.md .claude.json
git commit -m "Add aqoon knowledge base integration for Claude Code"

Désormais, chaque développeur qui clone le dépôt aura Claude Code automatiquement connecté à votre base de connaissances aqoon.

Comment votre équipe l'utilise

Une fois configuré, n'importe quel membre de l'équipe peut poser des questions à Claude Code comme :

  • "Quelle est notre politique de remboursement pour les clients entreprise ?"
  • "Comment déployons-nous en production ?"
  • "Quelles sont les limites de débit de l'API ?"

Claude recherchera automatiquement dans votre base de connaissances aqoon et répondra en utilisant la documentation réelle de votre organisation — pas des données d'entraînement génériques.

Sécurité des clés API

Le fichier .claude.json contient la clé API. Considérez ces options pour votre équipe :

  • Clé partagée dans le dépôt — Le plus simple. Utilisez une clé avec des permissions limitées qui n'accorde l'accès qu'aux collections que l'équipe doit voir. Ajoutez .claude.json au contrôle de version.
  • Clés par développeur — Plus sécurisé. Ajoutez .claude.json au .gitignore et demandez à chaque développeur d'exécuter la commande claude mcp add avec sa propre clé.

Exemple de structure de projet

my-project/
├── CLAUDE.md          # AI assistant instructions
├── .claude.json       # MCP server config (aqoon connection)
├── src/
├── docs/              # Upload these to aqoon!
│   ├── onboarding.md
│   ├── architecture.md
│   └── api-guide.md
└── README.md

Téléchargez votre dossier docs/ dans une collection aqoon, puis Claude Code pourra y effectuer des recherches à chaque conversation.