--- 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-08-13T13:01:13.755Z" --- # Client-Einrichtung 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 1. In **ChatGPT** → **Settings** → **Connected Apps** gehen. 2. Nach „Minds" suchen oder die MCP-URL hinzufügen: `https://getminds.ai/mcp`. 3. Auf **Connect** klicken und per OAuth autorisieren (in deinem Minds-Konto anmelden). 4. Loslegen — ChatGPT bitten, Minds zu erstellen, Panels zu fahren und Ergebnisse auszuwerten. ChatGPT rendert interaktive Widgets inline — Panel-Ergebnisse mit gruppierten Antworten, Balkendiagrammen und klickbaren Mind-Avataren erscheinen direkt im Chat. ## Claude Desktop ### Option A: Remote-Connector (empfohlen — inkl. interaktiver Widgets) 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 15 beworbenen Tools liefern strukturierte Textantworten und klickbare Links. Zusätzlich registriert der Server 18 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 mindsai https://getminds.ai/mcp \ --header "Authorization: Bearer minds_DEIN_API_KEY" ``` ## Cursor 1. Cursor Settings öffnen → **MCP**. 2. Neuen Server mit URL hinzufügen: `https://getminds.ai/mcp`. 3. Bei Aufforderung Zugriff autorisieren. ## VS Code (GitHub Copilot) 1. VS Code Settings öffnen → **Extensions** → **GitHub Copilot** → **MCP Servers**. 2. `https://getminds.ai/mcp` als neuen Server hinzufügen. 3. Bei Aufforderung autorisieren. ## OpenRouter, Open WebUI und OpenAI-kompatible Gateways Wenn der **Modell-Anbieter** (nicht der Host) den MCP-Aufruf serverseitig ausführt — z. B. ein `openai/*`-Modell via OpenRouter, OpenAI-Responses-API direkt oder Open WebUI im Modus *Native Function-Calling* — musst du **API-Key-Authentifizierung** verwenden. OAuth funktioniert auf diesem Pfad nicht. ### Warum OAuth hier nicht funktioniert Wenn Open WebUI einen `openai/gpt-5.2`-Agent im Native-Modus betreibt, schickt es den MCP-Tool-Deskriptor als Teil der Anfrage an OpenAI/OpenRouter. OpenAIs serverseitiger MCP-Runner (läuft auf Azure, erkennbar an `User-Agent: python-httpx/*`) ruft dann unseren `/mcp`-Endpunkt direkt auf. Dieser Runner hängt nur **statische** Header an, die bei der Tool-Registrierung gesetzt wurden — er fertigt **keinen** MCP-OAuth-Handshake (RFC 9728 / 8414 / 7591) aus. Open WebUIs Modus *OAuth — leitet OAuth-Zugriffstoken des Systembenutzers weiter* ist deshalb hier wirkungslos: Das Token verlässt Open WebUI nie. Resultat: Minds erhält die Anfrage ohne `Authorization`-Header und antwortet: ```text 401 Unauthorized www-authenticate: Bearer resource_metadata="https://getminds.ai/.well-known/oauth-protected-resource" {"error":{"code":-32001,"message":"Authentication required. Connect your Minds account via OAuth or provide an API key."}} ``` ### Open-WebUI-Setup 1. API-Key in [Settings → API Keys](/settings/api-keys) erstellen (Format `minds_…`). 2. In Open WebUI: **Admin → Einstellungen → Werkzeuge → + Verbindung**. 3. Setzen: - **Typ**: `MCP Streambares HTTP` - **URL**: `https://getminds.ai/mcp` - **Authentifizierung**: `Bearer` *(nicht OAuth)* - **Token**: dein `minds_…`-Key 4. Verbindung speichern. 5. Im Tab *Werkzeuge* deines Agenten das **Get Minds**-Tool aktivieren. 6. Test: den Agenten bitten, deine Minds aufzulisten. Wenn `Authentifizierung: OAuth` bleibt, klappen Aufrufe nur, wenn Open WebUI das Tool selbst ausführt (also *Funktionsaufruf = Standard*, nicht *Nativ*). Die meisten Nutzer:innen wollen den Native-Modus — also Bearer-Key verwenden. ### OpenRouter direkt (programmatisch) Beim Aufruf der OpenRouter-Chat-Completions-API mit angehängtem Minds-MCP-Server: API-Key im statischen `headers`-Feld des Tool-Deskriptors mitgeben: ```json { "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": { "Authorization": "Bearer minds_DEIN_API_KEY" } } ``` Gleiches gilt für OpenAIs Responses-API direkt: ```python from openai import OpenAI client = OpenAI() client.responses.create( model="gpt-5.2", input="Liste meine Minds", tools=[{ "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"}, }], ) ``` ## 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. ## Fehlerbehebung ### Fehler „Authentication required" Prüf, ob der OAuth-Autorisierungsablauf abgeschlossen wurde. MCP-Client trennen und erneut verbinden, um neu zu autorisieren. Wenn du Minds über **OpenRouter, Open WebUI im Native-Modus oder OpenAIs Responses-API direkt** aufrufst, ist OAuth auf diesem Pfad nicht möglich — der serverseitige MCP-Runner des Modell-Anbieters kann den OAuth-Handshake nicht ausführen. Stell die MCP-Verbindung auf **Bearer / API-Key-Authentifizierung** mit einem `minds_…`-Key um. Siehe Abschnitt [OpenRouter, Open WebUI und OpenAI-kompatible Gateways](#openrouter-open-webui-und-openai-kompatible-gateways) oben. ### 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 `sparkName` 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 Panel-Frage Panel-Fragen mit vielen Gruppen können über 2 Minuten dauern. Reduziere die Anzahl der Gruppen oder vereinfache die Frage. ### PDF-Export noch nicht bereit PDF-Reports werden asynchron erzeugt. Mit `get_panel_status` den Export-Status prüfen. Die Generierung dauert üblicherweise 30–60 Sekunden.