Zum Hauptinhalt springen

​
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 <vollständiger-schlüssel> 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.