---
name: brancher-un-outil
description: "Brancher un outil (Google Agenda, Gmail, Google Drive, Notion, Outlook...) pour que l'assistant puisse lire et préparer dedans (« connecte mon agenda », « lis mes mails »). Passe par Composio, un connecteur unique déjà prévu dans le dossier, avec des droits limités et sans jamais demander de mot de passe dans la conversation."
---

# Brancher un outil

C'est le passage au niveau 4 : l'assistant ne se contente plus de ce qu'on lui colle, il lit directement dans les outils de la personne. On branche un seul outil à la fois, pour un besoin réel.

## 1. Partir de l'usage

Une question : « Qu'est-ce que tu voudrais que je fasse avec cet outil ? ». Un besoin vague (« connecter mon agenda ») devient un usage précis : « lire mes rendez-vous de la semaine et me préparer un planning ». C'est cet usage qui servira de test.

## 2. Le chemin par défaut : Composio

Le dossier contient déjà un connecteur nommé `composio` dans `opencode.json`, désactivé au départ. Composio gère pour la personne la connexion à plus de 1 000 services (Google Agenda, Gmail, Google Drive, Notion, Outlook…), sans aucune configuration technique côté Google ou Microsoft. Il est gratuit jusqu'à 100 000 actions par mois, largement assez pour un usage personnel.

Explique-le en deux phrases simples, puis, avec son accord :

### Première fois seulement

1. **Activer le connecteur** : dans `opencode.json`, passe `"disabled": true` à `"disabled": false` pour le serveur `composio` (section `mcp` > `servers`). Ne touche à rien d'autre.
2. **Faire relancer OpenCode** : dis clairement de fermer complètement OpenCode puis de le rouvrir sur le dossier, sinon le connecteur n'apparaît pas.
3. **Connecter Composio** : lance `opencode mcp auth composio`. Une page Composio s'ouvre dans le navigateur : la personne crée son compte gratuit (avec son adresse email ou son compte Google) et autorise l'accès. Attends que la commande affiche « Connected to composio ».

Si le connecteur est déjà actif et connecté (les outils `composio` sont disponibles), passe directement à l'étape suivante.

### Pour chaque service

4. **Brancher le service** : avec l'outil Composio de gestion des connexions (`COMPOSIO_MANAGE_CONNECTIONS`, action `add`, par exemple `googlecalendar`, `gmail`, `googledrive`, `notion`), obtiens le lien d'autorisation et donne-le tel quel, en précisant qu'il expire au bout de 10 minutes. La personne se connecte elle-même sur la page officielle du service.
5. **Vérifier** : une fois qu'elle a dit « c'est fait », vérifie que la connexion est active, puis fais le test de la partie 4.

## 3. Autres connecteurs (si Composio ne convient pas)

Certains services ont leur propre connecteur officiel (Notion par exemple). Il s'ajoute dans `opencode.json`, section `mcp` > `servers`, sans toucher au reste :

```
"mcp": {
  "servers": {
    "notion": { "type": "remote", "url": "https://mcp.notion.com/mcp" }
  }
}
```

Puis relance d'OpenCode et `opencode mcp auth <nom>`. Ne propose un connecteur que si tu as vérifié qu'il existe et qu'il est maintenu. Évite ceux qui demandent de créer un projet développeur (par exemple les connecteurs Google officiels, qui exigent une console Google Cloud) : passe par Composio.

## 4. Limiter les droits et tester

- Au départ, seulement **lire** et **préparer des brouillons**. Pas d'envoi, de suppression, de paiement, de partage ni de création d'événement. Écris cette règle dans `Moi.md`, section Mes réglages, avec la date. Elle pourra être élargie plus tard, sur demande explicite.
- Fais l'usage choisi sur une vraie donnée (par exemple, les rendez-vous de demain) et montre le résultat. Si ça ne marche pas, explique simplement ce qui bloque et propose une solution de repli : exporter les données ou les coller dans la conversation.

## 5. Garder une trace

Note dans `Moi.md`, section Mes réglages : le service branché, l'usage, les droits accordés, la date, et comment débrancher (retirer la connexion dans son compte Composio, ou remettre `"disabled": true` dans `opencode.json`).

## Règles

- Ne demande jamais de mot de passe, de clé ou de code dans la conversation. Les connexions se font toujours dans le navigateur, sur la page officielle.
- Ne présente jamais une connexion comme faite sans l'avoir vérifiée.
- Lire n'autorise pas agir : toute action dans un outil (envoyer, créer, supprimer) exige une demande explicite pour cette action précise.