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

Öffne Settings → Apps und verbinde Minds, sofern es für dein Konto verfügbar ist.
Aktiviere für eine eigene Verbindung, soweit erlaubt, Developer mode, wähle Apps → Create und trage https://getminds.ai/mcp ein.
Wähle OAuth und melde dich bei Minds an. Schließe Tool-Scan und App-Einrichtung ab.
Wähle Minds in einem neuen Gespräch und lass deine Audiences auflisten. Umfangreichere Studies benötigen vor der Ausführung eine Prüfung und ausdrückliche Bestätigung.

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

Claude Desktop öffnen → Customize → Connectors (oder Settings → Connections).
https://getminds.ai/mcp als neuen Remote-Connector hinzufügen.
Bei Aufforderung per OAuth autorisieren — in deinem Minds-Konto anmelden.
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):

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

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)

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:

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:

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

Öffne Cursor Settings → MCP und füge einen neuen Server hinzu, oder trage ihn in ~/.cursor/mcp.json ein:

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

Wähle Login, wenn Cursor danach fragt, und melde dich bei Minds an.

VS Code (GitHub Copilot)

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

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.

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:

In Minds auf Settings → API Keys gehen.
Neuen API-Key erstellen (beginnt mit minds_).
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, 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.