Configuration MCP

Connecter Claude à aqoon

aqoon fonctionne avec Claude Desktop et Claude Code via le Model Context Protocol (MCP). Une fois connecté, Claude peut rechercher dans votre base de connaissances directement pendant les conversations — aucun copier-coller nécessaire.

Avant de commencer, vous aurez besoin d'une clé API. Créez-en une depuis Clés API dans la barre latérale. Une clé à accès complet est le bon choix pour un usage personnel avec Claude.

Option A : Distant (recommandé)

Cela connecte Claude directement à aqoon via Internet. Claude Code ne nécessite aucune dépendance supplémentaire. Claude Desktop nécessite Node.js ≥ 18 pour le pont mcp-remote.

Astuce : Utilisez l'assistant de connexion IA dans votre tableau de bord pour générer ces configurations avec votre clé API pré-remplie.

Claude Code

Exécutez cette commande une fois dans votre terminal, en remplaçant your-instance et aqn_your_api_key par vos valeurs réelles :

claude mcp add aqoon --transport http https://your-instance/mcp \
  --header "Authorization: Bearer aqn_your_api_key"

Claude Desktop

Ouvrez votre fichier de configuration Claude Desktop (claude_desktop_config.json) et ajoutez ce qui suit dans le bloc mcpServers. Cela utilise mcp-remote pour relier Claude Desktop au serveur distant (nécessite Node.js).

{
  "mcpServers": {
    "aqoon": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-instance/mcp",
        "--header",
        "Authorization: Bearer aqn_your_api_key"
      ]
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré le fichier. Le premier lancement peut prendre un moment pendant l'installation de mcp-remote.

Option B : Paquet local

Bientôt disponible — Le paquet pip aqoon-mcp n'est pas encore publié. Utilisez l'Option A (Distant) en attendant.

Si vous préférez exécuter un serveur MCP local sur votre machine, installez le paquet aqoon-mcp. Python doit être installé.

pip install aqoon-mcp

Claude Code

claude mcp add aqoon aqoon-mcp \
  -e AQOON_URL=https://your-instance \
  -e AQOON_API_KEY=aqn_your_api_key

Claude Desktop

Ajoutez ce qui suit à claude_desktop_config.json :

{
  "mcpServers": {
    "aqoon": {
      "command": "aqoon-mcp",
      "env": {
        "AQOON_URL": "https://your-instance",
        "AQOON_API_KEY": "aqn_your_api_key"
      }
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré le fichier.

Vérifier la connexion

Après la configuration, démarrez une nouvelle conversation dans Claude et demandez :

"Liste les collections de ma base de connaissances aqoon."

Si Claude répond avec les noms de vos collections, la connexion fonctionne. Consultez Outils MCP et utilisation pour la liste complète de ce que Claude peut faire avec aqoon.

Dépannage

Problème	Cause	Solution
« Could not load app settings » avec `command: Required`	Claude Desktop ne prend pas en charge `"type": "http"` ou `"type": "streamable-http"` directement	Utilisez la configuration `mcp-remote` indiquée ci-dessus (avec `"command": "npx"`)
Serveur déconnecté / `SyntaxError: node:fs/promises`	La version de Node.js est trop ancienne (< 18)	Installez Node.js ≥ 18. Si vous utilisez nvm : `nvm alias default 22`. Ou utilisez le chemin complet dans la configuration : `"command": "/path/to/node/v22/bin/npx"`
Serveur déconnecté (aucune erreur dans les logs)	Cache npx obsolète d'une ancienne version de Node	Supprimez le cache : `rm -rf ~/.npm/_npx/` et redémarrez Claude Desktop
Claude n'utilise pas les outils aqoon	Le serveur n'apparaît pas dans les outils de Claude	Cliquez sur l'icône de prise dans Claude Desktop pour vérifier. S'il manque, redémarrez Claude Desktop