Agents

Warum über StarReview verbinden

Ein Agent kann selbst eine Antwort schreiben, aber nie direkt im Namen des Geschäfts posten. Den Zugang zum Google Unternehmensprofil hält StarReview und wendet dabei Ihre bestehenden Freigabe- und Auto-Veröffentlichungs-Einstellungen an. TripAdvisor, Booking.com, Expedia und HolidayCheck haben keine Antwort-API, deshalb postet der Inhaber dort selbst über einen bereitgestellten Link. Über StarReview verbunden erhält Ihr Agent:

• Veröffentlichung im Google Unternehmensprofil über StarReviews eigene Infrastruktur, im Namen des Geschäfts
• Für TripAdvisor, Booking.com, Expedia und HolidayCheck (die keine Antwort-API haben) eine sendefertige Antwort samt direktem Link, über den der Inhaber postet
• Die eigene Stimme des Geschäfts, gelernt aus früheren Antworten und Anpassungen des Inhabers
• Agententexte, bearbeitete und durch Sicherheitsprüfungen zurückgehaltene Antworten bleiben immer zur Freigabe ausstehend
• Eine Sentiment-Prüfung für jeden Entwurf, damit nichts hinausgeht, was nicht hinausgehen sollte
• Ein vollständiges Protokoll jeder Aktion des Agenten

Anleitungen für Ihren Agenten

Schritt-für-Schritt-Anleitungen pro Agent, vom Verbinden bis zur ersten Freigabe:

Lieber die Kommandozeile? Die StarReview CLI (@starreview/cli) liefert JSON auf stdout und ist für Agenten und Skripte gebaut.

Ohne Konto ausprobieren

Drei Tools brauchen überhaupt keine Zugangsdaten. Richten Sie einen beliebigen MCP-Client ohne Authorization-Header auf den Endpunkt, und Sie erhalten:

• get_service_info: was StarReview macht, was es kostet und wie man sich authentifiziert
• search_business: ein Geschäft auf Google Maps über Name und Ort finden
• check_response_rate: welcher Anteil der letzten Google-Bewertungen eines Geschäfts eine Inhaberantwort erhalten hat, verglichen mit zwei Mitbewerbern in der Nähe

Nur lesend und pro IP begrenzt. Nach der Authentifizierung erhalten Sie stattdessen die sieben Geschäfts-Tools; die beiden Sets sind getrennt, ein authentifizierter Client sieht diese also nicht mehr.

Endpunkt

https://mcp.starreview.ch/

Streamable HTTP MCP. Verbinden Sie sich per OAuth (empfohlen, siehe unten) oder authentifizieren Sie sich mit einem kontoweiten Inhaber-Schlüssel im Authorization: Bearer-Header. Senden Sie bei jeder Anfrage Accept: application/json, text/event-stream. Derselbe Server ist auch unter https://api.starreview.ch/api/agent/mcp erreichbar. Wie Agentendaten behandelt werden, steht im aktuellen Datenschutzhinweis für Agenten und MCP.

Die OAuth-Discovery folgt RFC 9728: Rufen Sie https://mcp.starreview.ch/.well-known/oauth-protected-resource ab, um den Autorisierungsserver zu finden, registrieren Sie sich dynamisch und führen Sie den Authorization-Code-Flow mit PKCE aus. Eine Anfrage ohne Zugangsdaten antwortet mit 401 und einem WWW-Authenticate-Header, der auf dasselbe Dokument zeigt, damit ein spezifikationstreuer Client selbst hineinfindet.

Tools

• list_locations: die Standorte des Geschäfts, für das Sie handeln
• list_unanswered_reviews: Google-, TripAdvisor-, Booking.com-, Expedia- und HolidayCheck-Bewertungen, die noch auf eine Antwort warten, jeweils mit ihrer Plattform gekennzeichnet
• get_review_stats: Bewertungs-Kennzahlen, nur lesend: Durchschnitt, Antwortquote, Rückstand und Aufschlüsselung pro Plattform
• get_review_context: die vollständige Bewertung samt vorhandener Entwürfe
• draft_reply: eine Antwort in der Stimme des Geschäfts erstellen
• submit_reply_for_approval: eine StarReview-Variante zur Prüfung durch die Freigabe- und Auto-Veröffentlichungsregeln einreichen, optional mit angepasstem Text und bevorzugter Veröffentlichungszeit. Angepasste Texte bleiben ausstehend; auf Plattformen ohne Antwort-API kommt ein Link für das manuelle Posten zurück
• submit_own_reply: den eigenen Antworttext des Agenten in die Freigabe-Warteschlange legen, ohne StarReview-Entwurf; immer mit menschlicher Freigabe, nie automatisch terminiert

Der Ablauf

1. Ihr Agent listet unbeantwortete Bewertungen auf und liest deren Kontext.
2. Er reicht eine Antwort ein, mit StarReviews Entwurf oder eigenem Text, optional mit bevorzugter Veröffentlichungszeit.
3. StarReview prüft die Antwort anhand Ihrer Einwilligung, Einstellungen und Sicherheitsregeln. Agententexte, Änderungen und durch Sicherheitsprüfungen zurückgehaltene Antworten bleiben zur Freigabe ausstehend.
4. Ein geeigneter, unveränderter StarReview-Entwurf kann automatisch terminiert werden. Auf Plattformen ohne Antwort-API gibt es einen Link zurück, über den der Inhaber selbst postet.

Per OAuth verbinden (empfohlen)

Fügen Sie StarReview in Claude oder einem anderen MCP-Client mit OAuth-Unterstützung als Connector hinzu und melden Sie sich mit Ihrem StarReview-Konto an. Sie geben einmal auf einem Zustimmungsbildschirm frei, danach kann der Agent Antworten für Ihre eigenen Geschäfte entwerfen und einreichen. Es gibt kein Token zu kopieren oder zu verwalten, und Sie können die Verbindung jederzeit in Ihren StarReview-Einstellungen trennen. Die Verbindung ist auf Ihre eigenen Geschäfte beschränkt: Ein Agent kann nie ein Geschäft berühren, das Ihnen nicht gehört, und er postet weiterhin nie selbst eine Antwort.

Wenn Ihnen mehrere Geschäfte gehören, identifiziert eine OAuth-Verbindung Sie und nicht ein einzelnes Geschäft, der Agent muss also sagen, welches gemeint ist. Rufen Sie ein Tool ohne businessId auf, erhalten Sie eine Auswahl zurück, statt dass die Arbeit erledigt wird:

{
  "businesses": [
    { "businessId": "...", "name": "Restaurant Adler" },
    { "businessId": "...", "name": "Cafe Baur" }
  ],
  "hint": "You manage multiple businesses. Call again with businessId set to one of these."
}

Das ist ein erfolgreiches Ergebnis, kein Fehler, prüfen Sie also darauf, bevor Sie eine Antwort als Resultat behandeln. Rufen Sie erneut mit gesetzter businessId auf. Tools mit einer reviewId geben nie eine Auswahl zurück: Die Bewertung bestimmt das Geschäft bereits. Kontoweite Inhaber-Schlüssel folgen denselben Auswahlregeln wie OAuth. Nur ausdrücklich geschäftsgebundene Alt- oder Admin-Zugangsdaten legen ein Geschäft fest und benötigen keine Auswahl.

Aus Ihrem Code verbinden

Für den programmatischen Zugriff oder einen Client ohne OAuth nutzen Sie stattdessen einen kontoweiten Inhaber-Schlüssel. StarReview ist ein Standard-MCP-Server (Streamable HTTP). Über die Claude-API fügen Sie ihn unter mcp_servers hinzu und übergeben den Inhaber-Schlüssel als authorization_token:

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Entwerfen Sie Antworten auf meine unbeantworteten Bewertungen." }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://mcp.starreview.ch/",
      "name": "starreview",
      "authorization_token": "sragt_your_business_token"
    }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "starreview" }
  ]
}

Der MCP-Connector ist in der Beta, senden Sie deshalb den aktuellen Beta-Header des MCP-Connectors mit (siehe Anthropics MCP-Connector-Dokumentation). Andere MCP-Clients verbinden sich gleich: Endpunkt eintragen und den Authorization: Bearer-Header setzen.

Beispiel-Durchlauf

Ein typischer Ablauf. Jeder Tool-Aufruf liefert JSON; die Formen unten sind repräsentativ.

1. Auflisten, was eine Antwort braucht. Aufruf von list_unanswered_reviews:

[
  {
    "reviewId": "a1b2c3d4-...",
    "starRating": 5,
    "text": "Super Service, sehr freundlich!",
    "reviewerName": "M. Keller",
    "reviewDate": "2026-07-01",
    "sentiment": "positive",
    "provider": "google",
    "hasDraft": false
  }
]

2a. StarReview entwerfen lassen, in der Stimme des Geschäfts. Aufruf von draft_reply mit der reviewId:

{
  "variants": [
    { "variant": 1, "text": "Vielen Dank fuer die netten Worte, Herr Keller ...", "riskFlags": [] }
  ],
  "language": "de",
  "sentiment": { "bucket": "positive", "confidence": 0.95 },
  "approvalReason": "agent_draft",
  "wouldAutoPublish": true
}

Danach eine Variante mit submit_reply_for_approval einreichen ({ "reviewId": "...", "variant": 1 }), optional mit angepasstem Text.

2b. Oder eigenen Text mitbringen. Das Entwerfen überspringen und submit_own_reply aufrufen:

// request
{ "reviewId": "a1b2c3d4-...", "finalText": "Danke vielmals, Herr Keller!" }

// response
{ "submitted": true, "autoScheduled": false }

autoScheduled ist bei eigenem Text immer false: er wartet immer auf einen Menschen.

3. StarReview wendet Ihre Regeln an. Agententexte, angepasste Entwürfe und durch Sicherheitsprüfungen zurückgehaltene Antworten bleiben in der Freigabe-Warteschlange. Ein geeigneter, unveränderter StarReview-Entwurf kann gemäss Ihrer bestehenden Einwilligung und den Auto-Veröffentlichungs-Einstellungen terminiert werden. Auf Plattformen ohne Antwort-API gibt die Antwort awaitingManualPost: true und eine platformListingUrl zurück; der Inhaber postet dort selbst.

Pläne

Hat ein Geschäft bereits einen StarReview-Plan, arbeitet sein Agent innerhalb dieses Plans. Betreiben Sie eine Agentur mit vielen Kundengeschäften oder bauen Sie ein Produkt auf StarReview auf, melden Sie sich, und wir richten den passenden Plan für Ihr Volumen ein.

Token erhalten

Beim Verbinden per OAuth brauchen Sie keinen Schlüssel: Sie melden sich mit Ihrem StarReview-Konto an und geben frei. Kontoweite Inhaber-Schlüssel sind die selbst verwaltete Alternative für den programmatischen Zugriff und gelten für die Geschäfte dieses Kontos. Alt- oder Admin-Zugangsdaten können ausdrücklich auf ein Geschäft beschränkt sein. Wenn Sie als Agentur oder Agent-Produkt Kundengeschäfte verbinden möchten, schreiben Sie uns, und wir richten Sie ein.

FAQ