Connexion
Connecte le système aux applications de l'utilisateur via une passerelle d'outils : un seul serveur MCP (Composio) à partir duquel chaque application est autorisée. Avance étape par étape et attends la confirmation de l'utilisateur avant chaque étape suivante.
Avant de commencer
- Lis
opencode.jsonetmemory/wiki/conexiones.md(si ce fichier existe). Si Composio est déjà activé, passe directement à l'étape 4. - Explique en une ligne ce que tu vas faire et que l'objectif minimal est une application connectée.
Étape 1 · Compte et clé
Demande à l'utilisateur d'effectuer les actions suivantes dans son navigateur :
- Aller sur https://composio.dev et créer un compte avec son Gmail personnel (le courrier universitaire peut bloquer l'autorisation). Le plan gratuit ne demande pas de carte bancaire.
- Dans le tableau de bord, ouvrir AI Clients et copier sa consumer API key.
Ne lui demande pas de coller la clé dans le chat. Ce qui est saisi ici peut rester dans l'historique.
Étape 2 · Sauvegarder la clé sur son ordinateur
La clé doit être placée dans une variable d'environnement, en dehors du dépôt. Donne-lui la commande adaptée à son système et demande-lui de l'exécuter dans un autre terminal :
# macOS / Linux (zsh) ; en bash utilise ~/.bashrc
echo 'export COMPOSIO_CONSUMER_KEY="colle-ta-clé-ici"' >> ~/.zshrc && source ~/.zshrc
# Windows (PowerShell)
setx COMPOSIO_CONSUMER_KEY "colle-ta-clé-ici"
Sous Windows, setx ne s'applique qu'aux nouveaux terminaux : il faut fermer et rouvrir le terminal.
Étape 3 · Activer Composio
Demande la permission et modifie dans opencode.json le bloc mcp.composio pour mettre "enabled": true. Ne modifie rien d'autre.
Ensuite, demande-lui de fermer OpenCode et de le rouvrir dans ce dossier, depuis un nouveau terminal, puis d'exécuter :
opencode mcp list
Composio doit apparaître comme connecté. Si ce n'est pas le cas :
opencode mcp debug composioaffiche l'erreur.- Si le message indique qu'il manque la clé, c'est que la variable n'est pas passée dans ce terminal : répète l'étape 2 et ouvre un nouveau terminal.
Étape 4 · Connecter la première application
Quand l'utilisateur est de retour, demande-lui quelle application il souhaite connecter en premier (suggère Google Calendar). Utilise l'outil Composio qui gère les connexions pour générer le lien d'autorisation, donne-le-lui, et attends qu'il autorise dans le navigateur et revienne au chat.
Vérifie avec une simple lecture : les événements du jour, ou les trois derniers sujets de courrier. Montre-lui le résultat.
Si le temps le permet, répète avec une deuxième application.
Étape 5 · Enregistrer
Crée ou met à jour memory/wiki/conexiones.md avec : quelles applications sont connectées, la date et à quoi elles servent. Sans clés ni adresses e-mail. Fais un lien depuis memory/index.md.
Termine par : « Essaie /brief pour voir ta journée. »
Plan B · sans MCP
Si le MCP ne se connecte pas, la CLI Composio fonctionne tout aussi bien :
curl -fsSL https://composio.dev/install | sh # puis ouvre un nouveau terminal
composio login # si rien ne se passe : composio logout puis composio login --no-wait
composio link googlecalendar
composio search "list today's calendar events"
composio execute <SLUG> --dry-run -d '{...}'
Règles
- Lire avant d'écrire. Pour vérifier une connexion, uniquement des lectures.
- N'exécute jamais une action qui envoie, crée, met à jour ou supprime quoi que ce soit sans que l'utilisateur ne l'approuve explicitement, même si OpenCode te demande déjà la permission.
- N'écris jamais de clés dans les fichiers du dépôt. Si l'utilisateur en colle une dans le chat, dis-lui de la regénérer dans le tableau de bord.
- Si quelque chose échoue deux fois, arrête-toi, explique ce qui a échoué et propose le plan B. N'improvise pas de modifications dans la configuration.