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.
Ü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/21fü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
- Öffnen Sie in Claude Customize > Connectors und wählen Sie Add custom connector.
- Geben Sie den Namen
Searchestraund die URLhttps://panel.searchestra.com/mcpein. Lassen Sie OAuth-Client-ID und Secret leer; Claude identifiziert sich automatisch. - Wählen Sie Add, dann Connect. Melden Sie sich bei Searchestra an, falls Sie dazu aufgefordert werden.
- 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
- 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.
- 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:
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:readzum 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.
- „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. - „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. - „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. - „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. - „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.
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_planfü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
| Tool | Was es tut | Bereich |
|---|---|---|
List brandslist_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 marketslist_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 Universeslist_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 modelsget_all_models | Listet die verfolgten KI-Modelle (Plattformen) auf. | Organisation |
Inhalte und Antworten eines Prompt Universe
| Tool | Was es tut | Bereich |
|---|---|---|
List promptsget_all_prompts | Listet die verfolgten Prompts eines Prompt Universe auf. | Prompt Universe |
List keywordsget_all_keywords | Listet den Text der verfolgten Prompts eines Prompt Universe auf. | Prompt Universe |
List topicsget_all_topics | Listet die Themen eines Prompt Universe auf. | Prompt Universe |
List tagsget_all_tags | Listet die Tags eines Prompt Universe auf. | Prompt Universe |
Prompt answersget_prompt_answers | Gibt die für einen Prompt erhobenen KI-Antworten zurück. | Prompt Universe |
Prompt result detailsget_prompt_result_details | Gibt detaillierte KI-Antworten für einen Prompt zurück, optional für eine KI-Plattform. | Prompt Universe |
List AI answersget_all_ai_answers | Listet alle in einem Prompt Universe erhobenen KI-Antworten auf. | Prompt Universe |
Leistung und KPIs
| Tool | Was es tut | Bereich |
|---|---|---|
KPI summaryget_kpi_summary | Fasst die wichtigsten Markt-KPIs (Sichtbarkeit, Zitate, Stimmung) in einem Aufruf zusammen. | Markt |
Performance reportquery_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
| Tool | Was es tut | Bereich |
|---|---|---|
Citation reportquery_citation_report | Gibt die Zusammenfassung der Zitate zurück: alle Zitate, den Anteil der Marke und eindeutige Domains. | Markt |
List citationsget_all_citations | Listet die Zitate in KI-Antworten für einen Markt auf. | Markt |
Market citationsget_prompt_citations | Gibt die Zitate in KI-Antworten für einen Markt zurück. | Markt |
List cited domainsget_all_domains | Listet die zitierten Domains und ihren Anteil an den Zitaten auf. | Markt |
Cited pages of a domainget_domain_pages_cited | Listet die Seiten einer Domain auf, die in KI-Antworten zitiert werden. | Markt |
Platforms citing a domainget_domain_citation_platforms | Gibt zurück, welche KI-Plattformen eine Domain zitieren. | Markt |
Your most cited pagesget_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 opportunitiesget_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 mentionsget_external_mentions | Listet Erwähnungen der Marke in Quellen Dritter und sozialen Medien auf. | Markt |
Stimmung
| Tool | Was es tut | Bereich |
|---|---|---|
Sentiment reportquery_sentiment_report | Gibt den Stimmungsbericht zurück: Wert und Verteilung. | Markt |
Sentiment by platformget_sentiment_by_platform | Schlüsselt den Stimmungswert nach KI-Plattform auf. | Markt |
Sentiment by competitorget_sentiment_by_competitor | Schlüsselt den Stimmungswert nach Wettbewerber auf. | Markt |
Sentiment themesget_sentiment_themes | Listet die Stimmungsthemen auf, also die Themen, die bestimmen, wie die Marke wahrgenommen wird. | Markt |
Sentiment theme keywordsget_sentiment_keywords | Listet die Keywords unter einem Stimmungsthema auf. | Markt |
AI narrativeget_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
| Tool | Was es tut | Bereich |
|---|---|---|
Action Center summaryget_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 opportunitiesget_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 opportunitiesget_all_new_content_opportunities | Listet empfohlene Chancen für neue Inhalte auf. | Markt |
Optimization opportunitiesget_all_optimization_opportunities | Listet Verbesserungsmöglichkeiten für bestehende Seiten auf. | Markt |
Broken pagesget_all_broken_pages | Listet Seiten auf, die KI-Crawlern Fehler zurückgegeben haben. | Markt |
Action detailsget_action_info | Gibt die Details einer Maßnahme zurück, einschließlich Beispielantworten und zugehöriger Erwähnungen. | Markt |
Prompt Explorer overviewget_prompt_explorer_overview | Gibt Prompts aus dem Prompt Explorer mit Suchvolumen, Schwierigkeit und Absicht zurück. | Markt |
Planung
| Tool | Was es tut | Bereich |
|---|---|---|
Plan tools for a questiontools_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 planexecute_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
| Tool | Was es tut | Bereich |
|---|---|---|
Create promptcreate_prompt | Fügt einem Prompt Universe einen neuen verfolgten Prompt hinzu. | Prompt Universe |
Delete promptsbulk_delete_prompts | Löscht mehrere Prompts in einem Aufruf. | Prompt Universe |
Create topiccreate_topic | Fügt einem Prompt Universe ein neues Thema hinzu. | Prompt Universe |
Archive topicdelete_topic | Archiviert ein Thema in einem Prompt Universe. | Prompt Universe |
Create tagcreate_tag | Fügt einem Prompt Universe einen neuen Tag hinzu. | Prompt Universe |
Delete tagdelete_tag | Löscht einen Tag aus einem Prompt Universe. | Prompt Universe |
Generate optimization fix planget_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.
