Agents

Perché collegarsi tramite StarReview

Un agente può scrivere una risposta da solo. Quello che non può fare da solo: farla pubblicare a nome dell'attività. Rispondere a una recensione Google richiede un accesso approvato al Profilo dell'attività su Google, e quell'accesso lo detiene StarReview; TripAdvisor non dispone di alcuna API per le risposte, quindi il titolare pubblica la risposta approvata tramite un link fornito da StarReview. Collegato tramite StarReview, il suo agente ottiene:

• Pubblicazione sul Profilo dell'attività su Google tramite l'infrastruttura di StarReview, a nome dell'attività
• Per TripAdvisor (che non dispone di API per le risposte), una risposta pronta da pubblicare più un link diretto tramite cui il titolare la pubblica
• La voce propria dell'attività, appresa dalle risposte passate e dalle modifiche del titolare
• Approvazione umana per le recensioni sensibili e negative, sempre
• Un controllo del sentiment su ogni bozza, così non esce nulla che non dovrebbe uscire
• Una tracciabilità completa di ogni azione dell'agente

Endpoint

https://mcp.starreview.ch/

MCP HTTP streamable. Si colleghi via OAuth (consigliato, vedi sotto) oppure si autentichi con un token Bearer per attività nell'header Authorization: Bearer. Invii Accept: application/json, text/event-stream a ogni richiesta. Lo stesso server è raggiungibile anche su https://api.starreview.ch/api/agent/mcp. L'informativa sulla privacy del connettore descrive come vengono trattati i dati degli agenti.

Tool

• list_locations: le sedi collegate a questo token
• list_unanswered_reviews: le recensioni Google e TripAdvisor ancora senza risposta, ognuna contrassegnata con la sua piattaforma
• get_review_context: la recensione completa con le bozze esistenti
• draft_reply: generare una risposta nella voce dell'attività
• submit_reply_for_approval: mettere una delle varianti di StarReview nella coda di approvazione del titolare, con testo modificato e orario di pubblicazione preferito opzionali. Per una recensione TripAdvisor, una risposta approvata torna con un link tramite cui il titolare la pubblica
• submit_own_reply: mettere il testo di risposta del suo agente nella coda di approvazione, senza bozza StarReview; sempre con approvazione umana, mai programmato automaticamente

Il flusso

1. Il suo agente elenca le recensioni senza risposta e ne legge il contesto.
2. Sottopone una risposta, con la bozza di StarReview o con testo proprio, con orario di pubblicazione preferito opzionale.
3. La risposta entra nella coda di approvazione del titolare. Le recensioni negative attendono sempre un essere umano.
4. Dopo l'approvazione, StarReview pubblica una risposta Google dalla propria infrastruttura (all'orario preferito se impostato); per TripAdvisor restituisce un link tramite cui il titolare pubblica la risposta.

Collegarsi via OAuth (consigliato)

Da Claude o da qualsiasi client MCP compatibile con OAuth, aggiunga StarReview come connettore e acceda con il suo account StarReview. Approva una volta su una schermata di consenso, poi l'agente può redigere e sottoporre risposte per le attività di sua proprietà. Nessun token da copiare o gestire, e può scollegarlo in qualsiasi momento dalle sue impostazioni StarReview. Il collegamento è limitato alle sue attività: un agente non può mai toccare un'attività che non le appartiene, e continua a non pubblicare mai una risposta da sé.

Collegarsi dal suo codice

Per l'accesso programmatico, o un client senza OAuth, usi invece un token Bearer per attività. StarReview è un server MCP standard (HTTP streamable). Dall'API Claude lo aggiunga a mcp_servers e passi il token dell'attività come authorization_token:

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Prepara le risposte per le mie recensioni senza risposta." }
  ],
  "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" }
  ]
}

Il connettore MCP è in beta, quindi invii l'header beta attuale del connettore MCP (si veda la documentazione MCP di Anthropic). Gli altri client MCP si collegano allo stesso modo: li punti all'endpoint e imposti l'header Authorization: Bearer.

Esempio di sessione

Un flusso tipico. Ogni chiamata di tool restituisce JSON; le forme qui sotto sono rappresentative.

1. Elencare cosa attende una risposta. Chiamata di 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. Lasciare che StarReview rediga nella voce dell'attività. Chiamata di draft_reply con il 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
}

Poi confermi una variante con submit_reply_for_approval ({ "reviewId": "...", "variant": 1 }), con testo modificato opzionale.

2b. Oppure porti il suo testo. Salti la redazione e chiami submit_own_reply:

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

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

autoScheduled è sempre false per il testo proprio: attende sempre un essere umano.

3. Un umano approva, poi va online. La risposta resta nella coda di approvazione del titolare. Dopo l'approvazione, StarReview la pubblica su Google dalla propria infrastruttura, all'orario impostato in preferredPostAt se presente. Per una recensione TripAdvisor la risposta del submit restituisce invece awaitingManualPost: true e un platformListingUrl; StarReview non può pubblicare su TripAdvisor, quindi il titolare apre quel link e pubblica la risposta approvata. Le recensioni negative attendono sempre un essere umano.

Piani

Se un'attività ha già un piano StarReview, il suo agente lavora entro quel piano. Se gestisce un'agenzia con molte attività clienti, o sta costruendo un prodotto su StarReview, ci contatti e configureremo il piano adatto al suo volume.

Ottenere un token

Collegarsi via OAuth non richiede alcun token: accede con il suo account StarReview e approva. I token Bearer per attività sono l'alternativa per l'accesso programmatico, emessi dal titolare del conto StarReview. Se come agenzia o prodotto di agenti vuole collegare attività clienti, ci scriva e la configureremo.

FAQ