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é 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.

Ouvrez Settings → Apps et connectez Minds s’il est disponible pour votre compte.
Pour une connexion personnalisée, activez Developer mode si autorisé, choisissez Apps → Create et saisissez https://getminds.ai/mcp.
Choisissez OAuth et connectez-vous à Minds. Terminez l’analyse des outils et la configuration.
Sélectionnez Minds dans une nouvelle conversation et demandez la liste de vos Audiences. Les Studies plus larges nécessitent une révision et une confirmation explicite avant exécution.

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)

Ouvrez Claude Desktop → Customize → Connectors (ou Settings → Connections)
Ajoutez https://getminds.ai/mcp comme nouveau connecteur distant
Autorisez via OAuth lorsque demandé — connectez-vous à votre compte Minds
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) :

{
  "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)

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 :

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 :

{
  "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

Ouvrez Cursor Settings → MCP et ajoutez un nouveau serveur, ou ajoutez-le à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}

Choisissez Login lorsque Cursor le demande, puis connectez-vous à Minds.

VS Code (GitHub Copilot)

Exécutez MCP: Add Server depuis la palette de commandes, choisissez HTTP et saisissez https://getminds.ai/mcp. Ou ajoutez-le à .vscode/mcp.json :

{
  "servers": {
    "minds": { "type": "http", "url": "https://getminds.ai/mcp" }
  }
}

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.

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 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.

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 :

Allez dans Settings → API Keys dans Minds
Créez une nouvelle API key (commence par minds_)
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 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.