Connecteurs
Connecteurs
Les connecteurs d'AIKeep : une carte par service, ses comptes dedans, l'écriture autorisée ou non, et chaque appel retrouvé au journal d'audit.
Un connecteur est un accès déclaré à un service externe. Il est rattaché au Dossier dans lequel il a été créé ; aucun autre Dossier ne le voit ni n'atteint ses secrets.

Ouvrir l'écran#
Chat → « Dossier · sources & mémoire » → onglet « Connecteurs — API et Modules »
Chaque service occupe une carte carrée, de même taille pour tous. Les services connectés sont en tête ; viennent ensuite ceux qu'on peut ajouter, puis les cartes « API personnalisée » et « MCP personnalisé ».
| Repère sur la carte | Sens |
|---|---|
| Pastille verte ✓ | Connexion réussie |
| Pastille orange ! | Une action est attendue : identifiant à saisir, accès à autoriser |
| Pastille rouge × | Le dernier test a échoué |
| Pastille bleue | Connecté, sans test global (navigateur, transfert, infra) |
| « Connecter » | Service proposé, pas encore branché |
Sous le nom, la carte dit ce qu'elle porte : l'état de la connexion, ou le nombre de comptes, de sites ou de serveurs.
Rechercher et filtrer#
| Élément | Effet |
|---|---|
| « Rechercher un connecteur » | Filtre en tapant, sur le nom du service et sur celui de chacun de ses comptes, sites ou serveurs |
| « Tous », « Connectés », « À connecter » | Limitent la grille à un état ; chaque bouton indique combien de cartes il montrerait |
| « Toutes les familles » et les familles | Limitent la grille à une famille de services |
Aucun nombre de cartes n'est limité.
Paramétrer un service#
Un clic sur une carte ouvre son paramétrage, dans un panneau sur la droite de l'écran. Il se ferme par « × », par un clic à côté du panneau ou par la touche Échap.
Le panneau reste ouvert après chaque enregistrement : on enchaîne les réglages sans le rouvrir.
Un service à plusieurs comptes#
Un service qui porte plusieurs comptes — plusieurs boîtes de messagerie, plusieurs accès à un portail — reste une seule carte. Son panneau liste les comptes ; un clic sur l'un d'eux ouvre son réglage. « + Ajouter un compte » en branche un de plus.
Pour le transfert de fichiers et la gestion d'infra, les comptes sont les sites et les serveurs : ils s'ajoutent par « + Ajouter un site » et « + Ajouter un serveur », et se suppriment par la croix « × » de leur ligne, après confirmation.
Un compte ajouté n'est ouvert à l'IA dans aucun workspace ni projet. Il se coche là où il doit servir : voir Sources → Choisir les comptes d'un connecteur.
Déclarer un service préconfiguré#
L'adresse, le mode d'authentification et le lien « Documentation » sont fournis par la carte.
- Cliquer la carte du service (repère « Connecter »).
- Saisir le ou les secrets demandés.
- « Connecter » suivi du nom du service.
Les services exigeant plusieurs champs — identifiant, domaine, clé — les présentent conjointement.
Déclarer une API arbitraire#
- Cliquer la carte « API personnalisée ».
- Renseigner l'adresse de base, le mode d'authentification et le secret.
- « Ajouter le connecteur ».
L'API déclarée devient sa propre carte. « Charger un fichier… », dans son panneau, accepte une spécification d'API. Fournie, elle remplace la découverte à l'aveugle des routes disponibles.
Éléments du paramétrage#
| Bouton | Effet |
|---|---|
| « Renommer cette brique » | Change le nom affiché |
| « 🔑 Identifiants » | Ressaisie du secret, validée par « Enregistrer » |
| « Logo… » | Associe une image locale au connecteur |
| « Tester l'API » | Émet un appel réel et affiche la réponse |
| « Supprimer » | Retire le connecteur et ses secrets, après confirmation |
Un secret enregistré n'est jamais réaffiché. Le panneau indique uniquement qu'il est défini.
En cas d'échec, le message de « Tester l'API » reprend la cause renvoyée par le service. Un refus de droits et un secret invalide ne se corrigent pas au même endroit ; le message désigne lequel des deux s'applique.
Autorisation d'écriture#
Chaque connecteur d'API porte un interrupteur d'écriture, coupé par défaut. Coupé, l'agent dispose d'un accès en lecture seule.
L'état est évalué à l'instant de l'appel, non au moment de l'affichage : la coupure prend effet immédiatement, y compris en cours de tour.
Journal d'audit#
Les modules infra et transfert tiennent un journal de toutes les opérations émises par l'agent, réussies comme échouées.
Accès#
Chat → « Dossier · sources & mémoire » → onglet « Connecteurs — API et Modules » → carte du service → « Journal d'audit »
L'écran est intitulé « Journal d'audit — » suivi du nom du connecteur.

Colonnes#
| Colonne | Contenu |
|---|---|
| Horodatage (UTC) | Instant de l'opération, en temps universel |
| Cible | Serveur ou site visé — local pour le poste lui-même |
| Opération | Commande ou action exécutée |
| Issue | OK, ou le code de retour en cas d'échec |
Sous chaque opération, « Sortie » déplie la réponse de la cible. Elle n'est pas une colonne : elle est repliée par défaut, une sortie de commande occupant plusieurs lignes.
Les entrées sont paginées de la plus récente à la plus ancienne ; « Plus anciennes → » remonte dans le temps.
Le journal survit à la suppression du connecteur. Retirer une carte n'efface pas la trace des opérations qu'elle a portées.
Le module de navigateur tient un journal de structure identique pour les actions menées dans une interface web.
Microsoft et Microsoft 365 sont des marques du groupe de sociétés Microsoft. AIKeep, édité par STEP BY STEP, est une solution indépendante : il n'est ni affilié, ni sponsorisé, ni certifié, ni approuvé par les titulaires de ces marques, et n'entretient avec eux aucun lien capitalistique ni de partenariat. Ces noms ne sont cités que pour désigner les services auxquels AIKeep se connecte ou qu'il utilise ; ils restent la propriété de leurs titulaires.