Agents

Pourquoi passer par StarReview

Un agent peut rédiger une réponse tout seul. Ce qu'il ne peut pas faire tout seul : la faire publier au nom de l'établissement. Répondre à un avis Google exige un accès approuvé au profil d'établissement Google, et c'est StarReview qui le détient ; TripAdvisor n'a pas du tout d'API de réponse, si bien que le propriétaire publie la réponse validée via un lien fourni par StarReview. Connecté via StarReview, votre agent obtient :

• La publication sur le profil d'établissement Google via l'infrastructure de StarReview, au nom de l'établissement
• Pour TripAdvisor (qui n'a pas d'API de réponse), une réponse prête à publier accompagnée d'un lien direct que le propriétaire utilise pour publier
• La voix propre de l'établissement, apprise de ses réponses passées et des corrections du propriétaire
• Une validation humaine pour les avis sensibles et négatifs, toujours
• Un contrôle de sentiment sur chaque brouillon, pour que rien ne parte qui ne devrait pas partir
• Une traçabilité complète de chaque action de l'agent

Point d'accès

https://mcp.starreview.ch/

MCP HTTP streamable. Connectez-vous via OAuth (recommandé, voir ci-dessous) ou authentifiez-vous avec un jeton Bearer par établissement dans l'en-tête Authorization: Bearer. Envoyez Accept: application/json, text/event-stream à chaque requête. Le même serveur est aussi accessible sur https://api.starreview.ch/api/agent/mcp. La politique de confidentialité du connecteur décrit le traitement des données des agents.

Outils

• list_locations : les établissements liés à ce jeton
• list_unanswered_reviews : les avis Google et TripAdvisor encore sans réponse, chacun étiqueté avec sa plateforme
• get_review_context : l'avis complet avec les brouillons existants
• draft_reply : générer une réponse dans la voix de l'établissement
• submit_reply_for_approval : placer une des variantes de StarReview dans la file de validation du propriétaire, avec texte ajusté et heure de publication préférée en option. Pour un avis TripAdvisor, une réponse validée revient avec un lien que le propriétaire utilise pour publier
• submit_own_reply : placer le texte de réponse de votre agent dans la file de validation, sans brouillon StarReview ; toujours validé par un humain, jamais programmé automatiquement

Le déroulement

1. Votre agent liste les avis sans réponse et lit leur contexte.
2. Il soumet une réponse, avec le brouillon de StarReview ou son propre texte, avec une heure de publication préférée en option.
3. La réponse entre dans la file de validation du propriétaire. Les avis négatifs attendent toujours un humain.
4. Une fois validée, StarReview publie une réponse sur Google depuis sa propre infrastructure (à l'heure de votre choix le cas échéant) ; pour TripAdvisor, il renvoie un lien que le propriétaire utilise pour publier la réponse.

Se connecter via OAuth (recommandé)

Depuis Claude ou tout client MCP compatible OAuth, ajoutez StarReview comme connecteur et connectez-vous avec votre compte StarReview. Vous validez une fois sur un écran de consentement, puis l'agent peut rédiger et soumettre des réponses pour les établissements que vous possédez. Aucun jeton à copier ni à gérer, et vous pouvez vous déconnecter à tout moment depuis vos paramètres StarReview. La connexion est limitée à vos propres établissements : un agent ne peut jamais toucher un établissement qui ne vous appartient pas, et il ne publie toujours jamais lui-même de réponse.

Se connecter depuis votre code

Pour un accès programmatique, ou un client sans OAuth, utilisez plutôt un jeton Bearer par établissement. StarReview est un serveur MCP standard (HTTP streamable). Depuis l'API Claude, ajoutez-le à mcp_servers et transmettez le jeton de l'établissement comme authorization_token :

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Rédigez des réponses à mes avis sans réponse." }
  ],
  "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" }
  ]
}

Le connecteur MCP est en bêta ; envoyez donc l'en-tête bêta actuel du connecteur MCP (voir la documentation MCP d'Anthropic). Les autres clients MCP se connectent de la même manière : pointez-les vers le point d'accès et définissez l'en-tête Authorization: Bearer.

Exemple de session

Un déroulement typique. Chaque appel d'outil renvoie du JSON ; les formes ci-dessous sont représentatives.

1. Lister ce qui attend une réponse. Appel de 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. Laisser StarReview rédiger dans la voix de l'établissement. Appel de draft_reply avec le 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
}

Puis validez une variante avec submit_reply_for_approval ({ "reviewId": "...", "variant": 1 }), avec texte ajusté en option.

2b. Ou apporter votre propre texte. Sauter la rédaction et appeler submit_own_reply :

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

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

autoScheduled est toujours false pour votre propre texte : il attend toujours un humain.

3. Un humain valide, puis c'est mis en ligne. La réponse reste dans la file de validation du propriétaire. Une fois validée, StarReview la publie sur Google depuis sa propre infrastructure, à l'heure définie dans preferredPostAt le cas échéant. Pour un avis TripAdvisor, la réponse de soumission renvoie plutôt awaitingManualPost: true et un platformListingUrl ; StarReview ne peut pas publier sur TripAdvisor, si bien que le propriétaire ouvre ce lien et publie la réponse validée. Les avis négatifs attendent toujours un humain.

Formules

Si un établissement a déjà une formule StarReview, son agent travaille dans le cadre de cette formule. Si vous gérez une agence avec de nombreux établissements clients, ou si vous construisez un produit sur StarReview, contactez-nous et nous mettrons en place la formule adaptée à votre volume.

Obtenir un jeton

Se connecter via OAuth ne nécessite aucun jeton : vous vous connectez avec votre compte StarReview et vous validez. Les jetons Bearer par établissement sont l'alternative pour un accès programmatique, émis par le titulaire du compte StarReview. Si vous êtes une agence ou un produit d'agents et souhaitez connecter des établissements clients, écrivez-nous et nous vous installerons.

FAQ