Aller au contenu
Documentation

Serveur MCP (connectez votre assistant IA)

CHAMPREP héberge un Protocole de contexte de modèle serveur (MCP). Connectez-le à n’importe quel client d’IA compatible MCP — Claude (claude.ai et version de bureau), ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf et autres — et votre assistant pourra agir sur votre CHAMPREP compte : répertoriez et réservez des événements dans votre agenda, lisez et rédigez des e-mails, gérez des tableaux de travail, effectuez des recherches sur votre disque dur, créez des factures, des notes, des documents et des feuilles de calcul, et bien plus encore, le tout par conversation.

:::attention[Point de terminaison mis à jour : utilisez /mcp/v1] Le point de terminaison est désormais versionné. Connectez-vous à https://ai-api.champrep.com/mcp/v1. L’ancien point de terminaison sans version https://ai-api.champrep.com/mcp est retiré — les requêtes adressées à celui-ci sont refusées avec un message vous invitant à effectuer la transition. Si votre client pointe toujours vers /mcp, modifiez l’URL pour /mcp/v1 (Les utilisateurs de npm-bridge sur npx -y @champrep/mcp détecteront automatiquement le nouveau point de terminaison lors de leur prochaine exécution). :::

Il n’y a rien à installer pour les clients modernes. Le serveur est hébergé à l’adresse suivante :

https://ai-api.champrep.com/mcp/v1

Le raisonnement de l’assistant s’exécute dans votre client IA avec le modèle de votre client — CHAMPREP les appels MCP ne consomment aucun de vos CHAMPREP AI crédits. Chaque appel d’outil est exécuté sous votre propre identité et est soumis à votre forfait, aux politiques de votre organisation et (pour les APIclés) aux périmètres que vous avez choisis.

Il existe deux façons de se connecter. Les deux sont entièrement prises en charge — choisissez en fonction de la situation :

Connexion via le navigateur (OAuth)API clé
Idéal pourPersonnes utilisant une application d’IA de manière interactiveScripts, CI, serveurs, outils sans interface graphique
ConfigurationCollez l’URL ; validez dans votre navigateurCréez une clé une seule fois ; collez-la dans le fichier de configuration
Éléments confidentiels à gérerAucune — aucune clé n’intervient jamais dans la configuration du clientVous stockez le cpk_… clé dans la configuration du client
Étendue des droits d’accèsL’accès complet à votre compte (comme si vous étiez connecté)Seul le portées vous accordez à la clé (par exemple, uniquement calendar:read)
Fonctionne dansclaude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor, VS Code, WindsurfTout, y compris les clients ne disposant pas de navigateur
ExpirationLes sessions sont actualisées automatiquement ; vous pouvez les révoquer à tout momentDate d’expiration facultative ; révocation possible à tout moment
Révoquer depuisDéconnectez-vous dans le clientCompte → APIClés sur champrep.com

Règle générale : Si une personne se trouve devant le client, utilisez la connexion via le navigateur. S’il s’agit d’une machine, utilisez une cléAPI API dont les périmètres d’accès sont les plus restreints possibles tout en permettant d’effectuer la tâche requise.

Option A : connexion via votre navigateur (recommandée)

Section intitulée « Option A : connexion via votre navigateur (recommandée) »

Ajoutez l’URL du serveur avec aucune clé ni aucun en-tête. Votre client détecte automatiquement le CHAMPREPflux de connexion (OAuth 2.1 avec enregistrement dynamique), ouvre votre navigateur sur une page de consentementCHAMPREP et établit la connexion une fois que vous avez donné votre accord. Si vous êtes déjà connecté à CHAMPREPdans ce navigateur, vous accédez directement à l’ écran d’approbation ; si vous êtes connecté à plusieurs CHAMPREPcomptes, vous choisissez celui auquel vous souhaitez vous connecter.

  1. Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
  2. Collez https://ai-api.champrep.com/mcp/v1 puis enregistrez.
  3. Votre navigateur ouvre la page de consentementCHAMPREP — vérifiez les informations et cliquez sur Autoriser.
  4. Dans n’importe quelle conversation, activez le CHAMPREPconnecteur depuis le menu des outils et posez simplement la question : « Vérifiez si ma messagerieCHAMPREP contient des messages non lus. »

Les connecteurs nécessitent un forfait ChatGPT avec mode développeur (Paramètres → Connecteurs → Avancé → Mode développeur).

  1. Paramètres → Connecteurs → Créer (ou Ajouter un connecteur).
  2. Donnez-lui un nom CHAMPREP, définissez l’URL du serveur MCP sur https://ai-api.champrep.com/mcp/v1, choisissez OAuth authentification, puis enregistrez.
  3. Validez la page de consentementCHAMPREP lorsque le navigateur s’ouvre.
Fenêtre de terminal
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1

Exécutez ensuite /mcp, sélectionnez champrep, puis choisissez Authentifiez-vous — votre navigateur ouvre la page de consentement.

Paramètres → MCP → Ajouter un nouveau serveur MCP, ou ajoutez à ~/.cursor/mcp.json:

{
"mcpServers": {
"champrep": { "url": "https://ai-api.champrep.com/mcp/v1" }
}
}

Lorsque Cursor signale que le serveur nécessite une authentification, suivez les instructions de connexion.

Ajoutez un serveur MCP HTTP avec son URL https://ai-api.champrep.com/mcp/v1 dans les paramètres MCP du client. Les deux prennent en charge le flux OAuth : la première connexion ouvre la page de consentementCHAMPREP.

  1. Connectez-vous sur champrep.com et ouvrez Compte → APIClés.
  2. Créez une clé et sélectionnez ses portées — ces paramètres déterminent les outils que l’ assistant peut utiliser. calendar:read affiche les outils de calendrier en lecture seule ; calendar:write cela expose également les outils qui créent ou modifient des événements. N’autorisez que les services auxquels vous souhaitez donner accès.
  3. Copiez la clé (cpk_live_…). Il s’affiche une seule fois.

Code Claude :

Fenêtre de terminal
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \
--header "Authorization: Bearer cpk_live_YOUR_KEY"

Curseur / VS Code / Windsurf (mcp.json(configuration de type) :

{
"mcpServers": {
"champrep": {
"url": "https://ai-api.champrep.com/mcp/v1",
"headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" }
}
}
}

Codex CLI (~/.codex/config.toml) — Codex communique avec les serveurs stdio ; utilisez donc le paquet bridge :

[mcp_servers.champrep]
command = "npx"
args = ["-y", "@champrep/mcp"]
env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }

Claude Desktop (configuration stdio) et autres clients stdio uniquement — le @champrep/mcp bridge redirige un serveur stdio local vers le point de terminaison hébergé :

{
"mcpServers": {
"champrep": {
"command": "npx",
"args": ["-y", "@champrep/mcp"],
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" }
}
}
}

Si CHAMPREP_API_KEY est manquant, le pont ouvre votre navigateur sur la page «API Clés » et affiche des instructions au lieu d’échouer silencieusement.

HTTP brut (pour vos propres intégrations — JSON-RPC 2.0 brut). Transmettez la clé à partir d’une variable d’environnement plutôt qu’en ligne, afin qu’elle ne figure pas dans l’historique de votre shell :

Fenêtre de terminal
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \
-H "Authorization: Bearer $CHAMPREP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Votre client MCP détermine si, quand et comment il vous demande de confirmer un appel d’outil . Le Recommandations relatives à l’interaction avec l’utilisateur dans la spécification MCP recommande une supervision humaine et des demandes de confirmation, mais n’impose pas de modèle d’interaction particulier. L’affichage d’une demande de confirmation dépend du client et de ses paramètres, y compris des autorisations mémorisées ou des règles d’approbation automatique.

CHAMPREP fournit des annotations d’outils pour aider les clients à évaluer chaque opération :

  • Outils en lecture seule (répertorier les événements, rechercher des e-mails, lire des notes…) ont readOnlyHint: true.
  • Outils qui modifient des éléments (envoyer des e-mails, créer des événements, télécharger des fichiers…) ont readOnlyHint: false.
  • Outils destructeurs ont destructiveHint: true et reste masqué sauf si l’accès destructif est activé (section suivante).

Les annotations des outils décrivent leur comportement. Elles n’imposent pas de boîte de dialogue de confirmation ni ne garantissent l’affichage d’une invite avant chaque appel, même pour les outils destructifs. Vérifiez les paramètres d’autorisation de votre client avant d’autoriser toute modification.

Pour les actions MCP courantes, CHAMPREPs’appuie sur la gestion du consentement du client plutôt que d’exiger une deuxième carte d’approbationCHAMPREP. Le serveur ne vérifie pas de manière indépendante si le client a affiché une demande de confirmation.

CHAMPREP applique toujours les restrictions de connexion, les champs d’application des APIclés applicables, l’autorisation de service, les politiques d’organisation et les limites de débit. Les actions acheminées via l’exécuteur d’actions CHAMPREPde sont également soumises à des contrôles de sécurité et sont enregistrées dans votre compte Journal d’activité, avec Annuler lorsque cela est pris en charge. Le consentement du client ne peut pas passer outre un refus côté serveur ou une approbation requise par l’organisation ; les actions nécessitant une approbation CHAMPREPspécifique peuvent être refusées via MCP.

Activation des outils destructifs (activation facultative)

Section intitulée « Activation des outils destructifs (activation facultative) »

Par défaut, le serveur masque les outils qui suppriment ou effacent définitivement des données — suppression de dossiers sur le disque, purge de notes, suppression d’enregistrements, etc. Si vous avez un véritable nettoyage à effectuer et que vous souhaitez l’aide de votre assistant, la connexion doit autoriser les actions destructrices et le client doit les demander en ajoutant ?destructive=true à l’URL du serveur :

https://ai-api.champrep.com/mcp/v1?destructive=true

Utilisez cette URL partout où une URL est acceptée (connecteur claude.ai, Claude Code, Cursor, ChatGPT). Pour le pont stdio, définissez plutôt une variable d’environnement :

"env": {
"CHAMPREP_API_KEY": "cpk_live_YOUR_KEY",
"CHAMPREP_ENABLE_DESTRUCTIVE": "true"
}

Le paramètre « URL flag » ou « bridge » ne remplace pas à lui seul les autorisations de la connexion. Une connexion en lecture seule, un service interdit ou un accès destructeur désactivé empêchent toujours l’outil d’être disponible.

Vous êtes responsable de l’utilisation que votre assistant fait de ces outils. Les données supprimées peuvent ne pas être récupérables. Les outils destructifs nécessitent toujours les champs d’application de clé APIappropriés, tels que ceux d’un service :write champ d’application ou son champ d’application de suppression distinct le cas échéant. Elles conservent toujours destructiveHint, mais l’affichage d’une invite de confirmation dépend de votre client et de sa configuration. Les vérifications côté serveur et l’audit des actions décrits ci-dessus s’appliquent toujours. Certaines actions destructrices prennent en charge Annuler depuis la page « Activité » de votre compte — mais considérez chaque suppression comme définitive.

Indépendamment de ce paramètre, certains éléments sont jamais Disponible via MCP : les opérations administratives, les outils d’exécution de code et la suppression de compte. Les seules exceptions à la règle d’exécution de code sont le lancement d’une version préliminaire QA ou d’une session QA Cloud IDE : toutes deux s’exécutent dans le bac à sable isolé de QA, après votre validation (voir MCP pour Code, CI, Runner Farm et QA).

Les outils couvrent l’ensemble de la plateforme, toujours sous la forme de vous: Calendar (événements, réservations, disponibilité), Mail (lecture, recherche, brouillon, envoi, libellés, règles), Drive (recherche, fichiers, dossiers, partage), Notes, Meetings (calendrier, résumés, enregistrements), Work (tableaux, tickets), Docs (documents, commentaires, suggestions de modification, versions, exportation), Feuilles de calcul (classeurs, plages, formules, mise en forme, validation, mise en forme conditionnelle, protection, commentaires, versions, exportation), Factures, Forms, Contacts, Graphiques, CHAMPREP Code, Ferme de runners, Assurance qualité et Learn. Les outils qui s’affichent dépendent précisément de votre forfait, des politiques de votre organisation, de vos autorisations d’IA par service et (pour les APIclés) des champs d’application de la clé.

Pour CHAMPREP Code (projets, plans de clonage, pipelines, journaux de tâches, runners), Runner Farm et QA, consultez MCP pour Code, CI, Runner Farm et QA: ce que l’assistant peut faire, des exemples de requêtes, ce qui nécessite votre validation et ce qui reste dans les applications web.

Commencez par essayer les solutions suivantes :

  • « Qu’y a-t-il dans mon CHAMPREPagenda cette semaine ? »
  • « Ai-je des e-mails non lus ? Résumez tout ce qui est important. »
  • « Trouvez les contrats au format PDF de ce mois-ci dans mon Drive. »
  • « Créez un ticket de travail intitulé « Renouveler les certificats SSL » sur mon tableau Ops. »
  • « Créez un document Docs intitulé « Plan T4 » comportant des sections consacrées aux objectifs, aux risques et aux responsables. »
  • « Dans mon classeur « Budget mensuel », mettez en surbrillance toutes les dépenses supérieures à 500. »

Outre les outils de services cloud, le CHAMPREP pour l’extension Chrome peut connecter votre propre navigateur à Eve :

  • Activer Autorisez Eve à utiliser ce navigateur dans les paramètres de l’extension.
  • Eve permet de discuter sur le Web, dans l’application de bureau, dans Eve AI pour VS Code, et dans l’agent de terminal (eve / champrep ai) peut alors lire l’onglet actif, répertorier les onglets et capturer des captures d’écran, puis, après que vous ayez approuvé chaque action, naviguer, cliquer ou remplir un champ.
  • Eve n’intervient jamais sur les sites de messagerie, bancaires, de paiement ou de connexion, et ne saisit jamais de mot de passe, de code à usage unique ou de données de carte bancaire.

  • API clés — consulter, définir le champ d’application, expirer et révoquer sous Compte → APIClés. La révocation prend effet immédiatement.
  • Connexions via le navigateur — Déconnectez le connecteur au sein du client IA. Vous pouvez également vous déconnecter CHAMPREPde ce navigateur ; aucun nouveau jeton ne pourra alors plus être émis pour celui-ci.
  • Toute action agentique apparaît dans votre compte Journal d’activité avec les informations sur ce qui a été exécuté, quand et d’où — et la fonction « Annuler » lorsqu’elle est prise en charge.

  • 120 requêtes MCP par minute et par identité. Pour une automatisation plus poussée, il convient d’utiliser la développeur API avec des clés de portée « service ».
  • Les appels de l’outil sont soumis aux mêmes quotas par forfait que le reste de votre compte — un assistant ne peut pas dépasser ce que vous pouvez faire vous-même.

SymptômeCause probable et solution
Le client indique que l’authentification est requise et rien ne s’ouvreIl se peut que votre client ne prenne pas en charge MCP OAuth — utilisez une cléAPI (Option B).
Invalid API keyLa clé a été révoquée, a expiré ou a été mal saisie. Créez-en une nouvelle dans Compte → APIClés.
Unknown or unavailable toolL’outil se trouve en dehors des champs d’application de votre clé, est désactivé par vos autorisations d’IA ou de connexion, ou est destructeur sans à la fois l’autorisation de connexion et le ?destructive=true consentement explicite.
Un outil s’exécute sans demande de confirmationL’affichage des invites est contrôlé par votre client MCP et ses paramètres d’approbation. Les annotations d’outils, y compris destructiveHint, ne garantissent pas l’affichage d’une invite. Vérifiez les autorisations enregistrées et les règles d’approbation automatique dans ce client.
Un outil d’écriture est refusé avec un message de limiteLes contrôles côté CHAMPREPserveur (limites quotidiennes, protection contre les abus) l’ont refusée — le message en explique la raison. Veuillez réessayer plus tard ou réduire le volume.
La page de consentement affiche le message « Session expirée »L’autorisation est restée inactive trop longtemps. Relancez la procédure de connexion depuis le client.
Cela fonctionne lors d’un test dans le navigateur, mais pas depuis un serveur/CI Cela fonctionne lors d’un test dans le navigateur, mais pas depuis un serveur/CIUtilisez une cléAPI — la connexion via le navigateur ne génère des jetons qu’en mode interactif.
429 RéponsesVous avez atteint le plafond par minute ; veuillez patienter un moment puis réessayer.

Point de terminaison : https://ai-api.champrep.com/mcp/v1.