--- title: "Configuration du client" description: "Configurez Minds MCP avec ChatGPT, Claude Desktop, Cursor et d'autres clients." canonical_url: "https://getminds.ai/mcp/fr/setup" last_updated: "2026-09-30T12:20:37.402Z" --- # Configuration du client La disponibilité dépend du déploiement : la découverte expose 23 outils, ou 24 si `list_model_connections` est activé, pour 42 ou 43 outils canoniques enregistrés. La réponse `tools/list` du serveur connecté fait référence. Ce guide connecte le [serveur Minds MCP pour la recherche marché](/mcp/overview) aux clients IA qui prennent en charge les outils distants. Utilisez `https://getminds.ai/mcp` comme URL serveur. ## ChatGPT Utilisez ChatGPT sur le Web. La disponibilité et les permissions dépendent du compte et de l’espace de travail ; consultez [les instructions MCP actuelles d’OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). 1. Ouvrez **Plugins** et choisissez **Add → Create MCP App**. Si l'option est absente, activez le mode développeur ou demandez à l'administrateur de votre espace de travail d'autoriser les apps MCP personnalisées. 2. Nommez-la `Minds`, saisissez `https://getminds.ai/mcp` dans **Server URL**, choisissez **OAuth** dans **Authentication**, confirmez l'avertissement de risque et cliquez sur **Create**. 3. Cliquez sur **Continue to Minds**, connectez-vous à votre compte Minds et choisissez **Allow**. 4. Dans une nouvelle conversation, tapez `@Minds` et demandez la liste de vos Audiences. Les Studies plus larges nécessitent une vérification et une confirmation explicite avant exécution. Le [guide de configuration ChatGPT](/guide/integration-chatgpt) détaille chaque écran, y compris l'option de l'annuaire des plugins. Les hôtes Web compatibles affichent les résultats dans la conversation. Sur mobile, un widget Minds affiché propose un lien pour continuer dans Minds à la place des commandes interactives. ## Claude Desktop ### Connecteur distant (widgets selon le client) 1. Ouvrez Claude Desktop → **Customize** → **Connectors** (ou **Settings** → **Connections**) 2. Ajoutez `https://getminds.ai/mcp` comme nouveau connecteur distant 3. Autorisez via OAuth lorsque demandé — connectez-vous à votre compte Minds 4. Les tools apparaissent automatiquement après autorisation ### Option B : Connecteur local (API key, texte uniquement) Ajoutez à votre fichier de configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` sur macOS) : ```json { "mcpServers": { "mindsai": { "command": "npx", "args": [ "-y", "mcp-remote", "https://getminds.ai/mcp", "--header", "Authorization: Bearer minds_YOUR_API_KEY" ] } } } ``` Redémarrez Claude Desktop. Les tools fonctionnent immédiatement mais les widgets interactifs ne sont pas disponibles avec les connecteurs locaux. ### Prise en charge des widgets dans Claude Les 23–24 outils annoncés renvoient du texte structuré et des liens cliquables. Le serveur enregistre aussi 19 outils canoniques de cycle de vie pour les intégrations explicites. Le rendu des widgets dépend du client et de sa version ; l'intégration doit donc rester entièrement utilisable avec les seuls résultats structurés et textuels. ## Claude Code (CLI) ```bash claude mcp add --transport http minds https://getminds.ai/mcp ``` Exécutez `/mcp` dans Claude Code et choisissez **Authenticate** pour vous connecter avec OAuth. Pour utiliser une clé d'API, ajoutez `--header "Authorization: Bearer minds_YOUR_API_KEY"`. ## Codex Dans l'app Codex, ouvrez **Settings → MCPs**, ajoutez `https://getminds.ai/mcp` et choisissez **Authenticate**. Laissez vides les champs de jeton bearer et d'en-têtes pour utiliser OAuth. Avec la CLI Codex : ```bash codex mcp add minds --url https://getminds.ai/mcp codex mcp login minds ``` Pour utiliser une clé d'API, ajoutez l'en-tête `Authorization: Bearer minds_YOUR_API_KEY`. ## Gemini CLI Ajoutez le serveur à `~/.gemini/settings.json` : ```json { "mcpServers": { "minds": { "httpUrl": "https://getminds.ai/mcp" } } } ``` Gemini CLI détecte OAuth sur le serveur et ouvre la page de connexion à la première utilisation. Vous pouvez aussi exécuter `/mcp auth minds`. ## Cursor 1. Ouvrez Cursor Settings → **MCP** et ajoutez un nouveau serveur, ou ajoutez-le à `~/.cursor/mcp.json` : ```json { "mcpServers": { "minds": { "url": "https://getminds.ai/mcp" } } } ``` 1. Choisissez **Login** lorsque Cursor le demande, puis connectez-vous à Minds. ## VS Code (GitHub Copilot) 1. Exécutez **MCP: Add Server** depuis la palette de commandes, choisissez **HTTP** et saisissez `https://getminds.ai/mcp`. Ou ajoutez-le à `.vscode/mcp.json` : ```json { "servers": { "minds": { "type": "http", "url": "https://getminds.ai/mcp" } } } ``` 1. Démarrez le serveur et autorisez VS Code à se connecter à Minds lorsqu'il le demande. ## OpenRouter, Open WebUI et passerelles compatibles OpenAI L’authentification dépend du client qui exécute la requête MCP et du justificatif qu’il transmet. Une clé API du fournisseur de modèle n’authentifie pas auprès de Minds. ### Transmission du jeton OAuth L’API Responses d’OpenAI accepte un jeton OAuth existant dans le champ `authorization` de l’outil MCP. Votre application gère séparément l’autorisation et le renouvellement et fournit le jeton à chaque requête. Consultez le [guide d’authentification MCP d’OpenAI](https://developers.openai.com/api/docs/guides/tools-connectors-mcp). ### Open WebUI / OpenRouter Configurez une connexion Streamable HTTP vers `https://getminds.ai/mcp`. Si le client ou le mode choisi ne peut pas terminer OAuth et transmettre le jeton, créez une clé Minds dans [Paramètres → Clés API](/settings/api-keys) et configurez Bearer via le stockage sécurisé du client. Testez avec `list_audiences`. Pour OpenRouter et les autres passerelles, vérifiez la prise en charge MCP et le format du descripteur ; la compatibilité Chat Completions avec OpenAI ne garantit pas le MCP distant. ### Exemple avec l’API Responses d’OpenAI Cet exemple lit une clé API Minds dans l’environnement. Pour OAuth, remplacez `headers` par `"authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"]` après obtention d’un jeton Minds valide par votre application. ```python import os from openai import OpenAI client = OpenAI() response = client.responses.create( model="gpt-5.2", input="List my Audiences", tools=[{ "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"}, "allowed_tools": ["list_audiences"], "require_approval": "never", }], ) print(response.output_text) ``` ## Authentification par API key Pour un accès programmatique ou les clients qui ne prennent pas en charge OAuth : 1. Allez dans [Settings → API Keys](/settings/api-keys) dans Minds 2. Créez une nouvelle API key (commence par `minds_`) 3. Passez-la comme Bearer token : `Authorization: Bearer minds_your_key_here` ## OAuth Discovery Pour les développeurs qui construisent des intégrations MCP, les métadonnées OAuth sont disponibles à :
Endpoint Description
/.well-known/oauth-protected-resource Métadonnées de la ressource protégée (RFC 9728)
/.well-known/oauth-authorization-server Métadonnées du serveur d'autorisation (RFC 8414)
/oauth/register Dynamic Client Registration (RFC 7591)
OAuth 2.1 avec PKCE (S256) est requis. Les clients publics (`token_endpoint_auth_method: "none"`) sont pris en charge. Les clients natifs peuvent enregistrer des URI de redirection loopback (`http://127.0.0.1`, `http://localhost`, `http://[::1]`) ; le port n'est pas comparé, un client peut donc écouter sur n'importe quel port libre (RFC 8252). Un client peut aussi utiliser un Client ID Metadata Document : une URL https servant de `client_id` qui publie ses métadonnées (`client_id_metadata_document_supported: true`). Le point de terminaison de jeton accepte le `client_id` dans le corps de la requête ou via une authentification HTTP Basic avec un secret vide. ## Dépannage ### Erreur « Authentication required » Assurez-vous d'avoir complété le flow d'autorisation OAuth. Déconnectez puis reconnectez votre client MCP pour réautoriser. Vérifiez que le composant exécutant MCP transmet un justificatif Bearer Minds valide. Reconnectez OAuth ou renouvelez le jeton via son client propriétaire ; utilisez une clé API si l’intégration ne transmet pas les jetons OAuth. Une clé fournisseur ou une connexion à l’hôte ne remplace pas un justificatif Minds. ### « Not authorized » pour une Study, une Audience ou un Mind que vous pouvez ouvrir dans Minds Le client MCP est connecté à un autre compte Minds que celui qui possède l'élément ; l'erreur indique le compte connecté. Reconnectez le client avec le compte propriétaire ou partagez l'élément avec le compte connecté. ### L'OAuth de Claude Desktop ne se termine pas Si la popup OAuth s'ouvre mais ne se termine jamais, essayez l'approche par API key (Option B ci-dessus). L'OAuth du connecteur distant de Claude Desktop peut être intermittent. ### Mind introuvable Lorsque vous utilisez `mindName`, assurez-vous que le nom correspond étroitement à votre Mind. Le système utilise un fuzzy matching mais requiert un score de similarité raisonnable. ### Mind encore en cours d'entraînement Les nouveaux Minds peuvent prendre un moment pour terminer leur entraînement. Utilisez `get_mind_status` pour vérifier si l'entraînement est terminé avant de discuter. ### Timeout de question de study Les questions de study avec de nombreux audiencees peuvent prendre plus de 2 minutes. Essayez de réduire le nombre de audiencees ou de simplifier la question. ### Export PDF non prêt Les exports sont asynchrones. Interrogez `get_study_status` avec la même `studyId` et les valeurs exactes `exportKind`, `exportFormat` et `exportJobId` renvoyées par `export_study`. Vérifiez l’état du travail et l’URL de téléchargement ; la durée varie. Un délai d’interrogation dépassé n’autorise pas un export en double. ### Les résultats restent en chargement ou semblent incomplets Les widgets utilisent les mises à jour de l’hôte et interrogent automatiquement le statut pendant une durée limitée lorsque l’hôte le permet. Cela ne garantit pas un flux continu de tokens. Sinon, utilisez Actualiser si proposé, demandez le statut de la Study existante ou suivez le lien Minds retourné. Utilisez `get_study_status` pour une question directe et `get_study_run` pour un plan confirmé. Conservez le même `studyId` ; un chargement ou un délai dépassé ne justifie pas une nouvelle exécution. Signalez les réponses partielles et leur couverture incomplète. Des questions terminées ne prouvent pas que chaque Mind a répondu. ## Workflows n8n Utilisez le [nœud communautaire Minds pour n8n](/guide/integration-n8n) pour créer des Études, prévisualiser des plans de recherche, récupérer des Études et des résumés enregistrés, ou exposer une opération à un Agent IA. Installez `n8n-nodes-minds` sur n8n auto-hébergé et connectez une clé API Minds. Le package est publié sur npm ; la vérification n8n est en cours d'examen, il n'est donc pas encore disponible sur n8n Cloud. Examinez et démarrez la recherche séparément dans Minds.