Client-Einrichtung

Jeder der folgenden Clients sieht dieselben 31 angebotenen Tools, live vom Server gelesen. Maßgeblich ist die Antwort des verbundenen Servers auf tools/list.

Dieser Guide verbindet den Minds MCP Server für Marktforschung mit den AI-Clients, die Remote-Tools unterstützen. Nutze https://getminds.ai/mcp als Server-URL.

ChatGPT

Nutze ChatGPT im Web. Verfügbarkeit und Berechtigungen hängen von Konto und Workspace ab; beachte OpenAIs aktuelle MCP-Anleitung.

1. Öffne Plugins und wähle Add → Create MCP App. Fehlt die Option, aktiviere den Entwicklermodus oder bitte deinen Workspace-Admin, eigene MCP-Apps zu erlauben.
2. Nenne die App Minds, trage unter Server URL https://getminds.ai/mcp ein, wähle bei Authentication OAuth, bestätige den Risikohinweis und klicke auf Create.
3. Klicke auf Continue to Minds, melde dich bei Minds an und wähle Allow.
4. Tippe in einem neuen Gespräch @Minds und lass deine Audiences auflisten. Umfangreichere Studies benötigen vor der Ausführung eine Prüfung und ausdrückliche Bestätigung.

Wenn Minds für dein Konto im Plugin-Verzeichnis erscheint, kannst du es auch über Plugins hinzufügen und dich auf dieselbe Weise anmelden.

Öffne in der ChatGPT-Desktop-App Plugins und wähle Add → Add MCP server. Setze den Typ auf Streamable HTTP und die URL auf https://getminds.ai/mcp, klicke auf Save, dann auf Restart, und wähle Authenticate, um dich bei Minds anzumelden.

Die ChatGPT-Anleitung zeigt jeden Schritt mit Screenshots, auch die Optionen über das Plugin-Verzeichnis und die Desktop-App.

Kompatible Web-Hosts können Ergebnisse direkt anzeigen. Auf mobilen Hosts bietet ein dargestelltes Minds-Widget einen Link zum Fortsetzen in Minds statt interaktiver Bedienelemente.

Claude (claude.ai und Claude Desktop)

Remote-Connector (Widget-Unterstützung hängt vom Client ab)

Eigene Connectors funktionieren auf claude.ai und in Claude Desktop gleich und werden zwischen beiden synchronisiert.

1. Öffne Customize → Connectors, klicke auf + und wähle Add custom connector.
2. Gib https://getminds.ai/mcp als URL des Remote-MCP-Servers ein und klicke auf Add.
3. Klicke auf Connect, melde dich bei deinem Minds-Konto an und wähle Allow.
4. Aktiviere Minds in einem Gespräch über + → Connectors.

In Team- und Enterprise-Plänen fügt zuerst ein Owner den Connector unter Organization settings → Connectors hinzu; anschließend verbinden die Mitglieder unter Customize → Connectors ihr eigenes Minds-Konto.

Option B: Lokaler Connector (API key, reiner Text)

In der Config-Datei ergänzen (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS):

{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://getminds.ai/mcp",
        "--header",
        "Authorization: Bearer minds_DEIN_API_KEY"
      ]
    }
  }
}

Claude Desktop neu starten. Die Tools funktionieren sofort, interaktive Widgets stehen im lokalen Connector jedoch nicht zur Verfügung.

Widget-Unterstützung in Claude

Die angebotenen Tools liefern strukturierte Textantworten und klickbare Links. Zusätzlich hält der Server weitere kanonische Lifecycle-Tools für explizite Integrationen aufrufbar; siehe die Tool-Referenz. Die Widget-Darstellung hängt vom Client und dessen Version ab; Integrationen müssen deshalb allein mit strukturierten Textresultaten vollständig nutzbar bleiben.

Claude Code (CLI)

claude mcp add --transport http minds https://getminds.ai/mcp

Führe in Claude Code /mcp aus, wähle minds und dann Authenticate, um dich per OAuth anzumelden. Ein API-Key ist optional: Um stattdessen einen zu nutzen, ergänze den Befehl um --header "Authorization: Bearer minds_YOUR_API_KEY".

Codex

Mit der Codex CLI:

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

codex mcp login öffnet die Minds-Anmeldeseite. Codex registriert sich mit einem Client ID Metadata Document, daher brauchst du weder Client-ID noch Secret.

Öffne in der Codex-App oder IDE-Erweiterung Settings → MCP servers, wähle Add server, dann Streamable HTTP, und gib https://getminds.ai/mcp ein. Speichern, neu starten und Authenticate wählen.

Um stattdessen einen API-Key zu nutzen, setze bearer_token_env_var = "MINDS_API_KEY" unter [mcp_servers.minds] in ~/.codex/config.toml und exportiere den Key in dieser Variable.

Gemini CLI

Füge den Server zu ~/.gemini/settings.json hinzu:

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

Oder führe gemini mcp add --transport http minds https://getminds.ai/mcp aus. Gemini CLI erkennt OAuth am Server und öffnet beim ersten Aufruf die Anmeldeseite. Alternativ /mcp auth minds ausführen.

Google Antigravity

Trage den Server in ~/.gemini/config/mcp_config.json ein (oder in .agents/mcp_config.json eines Workspace). Antigravity braucht serverUrl; url und httpUrl werden nicht akzeptiert:

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

Oder führe agy mcp add --type http minds https://getminds.ai/mcp aus. Zum Anmelden öffnest du Settings → Customizations, wählst Authenticate neben minds und fügst danach den angezeigten Code ein. Plugin-Installation und API-Keys erklärt Minds in Google Antigravity.

Cursor

1. Trage den Server in ~/.cursor/mcp.json ein, oder in einem Projekt in .cursor/mcp.json:

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

2. Authentifiziere dich, wenn Cursor danach fragt, und melde dich bei Minds an.

VS Code (GitHub Copilot)

1. Führe in der Befehlspalette MCP: Add Server aus, wähle HTTP und gib https://getminds.ai/mcp ein. Oder trage ihn in .vscode/mcp.json ein:

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

2. Starte den Server und erlaube VS Code die Anmeldung bei Minds, wenn danach gefragt wird. Die Minds-Tools erscheinen dann in Copilot Chat im Agent-Modus.

Windsurf

Öffne im Cascade-Panel das Menü … und wähle Open MCP config file. Füge Minds unter mcpServers hinzu:

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

Speichere die Datei und melde dich bei Minds an, wenn Windsurf danach fragt. Um stattdessen einen API-Key zu nutzen, ergänze den Eintrag um "headers": { "Authorization": "Bearer ${env:MINDS_API_KEY}" }.

OpenRouter, Open WebUI und OpenAI-kompatible Gateways

Entscheidend ist, welcher Client den MCP-Aufruf ausführt und welche Zugangsdaten er weiterleitet. Der API-Key eines Modellanbieters authentifiziert nicht bei Minds.

OAuth-Token weiterleiten

OpenAIs Responses API akzeptiert ein vorhandenes OAuth-Zugriffstoken im Feld authorization des MCP-Tools. Deine Anwendung übernimmt Autorisierung und Token-Erneuerung separat und übergibt das Token bei jeder Anfrage. Siehe OpenAIs Anleitung zur MCP-Authentifizierung.

Open WebUI / OpenRouter

Konfiguriere eine Streamable-HTTP-Verbindung zu https://getminds.ai/mcp. Kann der Client oder Ausführungsmodus OAuth nicht abschließen und das Zugriffstoken weiterleiten, erstelle einen Minds-API-Key unter Einstellungen → API-Schlüssel und hinterlege ihn im geschützten Speicher des Clients für Bearer-Authentifizierung. Teste mit list_audiences. Prüfe bei OpenRouter und anderen Gateways deren aktuelle MCP-Unterstützung und das Deskriptorformat; OpenAI-kompatible Chat Completions allein garantieren keine Remote-MCP-Unterstützung.

Beispiel für OpenAIs Responses API

Das Beispiel liest einen Minds-API-Key aus der Umgebung. Ersetze für OAuth headers durch "authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"], nachdem deine Anwendung ein gültiges Minds-Zugriffstoken erhalten hat.

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)

API-Key-Authentifizierung

Für programmatischen Zugriff oder Clients ohne OAuth-Support:

1. In Minds auf Settings → API Keys gehen.
2. Neuen API-Key erstellen (beginnt mit minds_).
3. Als Bearer-Token mitgeben: Authorization: Bearer minds_dein_key_hier.

Scopes

OAuth-Clients fordern die OpenID-Grundlagen (openid, email, profile) und die unten aufgeführten Minds-Scopes an. Der Minds-Zustimmungsbildschirm beschreibt jeden Scope in Produktbegriffen, bevor du Allow wählst. Ein Client, der keinen Scope anfordert, erhält alle.

OAuth-Discovery

Für Entwickler:innen, die MCP-Integrationen bauen — OAuth-Metadaten liegen unter:

OAuth 2.1 mit PKCE (S256) ist Pflicht. Public Clients (token_endpoint_auth_method: "none") werden unterstützt.

Native Clients dürfen Loopback-Redirect-URIs registrieren (http://127.0.0.1, http://localhost, http://[::1]); der Port wird nicht verglichen, ein Client kann also auf jedem freien Port lauschen (RFC 8252). Ein Client kann auch ein Client ID Metadata Document verwenden: eine https-client_id-URL, unter der seine Metadaten liegen (client_id_metadata_document_supported: true). Der Token-Endpoint akzeptiert die client_id im Request-Body oder per HTTP-Basic-Authentifizierung mit leerem Secret.

Fehlerbehebung

Fehler „Authentication required"

Prüf, ob der OAuth-Autorisierungsablauf abgeschlossen wurde. MCP-Client trennen und erneut verbinden, um neu zu autorisieren.

Prüfe, ob die ausführende Komponente gültige Minds-Bearer-Zugangsdaten weiterleitet. Verbinde OAuth erneut oder erneuere das Zugriffstoken über den zuständigen Client. Nutze einen API-Key, wenn die Integration OAuth-Token nicht weiterleiten kann. Ein Anbieter-Key oder eine Host-Anmeldung ersetzt keine Minds-Zugangsdaten.

„Not authorized“ für eine Study, Audience oder Mind, die du in Minds öffnen kannst

Der MCP-Client ist mit einem anderen Minds-Konto angemeldet als dem, dem das Element gehört; die Fehlermeldung nennt das verbundene Konto. Verbinde den Client mit dem Eigentümerkonto neu oder teile das Element mit dem verbundenen Konto.

Claude Desktop OAuth schließt nicht ab

Wenn das OAuth-Popup öffnet, aber nie fertig wird, nutze den API-Key-Weg (Option B oben). Der OAuth-Flow von Claude Desktops Remote-Connector kann unzuverlässig sein.

Mind not found

Achte bei mindName darauf, dass der Name möglichst nah an deinem Mind liegt. Das System nutzt Fuzzy-Matching, braucht aber eine gewisse Ähnlichkeit.

Mind trainiert noch

Neu erstellte Minds brauchen einen Moment, bis das Training abgeschlossen ist. Mit get_mind_status prüfen, bevor du chattest.

Timeout bei Study-Frage

Study-Fragen mit vielen Audiences können über 2 Minuten dauern. Reduziere die Anzahl der Audiences oder vereinfache die Frage.

PDF-Export noch nicht bereit

Exporte laufen asynchron. Frage get_study_status mit derselben studyId und exakt den von export_study zurückgegebenen Werten für exportKind, exportFormat und exportJobId ab. Prüfe Auftragsstatus und Download-URL; die Dauer variiert. Ein Polling-Timeout erlaubt keinen doppelten Export.

Ergebnisse laden weiter oder wirken unvollständig

Ergebnis-Widgets übernehmen Host-Updates und fragen den Status automatisch für eine begrenzte Zeit ab, sofern der Host dies erlaubt. Kontinuierliches Token-Streaming ist damit nicht garantiert. Nutze andernfalls die angezeigte Aktualisieren-Funktion, bitte den Assistenten um den Status der bestehenden Study oder folge dem zurückgegebenen Minds-Link.

Für direkte Fragen dient get_study_status, für bestätigte Forschungspläne get_study_run. Behalte dieselbe studyId; ein Ladezustand oder Timeout rechtfertigt keine erneute Ausführung. Kennzeichne Teilantworten und Antwortabdeckung als unvollständig. Abgeschlossene Fragen allein belegen nicht, dass jeder Mind geantwortet hat.

n8n-Workflows

Verwenden Sie den Minds-Community-Node für n8n, um Studies zu erstellen, Forschungspläne in der Vorschau anzuzeigen, Studies und gespeicherte Zusammenfassungen abzurufen oder eine Operation für einen AI Agent bereitzustellen. Installieren Sie n8n-nodes-minds auf selbst gehostetem n8n und verbinden Sie einen Minds API-Schlüssel. Das Paket ist auf npm veröffentlicht; die n8n-Verifizierung wird geprüft, daher ist es auf n8n Cloud noch nicht verfügbar. Überprüfen und starten Sie die Forschung separat in Minds.