Connecter un agent de code

Pommy est un serveur MCP. L'agent avec lequel vous codez déjà — Claude Code, Codex, Cursor, VS Code, ou tout client qui parle streamable HTTP et OAuth — peut s'y connecter, et dès lors lire votre configuration Pommy et la modifier pour vous : vérifier ce qui manque à un projet, récupérer le code d'installation du widget et le coller dans le site sur lequel il travaille déjà, ajouter un document à la base de connaissances, réécrire les instructions de l'assistant.

Cela se configure sur la page Coding Agents du menu de gauche. C'est une page pour développeurs, et rien d'autre dans Pommy n'en dépend — si vous n'ouvrez jamais de terminal, passez entièrement cette section.

Ce que l'agent peut faire#

La connexion propose un ensemble fixe d'outils. Rien en dehors de cette liste ne peut être appelé, quoi que demande l'agent. Ceux marqués oui modifient votre configuration ; ils ne sont proposés que si vous avez accordé l'autorisation d'effectuer des modifications, et sans elle l'agent ne les voit même pas.

Il n'existe aucun outil pour autre chose : pas de suppression de projet, pas de modification de la facturation, pas de gestion d'équipe, pas de publication de parcours. Lire une conversation est possible, car corriger une réponse fausse commence par la lire ; écrire dans une conversation en votre nom ne l'est pas.

Se connecter#

1. Ouvrez Coding Agents et choisissez votre agent

   Les onglets en haut de la carte Connect — Claude Code, Codex, Cursor, VS Code, Other — affichent chacun la commande ou le fichier exact pour ce client. Copiez-le depuis la page ; l'adresse est déjà renseignée.

2. Lancez la commande, ou enregistrez le fichier

   Claude Code et Codex prennent une commande d'une ligne dans le terminal. Cursor et VS Code lisent un petit fichier JSON — la page indique lequel, et son chemin.

3. Connectez-vous

   Votre agent ouvre le navigateur et vous vous connectez à Pommy avec votre propre compte. Dans Claude Code, la connexion démarre avec la commande /mcp ; dans Codex, avec codex mcp login pommy ; Cursor et VS Code ouvrent le navigateur d'eux-mêmes.

4. Choisissez les projets qu'il peut atteindre

   Le navigateur affiche l'écran de consentement de Pommy. Choisissez les projets, approuvez, et l'agent est connecté.

claude mcp add --transport http pommy https://api.pommy.ai/mcp

codex mcp add pommy --url https://api.pommy.ai/mcp

{
  "mcpServers": {
    "pommy": {
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

{
  "servers": {
    "pommy": {
      "type": "http",
      "url": "https://api.pommy.ai/mcp"
    }
  }
}

Tout autre client fonctionne aussi : indiquez-lui la même adresse, https://api.pommy.ai/mcp. C'est un endpoint streamable HTTP protégé par OAuth, et le client découvre tout le reste — quel serveur d'autorisation utiliser, quelles autorisations existent — tout seul.

L'écran de consentement#

C'est à l'étape du navigateur que l'autorisation est réellement donnée ; il pose donc deux questions à la fois : ce que cette application aura le droit de faire, et où.

• Quelle application demande l'accès — le nom sous lequel elle s'est enregistrée, affiché en haut. Une application que Pommy ne reconnaît pas n'arrive jamais à cet écran.
• Ce qu'elle aura le droit de faire — une ligne par autorisation demandée : lire vos projets, y effectuer des modifications, savoir qui vous êtes. Lisez attentivement la ligne des modifications ; c'est celle qui compte.
• Quels projets — tous les projets auxquels vous avez accès, regroupés par organisation. Au-delà de six projets, un champ de recherche apparaît. Rien ne peut être approuvé sans au moins un projet coché.

Cocher un projet n'accorde rien ; cela restreint ce que l'agent peut toucher. Vous ne distribuez pas d'accès ici, vous choisissez quelle partie de votre propre accès vous prêtez.

Vous voyez cet écran à chaque connexion, même si vous avez déjà connecté ce client — c'est voulu, car la liste des projets est justement ce que vous pourriez vouloir changer. Votre choix précédent est précoché : si rien n'a changé, la réautorisation se fait en un clic.

Autorisations et sécurité#

• Il agit en votre nom. La connexion porte vos propres autorisations et rien de plus — elle ne peut donc jamais aller au-delà de ce que vous pouvez faire. Si vous ne pouvez pas modifier un assistant dans le tableau de bord, votre agent non plus.
• Uniquement les projets choisis. Ce que l'agent peut toucher, c'est votre accès actuel et les projets cochés sur l'écran de consentement — les deux, pas l'un ou l'autre.
• L'accès est revérifié à chaque appel, et non mémorisé depuis le jour de l'approbation. Si vous perdez l'accès à un projet — vous quittez l'équipe, votre rôle change —, l'agent le perd au même moment, sans rien à révoquer.
• Les modifications suivent le même chemin que le tableau de bord. Tout ce qu'écrit l'agent passe par les mêmes procédures que le tableau de bord : même validation des saisies, mêmes contrôles d'autorisation, même quota, même journal d'audit. Un document ajouté depuis votre terminal est indiscernable d'un document ajouté à la main — y compris dans le journal d'audit.
• Rien de global à la plateforme n'est exposé. La liste des outils est choisie à la main, et aucun outil nécessitant des droits d'administrateur de la plateforme n'y figure — pas même pour un compte qui les possède.
• La connexion est la vôtre, pas celle de votre équipe. Connecter votre agent ne connecte celui de personne d'autre, et révoquer le vôtre ne touche pas aux leurs.

Voir et révoquer les connexions#

La carte Connected à droite de la page Coding Agents liste chaque agent que vous avez autorisé : le nom enregistré par le client, le nombre de projets qu'il atteint et la date de l'autorisation.

Revoke demande une confirmation, puis l'agent n'atteint plus aucun projet. Le jeton qu'il détient peut rester valide un moment, mais il n'ouvre plus aucune porte : chaque appel d'outil indique qu'il ne peut rien atteindre. Pour réactiver l'agent, relancez la connexion depuis votre client et choisissez à nouveau les projets.

Quand quelque chose ne fonctionne pas#