Agents

Warum über StarReview verbinden

Ein Agent kann selbst eine Antwort schreiben. Was er nicht selbst kann: sie im Namen des Geschäfts veröffentlichen lassen. Wer auf eine Google-Bewertung antwortet, braucht freigegebenen Zugang zum Google Unternehmensprofil, und den hält StarReview; TripAdvisor hat überhaupt keine Antwort-API, deshalb postet der Inhaber die freigegebene Antwort über einen Link, den StarReview bereitstellt. Über StarReview verbunden erhält Ihr Agent:

• Veröffentlichung im Google Unternehmensprofil über StarReviews eigene Infrastruktur, im Namen des Geschäfts
• Für TripAdvisor (das keine Antwort-API hat) 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
• Menschliche Freigabe bei sensiblen und negativen Bewertungen, immer
• Eine Sentiment-Prüfung für jeden Entwurf, damit nichts hinausgeht, was nicht hinausgehen sollte
• Ein vollständiges Protokoll jeder Aktion des Agenten

Endpunkt

https://mcp.starreview.ch/

Streamable HTTP MCP. Verbinden Sie sich per OAuth (empfohlen, siehe unten) oder authentifizieren Sie sich mit einem Bearer-Token pro Geschäft 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 in der Datenschutzerklärung des Connectors.

Tools

• list_locations: die mit diesem Token verbundenen Standorte
• list_unanswered_reviews: Google- und TripAdvisor-Bewertungen, die noch auf eine Antwort warten, jeweils mit ihrer Plattform gekennzeichnet
• 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 der StarReview-Varianten in die Freigabe-Warteschlange des Inhabers legen, optional mit angepasstem Text und bevorzugter Veröffentlichungszeit. Bei einer TripAdvisor-Bewertung kommt eine freigegebene Antwort mit einem Link zurück, über den der Inhaber postet
• 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. Die Antwort landet in der Freigabe-Warteschlange des Inhabers. Negative Bewertungen warten immer auf einen Menschen.
4. Nach der Freigabe veröffentlicht StarReview eine Google-Antwort über die eigene Infrastruktur (auf Wunsch zur bevorzugten Zeit); bei TripAdvisor gibt es einen Link zurück, über den der Inhaber die Antwort 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.

Aus Ihrem Code verbinden

Für den programmatischen Zugriff oder einen Client ohne OAuth nutzen Sie stattdessen ein Bearer-Token pro Geschäft. StarReview ist ein Standard-MCP-Server (Streamable HTTP). Über die Claude-API fügen Sie ihn unter mcp_servers hinzu und übergeben das Geschäfts-Token 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. Ein Mensch gibt frei, dann geht es live. Die Antwort liegt in der Freigabe-Warteschlange des Inhabers. Nach der Freigabe veröffentlicht StarReview eine Google-Antwort über die eigene Infrastruktur, auf Wunsch zur Zeit aus preferredPostAt. Bei einer TripAdvisor-Bewertung gibt die Einreich-Antwort stattdessen awaitingManualPost: true und eine platformListingUrl zurück; StarReview kann nicht auf TripAdvisor posten, deshalb öffnet der Inhaber diesen Link und postet die freigegebene Antwort. Negative Bewertungen warten immer auf einen Menschen.

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 kein Token: Sie melden sich mit Ihrem StarReview-Konto an und geben frei. Bearer-Token pro Geschäft sind die Alternative für den programmatischen Zugriff, ausgestellt vom StarReview-Kontoinhaber. Wenn Sie als Agentur oder Agent-Produkt Kundengeschäfte verbinden möchten, schreiben Sie uns, und wir richten Sie ein.

FAQ