Configuration du client

Chaque client ci-dessous voit les mêmes 31 outils annoncés, lus sur le serveur en direct. 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.

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.

Si Minds apparaît dans l'annuaire des plugins de votre compte, vous pouvez aussi l'ajouter depuis Plugins et vous connecter de la même manière.

Dans l'application de bureau ChatGPT, ouvrez Plugins et choisissez Add → Add MCP server. Définissez le type sur Streamable HTTP et l'URL sur https://getminds.ai/mcp, cliquez sur Save, puis sur Restart, et choisissez Authenticate pour vous connecter à Minds.

Le guide de configuration ChatGPT détaille chaque écran, y compris l'annuaire des plugins et l'application de bureau.

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 (claude.ai et Claude Desktop)

Connecteur distant (widgets selon le client)

Les connecteurs personnalisés fonctionnent de la même façon sur claude.ai et dans Claude Desktop, et se synchronisent entre les deux.

1. Ouvrez Customize → Connectors, cliquez sur + et choisissez Add custom connector
2. Saisissez https://getminds.ai/mcp comme URL du serveur MCP distant et cliquez sur Add
3. Cliquez sur Connect, connectez-vous à votre compte Minds et choisissez Allow
4. Dans une conversation, activez Minds via + → Connectors

Sur les offres Team et Enterprise, un propriétaire ajoute d'abord le connecteur dans Organization settings → Connectors ; les membres connectent ensuite leur propre compte Minds dans Customize → Connectors.

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 outils annoncés renvoient du texte structuré et des liens cliquables pour ouvrir les résultats dans la webapp Minds. Le serveur maintient aussi d'autres outils canoniques de cycle de vie appelables pour les intégrations explicites ; consultez la référence des outils. 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, sélectionnez minds et choisissez Authenticate pour vous connecter avec OAuth. Une clé d'API est facultative : pour en utiliser une, ajoutez --header "Authorization: Bearer minds_YOUR_API_KEY" à la commande.

Codex

Avec la CLI Codex :

codex mcp add minds --url https://getminds.ai/mcp
codex mcp login minds

codex mcp login ouvre la page de connexion Minds. Codex s'enregistre avec un Client ID Metadata Document : vous n'avez besoin ni d'identifiant client ni de secret.

Dans l'app Codex ou l'extension IDE, ouvrez Settings → MCP servers, choisissez Add server, sélectionnez Streamable HTTP et saisissez https://getminds.ai/mcp. Enregistrez, redémarrez, puis choisissez Authenticate.

Pour utiliser une clé d'API, définissez bearer_token_env_var = "MINDS_API_KEY" sous [mcp_servers.minds] dans ~/.codex/config.toml et exportez la clé dans cette variable.

Gemini CLI

Ajoutez le serveur à ~/.gemini/settings.json :

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

Ou exécutez gemini mcp add --transport http minds 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.

Google Antigravity

Ajoutez le serveur à ~/.gemini/config/mcp_config.json (ou à .agents/mcp_config.json dans un espace de travail). Antigravity exige serverUrl ; il n'accepte ni url ni httpUrl :

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

Ou exécutez agy mcp add --type http minds https://getminds.ai/mcp. Pour vous connecter, ouvrez Settings → Customizations, choisissez Authenticate à côté de minds, puis collez le code affiché après la connexion. L'installation du plugin et les clés API sont décrites dans Minds dans Google Antigravity.

Cursor

1. Ajoutez le serveur à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet :

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

2. Authentifiez-vous 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 :

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

2. Démarrez le serveur et autorisez VS Code à se connecter à Minds lorsqu'il le demande. Les outils Minds apparaissent ensuite dans Copilot Chat en mode agent.

Windsurf

Dans le panneau Cascade, ouvrez le menu … et choisissez Open MCP config file. Ajoutez Minds sous mcpServers :

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

Enregistrez le fichier, puis connectez-vous à Minds lorsque Windsurf le demande. Pour utiliser une clé d'API, ajoutez "headers": { "Authorization": "Bearer ${env:MINDS_API_KEY}" } à l'entrée.

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 :

1. Allez dans 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

Scopes

Les clients OAuth demandent les autorisations OpenID de base (openid, email, profile) ainsi que les scopes Minds ci-dessous. L'écran de consentement Minds présente chaque scope en termes produit avant que vous ne choisissiez Allow. Un client qui ne demande aucun scope les reçoit tous.

OAuth Discovery

Pour les développeurs qui construisent des intégrations MCP, les métadonnées OAuth sont disponibles à :

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.