Agents

Pourquoi passer par StarReview

Un agent peut rédiger une réponse, mais il ne peut jamais publier directement au nom de l'établissement. StarReview détient l'accès approuvé au profil d'établissement Google et applique vos réglages existants de validation et de publication automatique. TripAdvisor, Booking.com, Expedia et HolidayCheck n'ont pas d'API de réponse, si bien que le propriétaire y publie via un lien fourni. 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, Booking.com, Expedia et HolidayCheck (qui n'ont 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
• Les réponses rédigées par l'agent, modifiées ou retenues par les contrôles de sécurité restent toujours en attente
• 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

Guides pour votre agent

Des guides pas à pas par agent, de la connexion à la première validation :

Vous préférez la ligne de commande ? La CLI StarReview (@starreview/cli) imprime du JSON sur stdout et est construite pour les agents et les scripts.

Essayer sans compte

Trois outils ne demandent aucune information d'identification. Pointez n'importe quel client MCP vers le point d'accès sans en-tête Authorization et vous obtenez :

• get_service_info : ce que fait StarReview, ce que cela coûte et comment s'authentifier
• search_business : trouver un établissement sur Google Maps par nom et par ville
• check_response_rate : la part des avis Google récents d'un établissement ayant reçu une réponse du propriétaire, comparée à deux concurrents proches

En lecture seule, avec une limite par IP. Une fois authentifié, vous obtenez à la place les sept outils métier ; les deux ensembles sont distincts, un client authentifié ne voit donc plus ceux-ci.

Point d'accès

https://mcp.starreview.ch/

MCP HTTP streamable. Connectez-vous via OAuth (recommandé, voir ci-dessous) ou authentifiez-vous avec une clé Bearer propriétaire couvrant le compte 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 notice de confidentialité Agent et MCP actuelle décrit le traitement des données des agents.

La découverte OAuth suit la RFC 9728 : récupérez https://mcp.starreview.ch/.well-known/oauth-protected-resource pour trouver le serveur d'autorisation, enregistrez-vous dynamiquement et exécutez le flux d'autorisation avec PKCE. Une requête sans identifiant répond 401 avec un en-tête WWW-Authenticate pointant vers ce même document, de sorte qu'un client conforme trouve son chemin tout seul.

Outils

• list_locations : les établissements de l'entreprise pour laquelle vous agissez
• list_unanswered_reviews : les avis Google, TripAdvisor, Booking.com, Expedia et HolidayCheck encore sans réponse, chacun étiqueté avec sa plateforme
• get_review_stats : indicateurs d'avis en lecture seule : note moyenne, taux de réponse, retard et répartition par 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 : soumettre une variante StarReview aux règles de validation et de publication automatique, avec texte ajusté et heure préférée en option. Un texte ajusté reste en attente ; les plateformes sans API de réponse renvoient un lien pour la publication manuelle
• 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. StarReview évalue la réponse selon votre consentement, vos réglages et les contrôles de sécurité. Les textes rédigés par l'agent, les réponses modifiées ou retenues par les contrôles de sécurité restent en attente.
4. Une proposition StarReview éligible et non modifiée peut être programmée automatiquement. Les plateformes sans API de réponse renvoient un lien pour une publication manuelle.

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.

Si vous possédez plusieurs établissements, une connexion OAuth vous identifie vous, et non un établissement unique : l'agent doit donc préciser lequel. Appelez un outil sans businessId et vous recevez un sélecteur au lieu du travail demandé :

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

Il s'agit d'un résultat réussi, pas d'une erreur : vérifiez-le avant de traiter une réponse comme le résultat. Rappelez avec businessId défini. Les outils qui prennent un reviewId ne renvoient jamais de sélecteur : l'avis détermine déjà l'établissement. Les clés propriétaire couvrant le compte suivent les mêmes règles de sélection qu'OAuth. Seuls les anciens identifiants ou ceux émis par un administrateur et explicitement limités fixent un établissement sans sélecteur.

Se connecter depuis votre code

Pour un accès programmatique, ou un client sans OAuth, utilisez plutôt une clé Bearer propriétaire couvrant le compte. StarReview est un serveur MCP standard (HTTP streamable). Depuis l'API Claude, ajoutez-le à mcp_servers et transmettez la clé propriétaire 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. StarReview applique vos règles. Les textes rédigés par l'agent, les brouillons modifiés ou retenus par les contrôles de sécurité restent dans la file de validation. Une proposition StarReview éligible et non modifiée peut être programmée selon votre consentement et vos réglages de publication automatique. Sur les plateformes sans API de réponse, le résultat renvoie awaitingManualPost: true et un platformListingUrl ; le propriétaire publie lui-même.

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 aucune clé : vous vous connectez avec votre compte StarReview et vous validez. Les clés Bearer propriétaire couvrant le compte sont l'alternative en libre-service pour un accès programmatique et couvrent les établissements appartenant à ce compte. Les anciens identifiants ou ceux émis par un administrateur peuvent être explicitement limités à un établissement. Si vous êtes une agence ou un produit d'agents et souhaitez connecter des établissements clients, écrivez-nous et nous vous installerons.

FAQ