Agents IA et MCP

Votre agent de programmation ou assistant IA peut travailler votre boîte de réception Campbooks exactement comme vous — en triant les e-mails, révisant les documents, confirmant les rappels, rédigeant des réponses pour votre approbation, et bien plus. Il le fait via MCP (Model Context Protocol), exposé à /api/mcp sur toute instance Campbooks.

Ce que ça permet

Connectez un agent compatible MCP — Claude Code, Cursor, Windsurf, OpenAI Codex CLI ou tout autre client — et il obtient accès à votre boîte de réception en langage naturel :

• Triage et skim — lit le jeu de skim, applique les décisions d'archivage/conservation cluster par cluster, et identifie les fils où une réponse de votre part est attendue.
• Documents — révise les factures et reçus en attente, les approuve ou les rejette, met à jour les champs extraits et archive des documents dans des dossiers.
• Tâches et rappels — confirme ou ignore les tâches et rappels extraits par l'IA ; crée des tâches à partir d'e-mails.
• Événements de calendrier — liste les événements à venir, crée des événements à partir du contexte d'un e-mail, répond aux invitations (RSVP).
• Contacts — recherche des contacts, met en favoris ceux qui comptent, bloque les expéditeurs indésirables.
• Rédiger avec confirmation — ébauche une réponse ou un nouvel e-mail, vous le montre d'abord et n'envoie qu'après un « oui » explicite de votre part.

Deux choses garantissent la sécurité : les scopes de la clé MCP limitent ce que l'agent peut faire (n'accordez emails:send que si vous voulez qu'il rédige), et les skills que nous fournissons demandent à l'agent de vous montrer chaque brouillon et de nommer chaque expéditeur avant un envoi, une suppression ou un blocage. Si vous connectez un autre agent, donnez-lui la même règle.

Comment c'est construit

Le serveur MCP à POST /api/mcp est une fine couche de protocole au-dessus de la même API REST publique qui alimente le CLI et les intégrations tierces. Cela signifie :

• Mêmes contrôles de permissions — la clé MCP porte les mêmes OAuth scopes que tout client d'API. Un agent avec emails:read peut lire les e-mails ; il ne peut pas en envoyer sans emails:send. Les permissions de boîte aux lettres de l'utilisateur s'appliquent toujours : un compte depuis lequel vous ne pouvez pas envoyer dans l'application, l'agent ne le peut pas non plus.
• Même règle 404-pas-403 — les ressources appartenant à un autre espace de travail renvoient 404, pas 403, afin que l'agent ne sache jamais si quelque chose existe en dehors de vos données.
• Conception à contexte minimal — le serveur expose deux outils que chaque client authentifié obtient gratuitement, quel que soit le scope : get_overview (un snapshot rapide de ce qui nécessite attention : e-mails non lus, documents en attente, rappels en retard, événements du jour) et guide (guides narratifs pour les flux de travail courants). Un agent devrait appeler get_overview en premier et lire un guide avant de continuer, pour limiter l'utilisation de tokens.

Les outils n'apparaissent dans tools/list que pour les scopes que possède une clé. Une clé de triage seul voit environ 15 outils ; une clé complète en voit 72.

Ce dont vous avez besoin

• Un compte Campbooks — Campbooks Cloud ou une instance auto-hébergée.
• Une clé MCP créée dans Paramètres → Accès à l'API. Contrairement aux tokens OAuth de courte durée (expiration en 2 heures), une clé MCP n'expire pas — elle est conçue pour les configurations d'agents statiques.

C'est tout. Pas d'inscription séparée, pas de service supplémentaire à faire tourner.

Prochaines étapes

• Plugin pour Claude Code — installation depuis le marketplace, les deux skills (/campbooks:setup, /campbooks:triage) et un parcours d'une session typique.
• Autres agents — configurations à copier-coller pour Cursor, Windsurf, OpenAI Codex CLI et Gemini CLI.
• Référence MCP — catalogue complet des outils, formes d'autorisation, scopes, limites de débit et garanties de sécurité.