Serveur MCP — Configuration

Le serveur MCP d'IgnitionRAG, c'est comme une télécommande universelle pour votre plateforme RAG. Imaginez : au lieu de cliquer dans l'interface web, vous pouvez contrôler IgnitionRAG directement depuis votre assistant IA préféré — Claude Desktop, Cursor, ou Claude Code. Vous lui parlez en langage naturel, et il utilise les outils MCP pour créer des workflows, interroger vos collections, gérer vos widgets, et bien plus encore.

Note

MCP (Model Context Protocol) est un standard ouvert créé par Anthropic qui permet aux assistants IA de se connecter à des services externes. C'est comme une prise universelle : n'importe quel client MCP compatible peut se brancher sur le serveur IgnitionRAG et utiliser tous ses outils.

Prérequis

Avant de configurer le serveur MCP, vous avez besoin de :

Une clé API IgnitionRAG (commence par ign_). Vous pouvez en créer une depuis votre tableau de bord, section Clés API.
Un compte IgnitionRAG actif (n'importe quel plan, y compris gratuit).

Tip

Si vous n'avez pas encore connecté votre IA, consultez d'abord Connecter votre IA

Configuration pour Claude Desktop

Claude Desktop est l'application officielle d'Anthropic. C'est le client MCP le plus simple à configurer.

Ouvrez Claude Desktop et accédez aux paramètres (Settings).
Cliquez sur l'onglet "Developer" puis "Edit Config".
Collez la configuration suivante dans le fichier qui s'ouvre :

{
  "mcpServers": {
    "ignitionrag": {
      "url": "https://ignitionrag.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Remplacez YOUR_API_KEY par votre clé API IgnitionRAG (ex: ign_abc123...).
Redémarrez Claude Desktop.

Note

Le fichier de configuration se trouve à : ~/Library/Application Support/Claude/claude_desktop_config.json

Note

Sous Windows : %APPDATA%\Claude\claude_desktop_config.json

Tip

Après redémarrage, vous verrez une icône 🔌 dans la zone de saisie de Claude Desktop — c'est la confirmation que le serveur MCP est connecté !

Configuration pour Cursor

Cursor est un éditeur de code basé sur VS Code avec support MCP intégré.

Ouvrez Cursor et accédez aux paramètres : Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows) → "Cursor Settings".
Allez dans la section "MCP Servers".
Cliquez sur "Add Server" et collez cette configuration :

{
  "ignitionrag": {
    "url": "https://ignitionrag.com/mcp/",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Remplacez YOUR_API_KEY par votre clé API IgnitionRAG.
Redémarrez Cursor pour appliquer les changements.

Tip

Les outils IgnitionRAG sont maintenant disponibles dans l'assistant Cursor.

Configuration pour Claude Code

Claude Code est le CLI officiel d'Anthropic pour le développement. La configuration se fait en une seule commande.

Ouvrez votre terminal et exécutez :

claude mcp add ignitionrag --transport url --url https://ignitionrag.com/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

Remplacez YOUR_API_KEY par votre clé API IgnitionRAG.

Vous pouvez aussi ajouter manuellement dans le fichier .claude/settings.json :

{
  "mcpServers": {
    "ignitionrag": {
      "type": "url",
      "url": "https://ignitionrag.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tip

Les outils IgnitionRAG sont immédiatement disponibles dans Claude Code.

Vérifier la connexion

Comment savoir si tout fonctionne ?

Dans votre client MCP, demandez simplement : "Liste mes collections IgnitionRAG".
Si la connexion est correcte, l'assistant utilisera l'outil list_collections et vous montrera vos collections.
Vous pouvez aussi demander : "Quels outils IgnitionRAG sont disponibles ?" pour voir la liste complète.

Tip

Si vous voyez vos collections ou la liste des outils, la configuration est réussie !

Dépannage

Si quelque chose ne fonctionne pas, voici les problèmes les plus courants et leurs solutions.

Erreur 401 — Non autorisé

Warning

Votre clé API est invalide, expirée, ou mal formatée. La clé doit commencer par ign_ et être précédée de "Bearer " dans le header Authorization.

Vérifiez votre clé API dans le tableau de bord IgnitionRAG. Assurez-vous que le header est exactement : "Authorization": "Bearer ign_votre_cle". Attention à l'espace après "Bearer".

Erreur de connexion — Serveur inaccessible

Warning

L'URL du serveur MCP est incorrecte, ou votre réseau bloque la connexion.

Vérifiez que l'URL est exactement https://ignitionrag.com/mcp/. Si vous êtes derrière un proxy ou VPN, assurez-vous qu'il autorise les connexions HTTPS sortantes vers ignitionrag.com.

Les outils n'apparaissent pas

Warning

Le client MCP n'a pas rechargé la configuration après modification.

Redémarrez complètement votre client MCP (Claude Desktop, Cursor, ou Claude Code). Certains clients nécessitent un redémarrage complet, pas juste un rechargement de fenêtre.

Erreur 403 — Permission refusée

Warning

Votre plan actuel ne donne pas accès à certaines fonctionnalités (ex: widgets sur le plan gratuit).

Consultez les limites de votre plan dans le tableau de bord, section Facturation. Mettez à niveau si nécessaire.