Deutsch Čeština English (United States) Español (España) Français (France) Italiano 日本語

Weitere anzeigen

Scout API & MCP – Übersicht und Einrichtung

Für wen ist dieser Artikel relevant?

  • Unternehmens-, Partner- und Kleinunternehmens-Konten.
  • Konten in allen Regionen.

Übersicht

Scout bietet Ihnen neben der Benutzeroberfläche über zwei sich ergänzende Bereitstellungsmodelle Zugriff auf Transparenzinformationen: eine API und ein MCP.

Die Scout-API stellt strukturierte HTTP-Endpunkte bereit, die Sichtbarkeitsdaten von Scout zurückgeben. Nutzen Sie diese, wenn Sie Scout-Daten direkt in Ihr eigenes Produkt einbinden möchten: zur Erstellung benutzerdefinierter Dashboards, zur Automatisierung von Exporten in ein Data Warehouse oder ein CRM, zur Erstellung von White-Label-Berichten oder zum Auslösen von Empfehlungsworkflows auf der Grundlage von Sichtbarkeitssignalen.

Das Scout MCP entlastet Sie bei der Entwicklung und ermöglicht es Ihnen, Scout-Daten mit Claude oder OpenAI zu verknüpfen und Fragen in natürlicher Sprache zu stellen. Nutzen Sie es, wenn Sie eine schnelle Erkundung, Zusammenfassungen auf Abruf oder die Erstellung benutzerdefinierter Übersichten ohne Programmieraufwand anstreben. Das MCP ist für OpenAI, Claude, Perplexity, Gemini und Copilot verfügbar. 

Sowohl die Scout-API als auch MCP sind für Scout-Daten schreibgeschützt. Keine von beiden unterstützt das Auslösen von Scans, das Aktualisieren von Stichwörtern oder andere Schreibaktionen in Scout. Für Schreibfunktionen verwenden Sie das umfassendere Yext MCP (zu der die Scout MCP gehört) oder die Yext Management API, die beide Aktionen wie das Aktualisieren von Einträgen, das Reagieren auf Bewertungen und die Verwaltung anderer Yext-Funktionen unterstützen.

Haftungsausschluss: Vor der Weitergabe prüfen

Das Scout MCP stützt sich auf reale Daten. Allerdings können KI-Modelle Inhalte erstellen, die zwar überzeugend klingen, aber nicht genau sind. Bevor Sie etwas an Stakeholder*innen weitergeben, sollten Sie dieselben Maßstäbe wie bei jeder anderen Analyse ansetzen, die Ihren Namen trägt.

Überprüfen Sie jede Zahl, jedes Datum und jede benannte Entität anhand der Scout API oder der Benutzeroberfläche und seien sich über die Grenzen der Scout-Abdeckung im Klaren. Abfragen, die über die unterstützten Metriken hinausgehen, können verfälschte Antworten liefern. Abgesehen von den Zahlen sollten Sie auch überprüfen, ob der Bericht tatsächlich auf den Kunden passt. Häufige Fehler sind nicht immer offensichtlich: vertauschte Zahlen, der falsche Wettbewerber, eine veraltete Kennzahl, ein erfundenes Zitat.

Nichts, was von MCP erstellt wird, sollte einen Kunden ohne ein zweites Paar Augen erreichen. Die präsentierende Person ist für die Genauigkeit verantwortlich, nicht das Modell.

Wie API und MCP zusammenarbeiten 

Das Scout MCP und die API greifen auf dieselben zugrunde liegenden Daten zurück. Der Unterschied liegt in der Art des Zugriffs.

Die Scout-API bietet Ihnen einen strukturierten, programmatischen Zugriff, sodass Sie kontrollieren können, wie die Daten dargestellt und mit Ihrer Produktlogik verbunden werden. Das Scout MCP ermöglicht Ihnen den Zugriff in natürlicher Sprache über ein LLM, ohne dass ein Build erforderlich ist.

In der Praxis nutzen viele Partner und Kunden beides: MCP für die schnelle Erkundung und Erstellung benutzerdefinierter Benutzeroberflächen, API für skalierbare, eingebettete Produkte.

So erhalten Sie Zugriff

Die Vorgehensweise hängt von dem von Ihnen verwendeten Modell ab. Springen Sie zu dem entsprechenden Abschnitt unten, um die Schritte für die Verbindung mit dem jeweiligen Anbieter zu erfahren.

Sie können direkt von Ihrem Konto aus auf die Scout API-Dokumente zugreifen, indem Sie oben rechts auf einer beliebigen Scout-Seite auf das Einstellungssymbol und dann auf API-Referenz anzeigen klicken. 

Sie können die API-Dokumentation auch direkt über die folgenden Links aufrufen:

Hinweis: Sie müssen in Ihrem Konto angemeldet sein, um auf diese Dokumente zugreifen zu können.

 

Claude

Was Sie benötigen: 

So stellen Sie eine Verbindung zum Yext MCP her

  1. Suchen Sie in Claude die Option Benutzerdefinierten Connector hinzufügen und klicken Sie darauf. Diese Option finden Sie normalerweise im Menü „Einstellungen“ und dort im Abschnitt „Connectors“.
  2. Geben Sie einen Namen und die URL des Remote-MCP-Servers ein.
  1. Klicken Sie auf Hinzufügen.
  2. Nachdem Sie die URL hinzugefügt haben, klicken Sie auf Verbinden. Claude wird Sie auffordern, sich bei Yext anzumelden.
  3. Melden Sie sich mit Ihren Zugangsdaten bei Ihrem Yext-Konto an. 
  4. Sie werden aufgefordert, die Verbindung mit Lese-/Schreibzugriff auf dem Scout MCP zu autorisieren. Klicken Sie auf Autorisieren.
  5. Sie werden nach der Autorisierung wieder zu Claude weitergeleitet, wonach die Verbindung aktiv ist.
  6. Klicken Sie auf den benutzerdefinierten Yext MCP Connector in der Seitenleiste, um die vollständige Liste der verfügbaren Scout MCP Tools anzuzeigen.

Alles ist bereit! Sie können diese Tools jetzt direkt in Ihren Claude-Unterhaltungen verwenden, um auf Ihre Yext-Daten zuzugreifen.

OpenAI

Was Sie benötigen: 

  • Anmeldedaten für Ihr Yext-Konto 
  • Zugriff auf OpenAI mit ausreichenden Berechtigungen, um eine benutzerdefinierte App hinzuzufügen

Scout MCP mit OpenAI verbinden

  1. Navigieren Sie in ChatGPT zur Seite „Einstellungen“ und klicken Sie auf Apps.
  2. Klicken Sie auf Erweiterte Einstellungen.

  1. Klicken Sie, um den Entwicklermodus zu aktivieren. Dann klicken Sie auf App erstellen.

  1. Geben Sie die Details für die App ein.
  • Name: Wir empfehlen, Yext MCP als Name des Connectors hinzuzufügen.
  • Verbindung: Stellen Sie sicher, dass die Server-URL ausgewählt ist (dies ist die Standardeinstellung), und geben Sie https://api.yext.com/mcp für Konten aus der US-Quellregion oder https://api.eu.yextapis.com/mcp für Konten aus der EU-Quellregion ein.
  • Authentifizierung: Wählen Sie OAuth.
  1. Aktivieren Sie das Kontrollkästchen, um die Verbindung zu einem benutzerdefinierten MCP-Server zu bestätigen. 
  2. Klicken Sie auf Erstellen.

  1. Sie werden aufgefordert, sich bei Yext anzumelden, um die Verbindung zum Scout MCP zu autorisieren. Klicken Sie auf Anmelden. Dann klicken Sie auf Autorisieren, nachdem Sie sich in Ihrem Yext-Konto eingeloggt haben. Sobald Sie die Verbindung erfolgreich autorisiert haben, werden Sie zurück zu Ihrer App-Liste weitergeleitet.

Alles ist bereit! Sie können diese Tools jetzt direkt in Ihren ChatGPT-Unterhaltungen verwenden, um auf Ihre Yext-Daten zuzugreifen.

 

CoPilot

Offizielle Anleitungen folgen in Kürze. In der Zwischenzeit können Sie den Hilfeartikel Verbinden Des Agents mit einem vorhandenen MCP-Server (Model Context Protocol) auf der Microsoft Copilot-Hilfeseite aufrufen und die OAuth-URL https://api.yext.com/mcp für Konten mit Ursprungsregion in den USA bzw. https://api.eu.yextapis.com/mcp für Konten mit Ursprungsregion in der EU verwenden, um zu beginnen.