Searchestradocs

Integrationen

KI-Assistenten mit Searchestra verbinden (MCP)

Searchestra hat einen entfernten Model Context Protocol-Server (MCP). Verbinden Sie ihn mit Claude oder einem anderen MCP-Client und fragen Sie in natürlicher Sprache nach Ihrer KI-Sichtbarkeit: Der Assistent liest Ihre Marken, Märkte, Prompt Universes, KI-Antworten, Zitate, Stimmung und Daten aus dem Action Center, mit genau dem Zugriff, den Sie in Searchestra haben.

Hinweis zur Sprache. Die Searchestra-App ist derzeit auf Englisch. Menüs und Schaltflächen werden hier deshalb mit ihrem englischen Namen genannt, ebenso die Menüs in Claude, die je nach Spracheinstellung anders heißen können.
MCPhttps://panel.searchestra.com/mcp
Zu Claude hinzufügen → Öffnet Claude mit bereits ausgefülltem Namen und URL. Sie prüfen beides, bevor etwas hinzugefügt wird.

Überblick

  • Transport: Streamable HTTP, unter einer URL für jede Organisation.
  • Anmeldung: OAuth 2.1 mit PKCE. Jede Person meldet sich mit ihrem eigenen Searchestra-Konto an und genehmigt die Verbindung; niemand teilt einen API-Schlüssel.
  • Zugriff: Der Assistent sieht nur die Marken, Märkte und Prompt Universes, die Sie sehen, und kann Daten nur dort ändern, wo Ihre Rolle es erlaubt.
  • Tools: 44 Tools: 37 lesen Daten und 7 ändern sie. Siehe die Tool-Referenz.

Bevor Sie beginnen

  • Ein Searchestra-Konto in einer Organisation, deren Tarif API access enthält. Tools für Zitate, Stimmung und das Action Center liefern nur dann Daten, wenn diese Module in Ihrem Tarif enthalten sind.
  • Verbindungen mit KI-Assistenten sind für Ihre Organisation erlaubt. Sie sind standardmäßig aktiv; ein Owner kann sie unter Settings > Security > AI assistants deaktivieren.
  • Mindestens ein Prompt Universe mit erhobenen Antworten, damit die Tools Daten zurückgeben können.
  • Beschränkt Ihre Organisation den Zugriff nach IP-Adresse, erlauben Sie den ausgehenden Adressbereich von Anthropic 160.79.104.0/21 für Claude im Web, auf dem Desktop und mobil. Claude Code verbindet sich von Ihrem eigenen Computer aus.

Claude verbinden

Searchestra funktioniert als benutzerdefinierter Konnektor in Claude im Web, in den Desktop- und Mobil-Apps sowie in Cowork. Am schnellsten geht es über den Link Zu Claude hinzufügen, der Namen und URL für Sie ausfüllt.

Pro- und Max-Tarife

  1. Öffnen Sie in Claude Customize > Connectors und wählen Sie Add custom connector.
  2. Geben Sie den Namen Searchestra und die URL https://panel.searchestra.com/mcp ein. Lassen Sie OAuth-Client-ID und Secret leer; Claude identifiziert sich automatisch.
  3. Wählen Sie Add, dann Connect. Melden Sie sich bei Searchestra an, falls Sie dazu aufgefordert werden.
  4. Prüfen Sie auf dem Searchestra-Bildschirm, dass der Zugriff an claude.ai geht, sehen Sie sich an, was der Assistent tun darf, und wählen Sie Allow access.

Team- und Enterprise-Tarife

  1. Ein Owner der Claude-Organisation öffnet Organization settings > Connectors, wählt Add, dann Custom (bei Nachfrage Web) und gibt denselben Namen und dieselbe URL ein.
  2. Jedes Mitglied findet Searchestra dann unter Customize > Connectors mit der Kennzeichnung Custom und wählt Connect, um sich mit dem eigenen Searchestra-Konto anzumelden.

Im Chat verwenden

Aktivieren Sie den Konnektor für eine Unterhaltung über + > Connectors und stellen Sie dann Ihre Frage. Claude fragt nach, bevor es ein Tool ausführt, das Daten ändert.

Claude Code

Fügen Sie den Server im Terminal hinzu und melden Sie sich dann in Claude Code an:

Terminal
claude mcp add --transport http searchestra https://panel.searchestra.com/mcp

Starten Sie Claude Code, führen Sie /mcp aus, wählen Sie searchestra und authentifizieren Sie sich. Ihr Browser öffnet den Genehmigungsbildschirm von Searchestra; der Zugriff geht zurück an localhost auf Ihrem Computer.

Andere MCP-Clients

Jeder MCP-Client, der Streamable HTTP und OAuth unterstützt, funktioniert mit derselben URL. Der Server veröffentlicht Standard-Discovery-Dokumente, sodass Clients den Anmeldeablauf selbst finden:

  • Metadaten der geschützten Ressource: https://panel.searchestra.com/.well-known/oauth-protected-resource/mcp
  • Metadaten des Autorisierungsservers: https://panel.searchestra.com/.well-known/oauth-authorization-server
  • Client-Registrierung: Client ID Metadata Documents oder Dynamic Client Registration. Öffentliche Clients mit PKCE (S256); https-Redirect-URIs oder für Desktop-Apps Loopback-Adressen auf beliebigem Port.
  • Scopes: mcp:read zum Lesen von Daten, mcp:write, um sie auch zu ändern.

Beispiel-Prompts

Fragen Sie in Ihren eigenen Worten. Der Assistent findet zuerst Ihre Marke, Ihren Markt und Ihr Prompt Universe und ruft dann die passenden Tools auf.

  1. „Fasse unsere KI-Sichtbarkeit, Zitate und Stimmung in unserem Hauptmarkt für die letzten 30 Tage zusammen und zeige, was sich verändert hat.“
    Nutzt die Discovery-Tools, dann die KPI-Zusammenfassung und die Berichte.
  2. „Bei welchen Prompts in unserem Prompt Universe fehlt unsere Marke, und welche Wettbewerber erscheinen stattdessen?“
    Nutzt die Markenlücken-Chancen und die Antworten zu diesen Prompts.
  3. „Welche Quellen werden in Antworten zitiert, in denen unsere Wettbewerber erscheinen und wir nicht? Gruppiere sie nach Domain und schlage vor, wo wir anfangen sollten.“
    Nutzt die Zitat-Chancen und die zitierten Domains.
  4. „Wie unterscheiden sich die KI-Plattformen darin, wie sie unsere Marke beschreiben? Zeige die Stimmung je Plattform und die wichtigsten Themen.“
    Nutzt die Stimmung je Plattform und die Stimmungsthemen.
  5. „Füge diese drei Prompts zu unserem Prompt Universe hinzu: ‚beste günstige Option für Einsteiger‘, ‚Alternativen zum Marktführer‘, ‚lohnt sich ein Upgrade dieses Jahr‘.“
    Ändert Daten, daher bittet Claude Sie zuerst, den Aufruf zu genehmigen.
Tipp. Haben Sie mehrere Marken oder Märkte, nennen Sie den gemeinten, zum Beispiel „in unserem Markt Deutschland“. Sonst fragt der Assistent nach oder listet sie zuerst auf.

Berechtigungen und Sicherheit

  • Ihre Rolle, nicht mehr: Jeder Aufruf wird gegen Ihre aktuelle Rolle geprüft, genauso wie die Searchestra-App sie prüft. Viewer können nur lesen. Prompts, Themen und Tags zu ändern, erfordert eine Rolle, die das Prompt Universe konfigurieren darf, etwa Editor oder Brand admin.
  • Lese- und Schreibzugriff: Der Genehmigungsbildschirm zeigt, ob der Assistent darum gebeten hat, Daten zu ändern. Tools, die Daten ändern, benötigen mcp:write.
  • Bestätigung für jede Änderung: Die sieben Tools, die Daten ändern, sind als destruktiv gekennzeichnet, daher fragt Claude Sie vor jedem Aufruf. Reine Lese-Tools können ohne Nachfrage laufen.
  • Pläne ändern nie Daten: execute_plan führt nur Lese-Tools aus. Ein Schritt, der Daten ändern würde, wird abgelehnt und muss einzeln aufgerufen werden.
  • Bei jeder Nutzung geprüft: Die Mitgliedschaft in Ihrer Organisation sowie die Richtlinien für Single Sign-on, Mehrfaktor-Authentifizierung und Netzwerk gelten bei jedem Aufruf des Assistenten an Searchestra, nicht nur beim Verbinden. Zugriffstoken gelten 30 Minuten und werden automatisch erneuert; eine Verbindung hält höchstens 90 Tage, danach verbinden Sie sich erneut.

Daten und Datenschutz

  • Searchestra erhält nur die Tool-Anfragen, die der Assistent sendet. Ihre Unterhaltung mit dem Assistenten erhält oder speichert Searchestra nicht.
  • Die Daten, die ein Tool zurückgibt, gehen an den Assistenten, den Sie verbunden haben, und werden dann nach den Bedingungen dieses Anbieters verarbeitet. Für Claude siehe die Datenschutzrichtlinie von Anthropic.
  • Searchestra hält zu jeder Verbindung fest, wer sie hergestellt hat, wann sie erstellt und wann sie zuletzt genutzt wurde, damit Owner sie prüfen und trennen können.
  • Übermitteln Sie keine besonderen Kategorien oder hochsensiblen personenbezogenen Daten, es sei denn, Ihre Organisation hat mit Searchestra eine ausdrücklich genehmigte Verarbeitungsvereinbarung.

Wie wir personenbezogene Daten verarbeiten, beschreibt die Datenschutzerklärung.

Tool-Referenz

Jedes Tool hat einen kurzen Titel, der in Ihrem Assistenten angezeigt wird, und einen Namen, der im Protokoll verwendet wird. Die Titel stellt der Server auf Englisch bereit. Die meisten Tools benötigen eine Markt- oder Prompt-Universe-ID, die die Discovery-Tools zurückgeben.

Discovery

ToolWas es tutBereich
List brands
list_brands
Listet die Marken der Organisation auf, auf die der Nutzer Zugriff hat. Über die Marken-IDs gelangt man zu den Markt- und Prompt-Universe-IDs, die die anderen Tools benötigen.Organisation
List markets
list_markets
Listet die Märkte (Land und Sprache) einer Marke oder aller Marken auf. Gibt die market_id zurück, die marktbezogene Tools benötigen.Organisation
List Prompt Universes
list_universes
Listet die Prompt Universes eines Marktes auf. Gibt die universe_id zurück, die die Tools für Prompts, Themen und Tags benötigen.Markt
List AI models
get_all_models
Listet die verfolgten KI-Modelle (Plattformen) auf.Organisation

Inhalte und Antworten eines Prompt Universe

ToolWas es tutBereich
List prompts
get_all_prompts
Listet die verfolgten Prompts eines Prompt Universe auf.Prompt Universe
List keywords
get_all_keywords
Listet den Text der verfolgten Prompts eines Prompt Universe auf.Prompt Universe
List topics
get_all_topics
Listet die Themen eines Prompt Universe auf.Prompt Universe
List tags
get_all_tags
Listet die Tags eines Prompt Universe auf.Prompt Universe
Prompt answers
get_prompt_answers
Gibt die für einen Prompt erhobenen KI-Antworten zurück.Prompt Universe
Prompt result details
get_prompt_result_details
Gibt detaillierte KI-Antworten für einen Prompt zurück, optional für eine KI-Plattform.Prompt Universe
List AI answers
get_all_ai_answers
Listet alle in einem Prompt Universe erhobenen KI-Antworten auf.Prompt Universe

Leistung und KPIs

ToolWas es tutBereich
KPI summary
get_kpi_summary
Fasst die wichtigsten Markt-KPIs (Sichtbarkeit, Zitate, Stimmung) in einem Aufruf zusammen.Markt
Performance report
query_performance_report
Gibt die Leistung bei Sichtbarkeit und Zitaten für einen Markt oder ein Prompt Universe zurück, berechnet aus den erhobenen KI-Antworten.Markt

Zitate und Quellen

ToolWas es tutBereich
Citation report
query_citation_report
Gibt die Zusammenfassung der Zitate zurück: alle Zitate, den Anteil der Marke und eindeutige Domains.Markt
List citations
get_all_citations
Listet die Zitate in KI-Antworten für einen Markt auf.Markt
Market citations
get_prompt_citations
Gibt die Zitate in KI-Antworten für einen Markt zurück.Markt
List cited domains
get_all_domains
Listet die zitierten Domains und ihren Anteil an den Zitaten auf.Markt
Cited pages of a domain
get_domain_pages_cited
Listet die Seiten einer Domain auf, die in KI-Antworten zitiert werden.Markt
Platforms citing a domain
get_domain_citation_platforms
Gibt zurück, welche KI-Plattformen eine Domain zitieren.Markt
Your most cited pages
get_industry_cited_pages
Listet die eigenen Seiten der Marke auf, die in KI-Antworten im Markt zitiert werden, mit Anzahl der Zitate, zitierenden Plattformen und GEO-Score.Markt
Citation opportunities
get_citation_opportunities
Listet Quellen auf, die in Antworten zitiert werden, in denen Wettbewerber erscheinen und die Marke nicht, mit relativer Zitatstärke (kein Domain-Authority-Wert).Markt
External mentions
get_external_mentions
Listet Erwähnungen der Marke in Quellen Dritter und sozialen Medien auf.Markt

Stimmung

ToolWas es tutBereich
Sentiment report
query_sentiment_report
Gibt den Stimmungsbericht zurück: Wert und Verteilung.Markt
Sentiment by platform
get_sentiment_by_platform
Schlüsselt den Stimmungswert nach KI-Plattform auf.Markt
Sentiment by competitor
get_sentiment_by_competitor
Schlüsselt den Stimmungswert nach Wettbewerber auf.Markt
Sentiment themes
get_sentiment_themes
Listet die Stimmungsthemen auf, also die Themen, die bestimmen, wie die Marke wahrgenommen wird.Markt
Sentiment theme keywords
get_sentiment_keywords
Listet die Keywords unter einem Stimmungsthema auf.Markt
AI narrative
get_brand_narrative
Zeigt, wie überwachte KI-Antworten die Marke oder einen beobachteten Wettbewerber in einem Scan beschreiben: Behauptungscluster je Plattform, Konsens, Rolle mit ihrer Regel, Zusammenfassungssätze, Veränderung seit dem letzten Scan und die Lücke zum freigegebenen Zielset. Zahlen werden nie plattformübergreifend zusammengelegt. In der Beta-Phase.Prompt Universe

Action Center und Prompt Explorer

ToolWas es tutBereich
Action Center summary
get_actionables_dashboard
Gibt die Zusammenfassung des Action Center für einen Markt zurück: alle Maßnahmen, offene Maßnahmen und möglicher Sichtbarkeitsgewinn.Markt
Brand gap opportunities
get_all_brand_gap_opportunities
Listet Prompts auf, bei denen die Marke in KI-Antworten nicht erscheint, als Chancen für neue Inhalte.Markt
New content opportunities
get_all_new_content_opportunities
Listet empfohlene Chancen für neue Inhalte auf.Markt
Optimization opportunities
get_all_optimization_opportunities
Listet Verbesserungsmöglichkeiten für bestehende Seiten auf.Markt
Broken pages
get_all_broken_pages
Listet Seiten auf, die KI-Crawlern Fehler zurückgegeben haben.Markt
Action details
get_action_info
Gibt die Details einer Maßnahme zurück, einschließlich Beispielantworten und zugehöriger Erwähnungen.Markt
Prompt Explorer overview
get_prompt_explorer_overview
Gibt Prompts aus dem Prompt Explorer mit Suchvolumen, Schwierigkeit und Absicht zurück.Markt

Planung

ToolWas es tutBereich
Plan tools for a question
tools_info
Macht aus einer Frage in natürlicher Sprache eine vorgeschlagene Liste von Searchestra-Tools mit der Begründung für den Plan. Es führt selbst keine Tools aus.Keiner
Run a read-only tool plan
execute_plan
Führt eine Liste von reinen Lese-Tools von Searchestra der Reihe nach aus und gibt alle Ergebnisse in einer Antwort zurück. market_id und universe_id werden an jeden Schritt übergeben. Schritte, die Daten ändern würden, werden abgelehnt.Keiner

Tools, die Daten ändern

ToolWas es tutBereich
Create prompt
create_prompt
Fügt einem Prompt Universe einen neuen verfolgten Prompt hinzu.Prompt Universe
Delete prompts
bulk_delete_prompts
Löscht mehrere Prompts in einem Aufruf.Prompt Universe
Create topic
create_topic
Fügt einem Prompt Universe ein neues Thema hinzu.Prompt Universe
Archive topic
delete_topic
Archiviert ein Thema in einem Prompt Universe.Prompt Universe
Create tag
create_tag
Fügt einem Prompt Universe einen neuen Tag hinzu.Prompt Universe
Delete tag
delete_tag
Löscht einen Tag aus einem Prompt Universe.Prompt Universe
Generate optimization fix plan
get_optimization_fixes
Erzeugt schrittweise Korrekturvorschläge für eine Maßnahme und speichert sie bei der Maßnahme; zuvor gespeicherte Vorschläge werden ersetzt.Markt

Listen-Tools geben standardmäßig bis zu 25 Einträge pro Seite zurück. Zeiträume verwenden start_date und end_date im Format YYYY-MM-DD.

Verbindungen verwalten

  • Ihre Verbindungen: Öffnen Sie in Searchestra Settings > Profile. Connected AI assistants listet jeden Assistenten auf, den Sie verbunden haben, wann er zuletzt genutzt wurde, und eine Schaltfläche Disconnect.
  • Ihre Organisation: Owner öffnen Settings > Security > AI assistants, um jede Verbindung zu sehen, beliebige davon zu trennen oder Verbindungen mit KI-Assistenten für alle zu deaktivieren. Das Deaktivieren trennt sofort alle Assistenten.
  • In Claude: Entfernen oder verbinden Sie den Konnektor erneut unter Customize > Connectors und setzen Sie einzelne Tools auf Blocked, wenn Claude sie nie verwenden soll.

Fehlerbehebung

„Your organization's plan does not include …“

Die Verbindung erfordert API-Zugriff, und manche Tools benötigen die Module für Zitate, Stimmung oder das Action Center. Kontaktieren Sie uns, um sie Ihrem Tarif hinzuzufügen.

Der Genehmigungsbildschirm meldet, dass Verbindungen deaktiviert sind

Ein Owner hat Verbindungen mit KI-Assistenten deaktiviert. Bitten Sie ihn, Allow members to connect AI assistants unter Settings > Security > AI assistants zu aktivieren.

Aufrufe schlagen nach einer Weile fehl, oder Claude zeigt Reconnect

Die Verbindung ist nach 90 Tagen abgelaufen, wurde getrennt, oder Ihre Anmelderichtlinie hat sich geändert, etwa durch eine neue Pflicht zur Mehrfaktor-Authentifizierung. Wählen Sie Reconnect und genehmigen Sie erneut.

Der Zugriff wird aus Claude verweigert, funktioniert aber in Searchestra

Ihre Organisation beschränkt den Zugriff wahrscheinlich nach IP-Adresse. Erlauben Sie 160.79.104.0/21, den ausgehenden Adressbereich von Anthropic.

Ein Tool gibt keine Daten zurück

Das Prompt Universe hat für den Zeitraum möglicherweise noch keine erhobenen Antworten, oder Sie haben keinen Zugriff auf diese Marke. Führen Sie in Searchestra einen Scan aus oder bitten Sie den Assistenten, die Marken und Märkte aufzulisten, die Sie sehen.

Kommen Sie nicht weiter? Schreiben Sie an team@searchestra.com. Sicherheitsprobleme melden Sie an security@searchestra.com.