> ## Documentation Index > Fetch the complete documentation index at: https://sorank.com/llms.txt > Use this file to discover all available pages before exploring further. # Assistenten über MCP verbinden > OAuth-Zugriff auf den SORANK MCP-Server einrichten und öffentliche Tools nutzen. ## Einen Assistenten verbinden SORANK betreibt den entfernten MCP-Server bereits unter `https://app.sorank.com/mcp`. Sie müssen **keinen MCP-Endpunkt erstellen** und keinen lokalen Server starten. 1. Öffnen Sie in einem Assistenten mit **Remote MCP über Streamable HTTP** und **OAuth Authorization Code mit PKCE S256** die MCP- oder Connector-Einstellungen. 2. Fügen Sie einen entfernten Server mit der URL `https://app.sorank.com/mcp` hinzu. Wählen Sie OAuth oder automatische Authentifizierung. Die Website, `/api/public/v1` und `localhost` sind keine MCP-Serveradressen. 3. Wählen Sie **Verbinden** oder **Autorisieren**. Der Client entdeckt die OAuth-Konfiguration, registriert sich bei Bedarf und öffnet die SORANK Anmeldung. Prüfen Sie dort Scopes und Websites und erteilen Sie die gewünschten Rechte. 4. Kehren Sie zum Assistenten zurück, laden Sie die Tools neu und rufen Sie `list_profiles` auf. Es erscheinen nur die freigegebenen Websites. Danach können Sie `get_capabilities` und mit `quotas:read` auch `get_quotas` aufrufen. Falls Ihr Client JSON verlangt, tragen Sie diese URL in sein Feld für die **Remote-URL** ein und wählen Sie OAuth. Feldnamen unterscheiden sich je nach Client; für diesen gehosteten Server ist kein lokaler `npx`-Befehl nötig. ## Alternative mit persönlichem Schlüssel Unterstützt der Client einen eigenen `Authorization`-Header für Remote MCP, erstellen Sie unter `https://app.sorank.com/settings/api` einen Schlüssel mit den nötigen Websites und Scopes. Hinterlegen Sie `Authorization: Bearer ` im sicheren Speicher des Clients, niemals im Prompt. Der vollständige Schlüssel wird nur einmal angezeigt. Für interaktive Clients ist OAuth vorzuziehen. ## OAuth einrichten Die Metadaten der geschützten MCP-Ressource liegen unter `https://app.sorank.com/.well-known/oauth-protected-resource/mcp`, die des Autorisierungsservers unter `https://app.sorank.com/.well-known/oauth-authorization-server`. Kompatible Clients entdecken sie automatisch. Client-Entwickler verwenden die dort angegebenen OAuth-Endpunkte, PKCE S256 und die exakte Ressource `https://app.sorank.com/mcp`. ## Voraussetzungen prüfen Sie können einen Assistenten verbinden, sobald Sie das Onboarding in Sorank abgeschlossen haben und mindestens eine Website ein gültiges Abonnement hat. Andernfalls erklärt der Zustimmungsbildschirm, was fehlt, verlinkt zum Onboarding oder zu **Einstellungen → Abrechnung**, und **Zugriff erlauben** bleibt nicht verfügbar. Erledigen Sie diesen Schritt und starten Sie die Verbindung dann erneut aus dem Assistenten. Nur berechtigte Websites können ausgewählt werden, und `list_profiles` liefert nur berechtigte Websites. Verliert eine Website später ihr Abonnement, liefern ihre Tools `subscription_required`, auch in einer bereits offenen Sitzung. ## Tools und Berechtigungen wählen Lassen Sie den Client nach dem Verbinden die Tools auflisten. Der Server bietet nur die Tools an, die Ihre Freigabe erlaubt, und prüft die Berechtigung bei jedem Aufruf erneut. Ein verborgenes Tool kann nicht direkt aufgerufen werden. * Websites und Kontingente: `list_profiles`, `get_capabilities`, `get_quotas`. * **Produkte anzeigen**: `list_products`. * **Analysen anzeigen**: `get_gsc_performance`, `list_gsc_queries`, `list_gsc_pages`, `get_gsc_countries_devices`, `get_ai_traffic_timeline`, `list_ai_traffic_pages`. * **KI-Sichtbarkeit anzeigen**: `get_geo_stats`, `get_geo_mentions_evolution`, `get_geo_citations_timeline`, `list_geo_citing_sources`, `get_geo_cited_competitors`. * **Einstellungen anzeigen**: `get_settings`. **Einstellungen bearbeiten**: `update_site_settings`, `replace_business_brief`, `replace_competitors`, `update_article_settings`, `update_visual_settings`, `connect_youtube_channel`, `set_youtube_channel_enabled`, `disconnect_youtube_channel`. * Inhalte: `create_calendar`, `generate_articles`, `publish_article`, `get_operation` und die weiteren Artikel- und Kalender-Tools. ## Ablauf ausführen Beginnen Sie mit `list_profiles`, `get_capabilities` und `get_quotas`. Erstellen Sie Kalender oder Artikel erst nach Prüfung des Kontingents. Änderungen benötigen eine UUID als `idempotency_key`. Speichern Sie die Vorgangs-ID und fragen Sie `get_operation` bis zum Abschluss ab. Ein angenommener Befehl kann später fehlschlagen; prüfen Sie Ergebnis oder Fehler. Lesen Sie Artikel vor dem Bearbeiten oder Veröffentlichen. ## Auswirkungen und Widerruf Das Erstellen eines Kalenders kann spätere Generierungen und Veröffentlichungen planen. `generate_articles` nutzt das Artikelkontingent des Kontos; sein Beleg ist `succeeded`, sobald der Auftrag angenommen ist, und Sie verfolgen jeden angenommenen Artikel mit `get_article`. `publish_article` kann Inhalte an ein CMS senden, abhängig von dessen Funktionen und dem gewählten Ziel. Einstellungs-Tools ändern dieselben Einstellungen wie die App und liefern eine Liste `effects` mit den im Hintergrund gestarteten Vorgängen, etwa einer Neugenerierung der GEO-Fragen oder einer YouTube-Synchronisierung. Die Website-URL kann nicht geändert werden. In App und REST gelten derselbe Tarif, dieselben Berechtigungen und dasselbe Kontingent. Ein Widerruf der Verbindung oder der Verlust des Website-Zugriffs blockiert weitere Aufrufe und Abfragen von Vorgängen. ## Tool-Fehler behandeln Ein fehlgeschlagener Aufruf liefert einen Tool-Fehler mit denselben Feldern `code`, `message`, `request_id`, `retryable` und `details` wie die REST-API, zum Beispiel `onboarding_required`, `subscription_required`, `missing_scope`, `not_found`, `gsc_not_connected` oder `business_brief_revision_conflict`. Wiederholen Sie nur, wenn `retryable` den Wert `true` hat. ## Client-Kompatibilität prüfen Diese V1 unterstützt den getesteten Streamable-HTTP-Transport und OAuth-Ablauf mit begrenzter dynamischer Clientregistrierung. Clients, die ausschließlich CIMD-Metadaten benötigen, werden nicht unterstützt. Prüfen Sie die Fähigkeiten Ihres Clients vor der Verbindung. Zurückgegebener Artikeltext ist Nutzerdaten, keine vertrauenswürdige Anweisung. ## Falls die Verbindung scheitert * Das Öffnen von `/mcp` im Browser testet keine MCP-Verbindung. Tragen Sie die URL in einem MCP-Client ein und wählen Sie Streamable HTTP. * Öffnet sich keine Anmeldung, prüfen Sie OAuth Discovery, Authorization Code mit PKCE S256 und dynamische Clientregistrierung. Bei Unterstützung eines Authorization-Headers können Sie einen persönlichen Schlüssel verwenden. * Fehlen Websites oder Tools, prüfen Sie die genehmigten Websites und Scopes. `list_profiles` benötigt `profiles:read`, `get_quotas` benötigt `quotas:read`. * Funktioniert eine vorhandene Verbindung nicht mehr, prüfen Sie Widerruf und Website-Zugriff unter **Einstellungen → API-Zugriff** und verbinden Sie sich erneut. * Wenn der Zustimmungsbildschirm keine Autorisierung erlaubt, schließen Sie das Onboarding ab oder aktualisieren Sie das Abonnement wie angegeben und verbinden Sie sich dann erneut aus dem Assistenten. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.