Connecter un assistant en MCP
Lier un assistant à votre organisation et vérifier ses accès.
Connexion personnelle par OAuth#
Chaque personne copie l'URL du connecteur depuis Réglages, Assistant IA. Elle ressemble à https://votre-organisation.exemple.fr/api/mcp. Utilisez l'hôte de votre organisation, pas l'hôte global de connexion.
- Dans votre client compatible MCP distant et OAuth, ajoutez un serveur HTTP avec cette URL.
- Lancez la connexion proposée par le client.
- Connectez-vous à Cercla dans le navigateur ouvert.
- Examinez le client destinataire et les accès demandés sur l'écran de consentement.
- Accordez seulement les accès nécessaires, puis revenez à l'assistant.
- Demandez-lui de charger le contexte avant de travailler.
Les menus du client et la disponibilité des connecteurs dépendent de sa version et de son abonnement. Le pas-à-pas affiché dans Cercla donne le point de départ ; la donnée stable à fournir est l'URL du MCP de l'organisation.
Ce que l'assistant peut voir#
Une connexion personnelle utilise vos droits et votre visibilité, intersectés avec les accès consentis. Les écritures vous sont attribuées. L'accès en lecture ne donne pas implicitement l'écriture et les actions administratives restent soumises à leurs gardes.
Le contexte chargé par l'assistant porte la carte de ses capacités : par domaine, ce qu'il peut lire ou modifier et, pour chaque refus, la cause et le remède. Un accès non coché au consentement se coche en reconnectant le client ; un geste que votre profil ne permet pas demande un administrateur. Le serveur propose aussi des parcours prêts (prompts), chacun avec ses points d'arrêt où l'assistant attend votre réponse.
Le nom déclaré par un client n'est pas une preuve d'identité. Vérifiez l'hôte destinataire affiché, particulièrement lorsque le client est signalé non vérifié.
Trois premières demandes#
- « Qu'est-ce que je peux faire ici ? »
- « Charge le contexte Cercla et indique mon périmètre et les actions ouvertes. »
- « Retrouve les devis visibles qui attendent une relance et explique les critères utilisés. »
- « Prépare une tâche de suivi pour ce dossier, avec le rattachement et la date à vérifier. »
Avant une création, demandez à l'assistant de rechercher l'existant et de présenter le client et les valeurs visés. Les approbations restent nécessaires pour certaines actions.
Connexion machine#
Une app connectée peut appeler le même endpoint avec Authorization: Bearer sat_.... Les scopes et le périmètre sont ceux de l'app, et les écritures sont attribuées à son utilisateur d'intégration. Obtenez le jeton via le flux client credentials et renouvelez-le à expiration.
Ne stockez pas un jeton d'une heure comme s'il s'agissait d'une clé permanente.
Retirer l'accès#
Dans Réglages, Assistant IA, consultez les connexions puis révoquez celle à retirer. L'administrateur peut consulter celles de l'organisation. La révocation est prise en compte lors des appels suivants.