# Brancher PipeSAV sur un assistant IA > Ce guide s'adresse à toi, assistant IA (Claude, ChatGPT, Gemini, Codex, Cursor…). Un marchand t'a envoyé ici pour brancher son SAV PipeSAV sur toi. Lis-le en entier, choisis ta voie, fais seul ce que tu peux faire, et guide-le pour le reste. Parle-lui simplement : il n'est pas développeur. PipeSAV répond aux emails SAV d'une boutique Shopify. Une fois branché, tu lis pour le marchand ses dossiers, ses chiffres et ses réglages (politiques, seuils d'autonomie) — rien d'autre que ce qu'il t'autorise. Tu peux aussi lui proposer un changement de réglage : il ne s'applique que s'il le valide dans PipeSAV. Ce PipeSAV : https://app.pipesav.com. ## La règle : jamais de clé dans une conversation - Ne demande jamais au marchand de coller sa clé d'accès (elle commence par `psv_`) dans la conversation. Ne l'écris jamais toi-même dans un message, un fichier, un journal ou une commande que tu lances. - C'est lui qui la range : dans son terminal (`pipesav login`, qui la lit sans l'afficher), ou dans les réglages MCP de son assistant. - S'il la colle quand même : dis-lui de la révoquer tout de suite sur https://app.pipesav.com/settings/api-keys, et d'en créer une autre. ## Quelle voie prendre | Tu es… | Ta voie | | --- | --- | | Un assistant qui a un terminal sur l'ordinateur du marchand : Claude Code, Codex, Cursor | Voie 1, la ligne de commande et son skill — la voie recommandée. Sinon, voie 2. | | Une conversation sans terminal : claude.ai, l'app Claude, ChatGPT | Voie 3, « Se connecter avec PipeSAV ». | | Gemini CLI ou Antigravity, dans un terminal | Voie 1 pour Gemini CLI, la ligne de commande et son skill. Sinon, et pour Antigravity, voie 2, le serveur MCP avec une clé. | | Gemini Enterprise (l'offre de Google pour les entreprises) | Voie 4, l'identifiant Gemini Enterprise et « Se connecter avec PipeSAV ». | | L'app Gemini grand public (gemini.google.com) | Pas encore : elle ne s'ouvre aux serveurs comme PipeSAV qu'aux États-Unis. Dis-le au marchand ; propose Gemini CLI s'il a un terminal. | ## Voie 1 — la ligne de commande `pipesav` et le skill PipeSAV (recommandée) Pour un assistant qui lance des commandes sur l'ordinateur du marchand. Le skill t'apprend une fois comment lire PipeSAV ; ensuite, tu t'en sers seul. > **Pas encore disponible.** La ligne de commande n'est pas encore publiée sur npm : `npm install -g pipesav` échoue pour l'instant. N'installe aucun autre paquet à sa place. En attendant, prends la voie 2 (le serveur MCP avec une clé), et dis-le au marchand. 1. Vérifie que Node 20 ou plus est là : `node --version`. 2. Installe la ligne de commande : `npm install -g pipesav`. 3. Demande au marchand de créer sa clé (voir « Ce que tu demandes au marchand »). 4. Demande-lui de lancer LUI-MÊME, dans un terminal à lui (pas dans cette conversation), la commande ci-dessous, et d'y coller sa clé quand elle la demande. Ne la lance pas à sa place avec la clé. ```bash pipesav login ``` 5. Vérifie l'accès : `pipesav whoami` rend le nom de la clé et ce qu'elle permet. 6. Installe le skill PipeSAV là où tu ranges tes skills ; son texte est la sortie de `pipesav skill`. Pour Claude Code : ```bash mkdir -p ~/.claude/skills/pipesav && pipesav skill > ~/.claude/skills/pipesav/SKILL.md ``` Pour Gemini CLI : ```bash mkdir -p ~/.gemini/skills/pipesav && pipesav skill > ~/.gemini/skills/pipesav/SKILL.md ``` Si tu n'as pas de dossier de skills, lis la sortie de `pipesav skill` et suis-la. 7. Lis le skill, puis réponds au marchand : combien de dossiers attendent sa validation, et lequel attend depuis le plus longtemps. ## Voie 2 — le serveur MCP, avec une clé Pour un assistant qui a un terminal, quand la voie 1 n'est pas possible ou que le marchand la refuse. Mêmes lectures, sans rien installer. - L'adresse du serveur : `https://app.pipesav.com/api/mcp` (transport HTTP). - L'en-tête : `Authorization: Bearer TA_CLÉ`, où le marchand remplace `TA_CLÉ` par sa clé. 1. Demande au marchand de créer sa clé (voir « Ce que tu demandes au marchand »). 2. Donne-lui la commande ou le réglage qui te correspond, à lancer ou à remplir LUI-MÊME, en dehors de cette conversation : - Claude Code — dans un terminal à lui, ces trois lignes : la première lui demande sa clé sans l'afficher (il la colle, puis Entrée), la deuxième branche PipeSAV, la troisième oublie la clé. Elle ne reste ni à l'écran ni dans l'historique du terminal ; seul Claude Code la garde, dans ses réglages. ```bash printf 'Clé PipeSAV : ' && read -rs PIPESAV_KEY && echo claude mcp add --transport http pipesav https://app.pipesav.com/api/mcp --header "Authorization: Bearer $PIPESAV_KEY" unset PIPESAV_KEY ``` - Gemini CLI — de même, dans un terminal à lui ; `--scope user` branche PipeSAV pour tous ses dossiers (dans `~/.gemini/settings.json`) : ```bash printf 'Clé PipeSAV : ' && read -rs PIPESAV_KEY && echo gemini mcp add --transport http --scope user --header "Authorization: Bearer $PIPESAV_KEY" pipesav https://app.pipesav.com/api/mcp unset PIPESAV_KEY ``` Une version de Gemini CLI sans `gemini mcp add` : le même serveur s'ajoute à la main dans `~/.gemini/settings.json`, sous `mcpServers`, avec `httpUrl` (l'adresse) et `headers` (l'en-tête) — sans remplacer ses autres réglages. - Antigravity (qui remplace Gemini CLI pour les comptes individuels) : dans ses réglages MCP, l'adresse (`serverUrl`) et l'en-tête ci-dessus. - Cursor, Codex et les autres : dans leurs réglages MCP, l'adresse et l'en-tête ci-dessus. Dis-lui où se trouvent ces réglages chez toi. 3. Une fois l'assistant relancé, les outils de PipeSAV apparaissent (`describe_key`, `list_conversations`, `get_stats`…). Appelle `describe_key` pour vérifier, puis réponds à sa première question. ## Voie 3 — « Se connecter avec PipeSAV » (claude.ai, ChatGPT) Pour une conversation sans terminal. Aucune clé à créer : le marchand ajoute PipeSAV comme connecteur, puis accepte sur l'écran de PipeSAV ce que tu pourras lire. Tu ne peux pas le faire à sa place : donne-lui ces gestes, un par un. - **claude.ai** (et l'app Claude) : Paramètres › Connecteurs › « Ajouter un connecteur personnalisé ». Nom : PipeSAV. Adresse : `https://app.pipesav.com/api/mcp`. Puis « Se connecter » : PipeSAV s'ouvre ; il coche ce que Claude pourra lire, puis « Autoriser ». - **ChatGPT** : Paramètres › Applications et connecteurs › Avancé, allumer le « Mode développeur ». Puis « Créer » une application : nom PipeSAV, adresse `https://app.pipesav.com/api/mcp`, authentification OAuth. Puis « Se connecter » : PipeSAV s'ouvre ; il coche ce que ChatGPT pourra lire, puis « Autoriser ». Revenu dans la conversation, les outils de PipeSAV sont là : réponds à sa première question. ## Voie 4 — Gemini Enterprise Pour Gemini Enterprise, l'offre de Google pour les entreprises. Ni toi ni le marchand ne pouvez l'ajouter depuis la conversation : c'est l'administrateur de son Gemini Enterprise qui ajoute PipeSAV, dans sa console. Donne au marchand ces gestes, un par un. 1. Le propriétaire de la boutique crée son identifiant Gemini Enterprise sur https://app.pipesav.com/settings/assistant : il choisit Google, puis « Créer l'identifiant Gemini Enterprise ». Il reçoit un identifiant (Client ID) et un secret (Client Secret), affiché une seule fois. Il ne les colle jamais dans cette conversation. 2. L'administrateur de Gemini Enterprise ajoute PipeSAV : édition Business, Paramètres › Gérer l'équipe › Applications connectées › « Add MCP Server » ; éditions Standard et Plus, un « data store » MCP dans la console Google Cloud. Il saisit : - l'adresse du serveur (MCP Server URL) : `https://app.pipesav.com/api/mcp` ; - l'authentification : OAuth 2.0 ; - l'adresse d'accord (Authorization URL) : `https://app.pipesav.com/oauth/authorize`, sans rien ajouter ; - l'adresse des jetons (Token URL) : `https://app.pipesav.com/api/oauth/token` ; - l'identifiant et le secret de l'étape 1 ; - les blocs (Scopes) : `conversations:read stats:read settings:read` ; - cocher « Enable PKCE Support », et laisser « Use HTTP Basic Authentication » cochée. 3. L'administrateur allume la connexion (elle naît éteinte). Si l'option d'un serveur MCP manque, une règle d'organisation de Google la bloque : c'est à lui de l'ouvrir. 4. Au premier usage, PipeSAV s'ouvre : le propriétaire coche ce que Gemini pourra lire, puis « Autoriser ». L'identifiant ne sert qu'à sa boutique. Secret perdu : il recrée l'identifiant sur la même page, et l'administrateur colle les nouvelles valeurs. ## Une autre adresse de PipeSAV Ce guide donne les adresses de https://app.pipesav.com. Si le marchand, ou le texte qu'il t'a donné, t'indique une autre adresse de PipeSAV (son poste, une préversion), mets-la à la place de https://app.pipesav.com dans chaque adresse de ce guide. - Pour la ligne de commande, lance chacune de tes commandes, `pipesav login` compris, avec `PIPESAV_API_URL=/api/v1` devant (ou `export PIPESAV_API_URL=/api/v1` une fois dans le terminal). - Pour le serveur MCP et « Se connecter avec PipeSAV », l'adresse du serveur devient `/api/mcp`. ## Une fois branché Ce que tu peux appeler chez PipeSAV avec la clé du marchand (chaque outil, commande et adresse qu'elle permet, la limite d'appels, chaque erreur et ce que tu fais) : la référence pour les assistants, bâtie pour cette clé. Elle se lit avec la clé, par l'outil `get_reference` du serveur MCP, la commande `pipesav reference`, ou, avec une clé collée, l'adresse `GET https://app.pipesav.com/api/v1/reference`. Lis-la avant de répondre au marchand qu'une chose est impossible. ## Si ça ne marche pas - Accès refusé (`401`, `invalid_key`) : la clé a été révoquée ou mal copiée. Le marchand en crée une autre sur https://app.pipesav.com/settings/assistant. - Le marchand voit ses assistants branchés, et le dernier usage de chacun, en bas de https://app.pipesav.com/settings/assistant. ## Ce que tu demandes au marchand Ces gestes lui reviennent, selon ta voie ; fais tout le reste. Dis-les-lui simplement, un par un, quand le moment vient. - **Créer sa clé** (voies 1 et 2) : sur https://app.pipesav.com/settings/assistant, en bas de la page, « Créer une clé ». Le nom et les trois lectures sont proposés d'avance ; « Proposer des changements de réglages » s'ajoute s'il veut que tu proposes des changements, et « Modifier directement les réglages », avec ses cases « Politiques » et « Autonomie », s'il veut que tu les fasses toi-même, sans validation. La clé ne s'affiche qu'une fois : il la garde pour `pipesav login` ou pour les réglages MCP, jamais pour cette conversation. - **Ranger sa clé lui-même** (voies 1 et 2) : voie 1, lancer `pipesav login` dans un terminal à lui et y coller sa clé ; voie 2, lancer la commande ou remplir les réglages que tu lui donnes. - **Ajouter PipeSAV comme connecteur** (voie 3) : dans claude.ai ou ChatGPT, les gestes de la voie 3, un par un. - **Créer son identifiant Gemini Enterprise** (voie 4) : sur https://app.pipesav.com/settings/assistant, Google choisi, « Créer l'identifiant Gemini Enterprise » ; puis le donner, avec son secret, à l'administrateur de son Gemini Enterprise — jamais dans cette conversation. - **Valider « Se connecter avec PipeSAV »** (voies 3 et 4) : sur l'écran de PipeSAV qui s'ouvre, cocher ce que tu pourras lire, puis « Autoriser ». Seul le propriétaire de la boutique crée une clé ou autorise un assistant. Un membre de l'équipe le lui demande.