Aller au contenu
Documentation · Agents IA (MCP)

Pour les développeurs

Connecter un agent IA (MCP)

Parlo expose un serveur MCP : Claude Code, Codex ou tout client compatible peut lire vos retours, les chercher, ajouter des notes, changer les statuts et répondre aux utilisateurs.

1Créez une clé d'API

Paramètres → Agents IA (MCP) → Créer une clé d'API. La clé (parlo_…) n'est affichée qu'une fois. Elle donne accès aux retours de tout l'espace : gardez-la hors de votre code source.

2Connectez votre agent

Claude Code

Terminal
claude mcp add --transport http parlo https://sayparlo.com/api/mcp --header "Authorization: Bearer VOTRE_CLÉ"

Autres clients MCP

JSON
{
  "mcpServers": {
    "parlo": {
      "type": "http",
      "url": "https://sayparlo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLÉ"
      }
    }
  }
}

3Demandez

  • « Quels bugs ont été signalés cette semaine ? »
  • « Lis le retour le plus signalé et propose un correctif dans le code. »
  • « Passe ce retour en Fait et prépare une réponse pour l'utilisateur. »

Outils disponibles

OutilRôle
list_feedbacksLister et chercher : tri, type, statut public, texte, site, version, période, tests, nombre.
get_feedbackUn retour complet : transcription, contexte, sujet, réponses et notes. L’e-mail de l’utilisateur n’est pas exposé.
list_topicsLes sujets regroupés (même problème signalé par plusieurs personnes).
add_noteAjouter une note interne, signée « Agent » et le nom de la clé ; un @prénom prévient le membre mentionné.
set_statusChanger le tri (à traiter, traité, archivé) et le statut public, pour un retour ou tout son sujet.
assign_feedbackAttribuer un retour (ou tout son sujet) à un membre, par son e-mail ; list_feedbacks filtre aussi par attribution.
reply_to_userRépondre par e-mail au nom du site ; l’auteur de la clé reçoit les réponses.

Détails techniques

  • Point d'accès : POST https://sayparlo.com/api/mcp, JSON-RPC 2.0, transport HTTP « streamable » avec réponses JSON.
  • Versions du protocole : 2025-06-18, 2025-03-26 et 2024-11-05.
  • Authentification : en-tête Authorization: Bearer parlo_…. Une clé révoquée est refusée immédiatement (401).
  • 10 clés actives au maximum par espace.