Intégrations IA/Utiliser Ofrr.io avec un agent

Utiliser Ofrr.io avec un agent

Connectez votre agent à Ofrr.io, chargez le bon playbook et transformez un brief en offre sans automatiser les décisions commerciales.

Connecter votre agent

Donnez le lien canonique à votre agent. S’il peut configurer son environnement, il installe Ofrr.io et vous rend la main pour OAuth. Sinon, il vous indique l’unique action manuelle restante.

https://ofrr.io/docs/ofrr-agents
Claude Code
guidé
Claude Code peut enregistrer le serveur HTTP, puis vous rend la main pour autoriser Ofrr.io dans le navigateur.

Ajouter Ofrr.io

claude mcp add --transport http ofrr https://ofrr.io/api/mcp
Voir le guide
Codex
guidé
Codex peut enregistrer le serveur distant et lancer le flux OAuth depuis la CLI lorsqu’elle est disponible.

Ajouter Ofrr.io

codex mcp add ofrr --url https://ofrr.io/api/mcp

Se connecter

codex mcp login ofrr
Voir le guide
Cursor
manuel
Cursor demande une configuration MCP dans les réglages ou dans mcp.json avant d’ouvrir le flux d’autorisation.

Configuration mcp.json

{
  "mcpServers": {
    "ofrr": {
      "url": "https://ofrr.io/api/mcp"
    }
  }
}
Voir le guide
ChatGPT
conditionnel
Un plan compatible, le mode développeur et parfois une autorisation administrateur sont requis. La configuration se fait dans l’interface ChatGPT.

URL du connecteur

https://ofrr.io/api/mcp
Voir le guide

Playbooks disponibles

create_offer

Transformer un brief client en cadrage confirmé, prix calculé et offre Ofrr.io prête à relire.

defend_offer

Préparer la défense d’une offre Ofrr.io et encadrer toute concession avant une éventuelle V2.

Ofrr.io expose les mêmes outils à Claude Code, Codex, Cursor et aux connecteurs MCP personnalisés compatibles. La configuration dépend de la surface, mais le parcours commercial reste identique et s’arrête toujours avant publication.

Le principe

Donnez l’URL de cette page à votre agent. S’il peut modifier sa propre configuration locale, il ajoute le serveur MCP Ofrr.io puis vous rend la main pour OAuth. Sinon, il vous indique l’unique action manuelle restante.

L’autorisation OAuth vous demande de choisir l’organisation et les permissions. Votre mot de passe Ofrr.io n’est jamais transmis à l’agent.

Compatibilité par surface

SurfaceConfigurationOAuthLimite à connaître
Claude CodeCommande CLINavigateurL’utilisateur termine toujours l’autorisation
CodexCommande CLI si disponibleNavigateurVérifiez la commande avec la version installée
CursorRéglages MCP ou mcp.jsonInterface du clientUne modification manuelle peut rester nécessaire
ChatGPTInterface, plan compatible et parfois administrateurInterface du clientLa disponibilité dépend du plan et du mode utilisés

Un deep link peut préremplir une consigne. Il ne peut pas modifier les réglages du client, installer un connecteur ou franchir OAuth à votre place.

Créer une offre

Demandez à l’agent de charger get_skill avec name: "create_offer". Le playbook impose la séquence suivante :

  1. créer l’analyse avec create_proposal_from_brief ;
  2. relayer le cadrage et ouvrir l’offre dans Ofrr.io ;
  3. obtenir votre confirmation explicite du périmètre et de l’archétype ;
  4. appeler recalculate_proposal avec confirmScope: true ;
  5. présenter le prix et l’offre, puis s’arrêter avant publication.

Les prix calculés, les hypothèses et les suggestions IA doivent rester identifiables séparément.

Défendre une offre

Chargez get_skill avec name: "defend_offer". L’agent peut relire l’offre, expliquer le prix, préparer des arguments et expliciter l’impact de chaque concession.

Sans outil MCP de négociation dédié, il ouvre le Copilot Ofrr.io pour finaliser la réponse. Si un accord modifie le prix, le périmètre, les livrables ou le calendrier d’une offre publiée, l’agent doit obtenir votre accord avant de créer une V2. Il ne modifie jamais la version publiée.

Playbook MCP et skill natif

get_skill retourne un playbook pour la session courante. Cela ne signifie pas qu’un fichier de skill natif a été installé dans votre client.

Les projections natives utilisent les noms ofrr-create-offer et ofrr-defend-offer. Leur installation reste optionnelle : le contenu métier vient de la même définition que le playbook MCP.

Permissions et révocation

Les permissions de lecture, création, modification commerciale, publication, statut, coordonnées client et corbeille sont séparées. Vous pouvez les modifier ou révoquer la connexion dans Réglages → Agents IA.

La consultation des playbooks ne demande pas de permission commerciale supplémentaire, mais le serveur MCP reste authentifié et rattaché à une organisation autorisée.

Résoudre un problème

  • Le serveur n’apparaît pas : vérifiez la configuration propre à votre client et redémarrez-le s’il le demande.
  • OAuth ne s’ouvre pas : supprimez la connexion incomplète, ajoutez de nouveau l’URL MCP, puis relancez l’authentification.
  • Une action est refusée : activez uniquement la permission indiquée dans Réglages → Agents IA.
  • ChatGPT ne propose pas le connecteur : vérifiez le plan, le mode développeur et la politique de votre espace de travail. Ne supposez pas la compatibilité à partir d’un autre client.

Consultez ensuite le guide détaillé de Claude, Codex, Cursor ou ChatGPT.

Bien démarrer avec Ofrr.ioConnecter Ofrr.io à Codex