Galet

Connecter un agent IA à Galet avec le Model Context Protocol : lire les feedbacks, les corriger depuis l'IDE, envoyer des retours.

Galet expose un serveur MCP (Model Context Protocol). Un agent connecté (Claude, Cursor, Claude Code…) peut lire vos feedbacks et leurs retours, parcourir la carte des fonctionnalités, et envoyer un retour en votre nom. Typiquement : « corrige le bug le plus remonté sur l'export » directement depuis l'IDE.

L'adresse du serveur : https://api.galet.dev/mcp. La connexion se fait avec OAuth : pas de clé à copier, vous autorisez l'agent depuis Galet.

Connecter un agent

Claude (web, Desktop)

Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
Nom : Galet. URL : https://api.galet.dev/mcp.
Cliquez Se connecter : Galet s'ouvre et vous demande d'autoriser Claude.

Claude Code

claude mcp add --transport http galet https://api.galet.dev/mcp

Puis, dans Claude Code, lancez /mcp et choisissez galet pour vous connecter.

Cursor

Dans ~/.cursor/mcp.json (tous vos projets) ou .cursor/mcp.json (un projet) :

{
  "mcpServers": {
    "galet": {
      "url": "https://api.galet.dev/mcp"
    }
  }
}

Dans Cursor Settings → MCP, Galet apparaît avec Login (ou Needs authentication) : cliquez pour autoriser.

Autres clients

Tout client MCP qui prend en charge le transport Streamable HTTP et l'autorisation OAuth de la spécification MCP fonctionne : il découvre seul le serveur d'autorisation de Galet et s'y enregistre.

L'écran d'autorisation

Quand l'agent se connecte, Galet vous montre :

le nom de l'application et l'adresse vers laquelle vous serez renvoyé : le nom est déclaré par l'application, l'adresse permet de vérifier que c'est bien l'outil que vous connectez (par exemple claude.ai) ;
l'organisation à laquelle donner l'accès, si vous êtes connecté à plusieurs ;
ce que l'agent pourra faire.

L'agent agit en votre nom, dans une seule organisation, avec vos droits.

Permission	Ce qu'elle permet	Rôles
Lire	Lister et lire les feedbacks, leurs retours, les apps et la carte des fonctionnalités	Admin, Membre, Lecteur
Envoyer	Créer un retour	Admin, Membre
Mettre à jour	Changer le statut d'un feedback et le commenter	Admin, Membre

Un Lecteur ne peut donner que la lecture.

Les outils

Outil	Ce qu'il fait
`list_apps`	Les apps de l'organisation, avec leur identifiant
`list_features`	La carte des fonctionnalités : chemin, type, sévérité plancher, fichiers de code rattachés, feedbacks ouverts
`list_feedbacks`	Les feedbacks, du plus récemment actif au plus ancien. Filtres : statut (ouverts par défaut), type, sévérité, app, fonctionnalité, texte
`get_feedback`	Un feedback par sa clé (`FIF-12`) : résumé, observé et attendu, retours, ticket lié
`get_feature`	Une fonctionnalité : chemin, sévérité plancher, fichiers de code rattachés et feedbacks ouverts
`update_feedback_status`	Change le statut d'un feedback, avec un commentaire (par exemple la PR du correctif). Le ticket Jira ou Linear lié suit ; `delivered` prévient les personnes qui suivent le feedback
`create_report`	Envoie un retour. Galet AI le qualifie, le rattache à une fonctionnalité et le regroupe avec un feedback existant s'il en parle déjà

Un agent connecté avant l'arrivée de update_feedback_status doit être reconnecté pour obtenir la permission Mettre à jour.

Un retour envoyé par l'agent compte dans le quota mensuel de feedbacks, comme un ajout manuel depuis l'inbox. S'il relaie le retour de quelqu'un d'autre, l'agent peut indiquer son nom et son e-mail : la personne sera prévenue de la suite.

Le contexte complet avec Silex

Avec Silex (inclus dans les plans Croissance et Entreprise), get_feedback donne aussi à l'agent tout ce qu'il faut pour corriger sans redemander :

le diagnostic de Galet AI (où, cause probable, action suggérée) ;
la fonctionnalité rattachée, le besoin utilisateur et les fichiers de code associés ;
la conversation de qualification (les étapes de reproduction) ;
la page, le navigateur, le système, l'écran ;
la console, les erreurs réseau et le fil d'Ariane ;
la capture d'écran et le replay de session (liens signés, valables peu de temps). Le replay est enregistré avec le masquage des champs.

Sans Silex, get_feedback répond avec le feedback et ses retours, et l'indique.

Retirer un accès

Mon compte → Agents liste les agents connectés, ce qu'ils peuvent faire et quand ils ont servi pour la dernière fois. Retirer l'accès coupe l'agent immédiatement. Un Admin y voit les agents de toute l'équipe et peut retirer n'importe lequel.

L'accès tombe aussi tout seul quand la personne quitte l'organisation, et au bout de 30 jours sans usage.

Pour les développeurs de clients


Serveur MCP	`https://api.galet.dev/mcp` (Streamable HTTP, sans session)
Ressource protégée (RFC 9728)	`https://api.galet.dev/.well-known/oauth-protected-resource/mcp`
Serveur d'autorisation (RFC 8414)	`https://api.galet.dev/.well-known/oauth-authorization-server`
Enregistrement dynamique (RFC 7591)	`POST https://api.galet.dev/oauth/register`
Flux	Code d'autorisation avec PKCE `S256` obligatoire, paramètre `resource` (RFC 8707)
Portées	`feedbacks:read`, `reports:write`, `feedbacks:write`
Jetons	Accès : 1 h. Rafraîchissement : 30 jours, renouvelé à chaque usage ; un jeton de rafraîchissement réutilisé révoque l'accès
Révocation (RFC 7009)	`POST https://api.galet.dev/oauth/revoke`
API REST	Le même jeton d'accès lit `GET /v1/feedbacks`, `/v1/feedbacks/{key}`, `/v1/apps` et `/v1/apps/{id}/features` (portée `feedbacks:read`) et change un statut avec `PATCH /v1/feedbacks/{key}` (portée `feedbacks:write`) : voir la référence de l'API

MCP : Galet dans Claude, Cursor et vos agents