--- title: "Client-Einrichtung" description: "Minds MCP mit ChatGPT, Claude Desktop, Cursor und weiteren Clients einrichten." canonical_url: "https://getminds.ai/mcp/de/setup" last_updated: "2026-09-30T12:20:32.675Z" --- # Client-Einrichtung Die Verfügbarkeit hängt von der Bereitstellung ab: Die reguläre Erkennung liefert 23 Tools bzw. 24 mit aktiviertem `list_model_connections`; insgesamt sind entsprechend 42 oder 43 kanonische Tools registriert. Maßgeblich ist die Antwort des verbundenen Servers auf `tools/list`. Dieser Guide verbindet den [Minds MCP Server für Marktforschung](/mcp/overview) 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](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). 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. Die [ChatGPT-Anleitung](/guide/integration-chatgpt) zeigt jeden Schritt mit Screenshots, auch die Option über das Plugin-Verzeichnis. 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 Desktop ### Remote-Connector (Widget-Unterstützung hängt vom Client ab) 1. Claude Desktop öffnen → **Customize** → **Connectors** (oder **Settings** → **Connections**). 2. `https://getminds.ai/mcp` als neuen Remote-Connector hinzufügen. 3. Bei Aufforderung per OAuth autorisieren — in deinem Minds-Konto anmelden. 4. Die Tools erscheinen nach der Autorisierung automatisch. ### Option B: Lokaler Connector (API key, reiner Text) In der Config-Datei ergänzen (`~/Library/Application Support/Claude/claude_desktop_config.json` auf macOS): ```json { "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 23–24 beworbenen Tools liefern strukturierte Textantworten und klickbare Links. Zusätzlich registriert der Server 19 kanonische Lifecycle-Tools für explizite Integrationen. 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) ```bash claude mcp add --transport http minds https://getminds.ai/mcp ``` Führe in Claude Code `/mcp` aus und wähle **Authenticate**, um dich per OAuth anzumelden. Für einen API-Key stattdessen `--header "Authorization: Bearer minds_YOUR_API_KEY"` ergänzen. ## Codex Öffne in der Codex-App **Settings → MCPs**, füge `https://getminds.ai/mcp` hinzu und wähle **Authenticate**. Lass die Felder für Bearer-Token und Header leer, um OAuth zu nutzen. Mit der Codex CLI: ```bash codex mcp add minds --url https://getminds.ai/mcp codex mcp login minds ``` Für einen API-Key stattdessen den Header `Authorization: Bearer minds_YOUR_API_KEY` setzen. ## Gemini CLI Füge den Server zu `~/.gemini/settings.json` hinzu: ```json { "mcpServers": { "minds": { "httpUrl": "https://getminds.ai/mcp" } } } ``` Gemini CLI erkennt OAuth am Server und öffnet beim ersten Aufruf die Anmeldeseite. Alternativ `/mcp auth minds` ausführen. ## Cursor 1. Öffne Cursor Settings → **MCP** und füge einen neuen Server hinzu, oder trage ihn in `~/.cursor/mcp.json` ein: ```json { "mcpServers": { "minds": { "url": "https://getminds.ai/mcp" } } } ``` 1. Wähle **Login**, 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: ```json { "servers": { "minds": { "type": "http", "url": "https://getminds.ai/mcp" } } } ``` 1. Starte den Server und erlaube VS Code die Anmeldung bei Minds, wenn danach gefragt wird. ## 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](https://developers.openai.com/api/docs/guides/tools-connectors-mcp). ### 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](/settings/api-keys) 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. ```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) ``` ## API-Key-Authentifizierung Für programmatischen Zugriff oder Clients ohne OAuth-Support: 1. In Minds auf [Settings → API Keys](/settings/api-keys) gehen. 2. Neuen API-Key erstellen (beginnt mit `minds_`). 3. Als Bearer-Token mitgeben: `Authorization: Bearer minds_dein_key_hier`. ## OAuth-Discovery Für Entwickler:innen, die MCP-Integrationen bauen — OAuth-Metadaten liegen unter:
Endpoint Beschreibung
/.well-known/oauth-protected-resource Protected-Resource-Metadata (RFC 9728)
/.well-known/oauth-authorization-server Authorization-Server-Metadata (RFC 8414)
/oauth/register Dynamic Client Registration (RFC 7591)
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](/guide/integration-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.