Brancher un outil ia

Clé d'API ou connexion IA : laquelle choisir ?

La question se tranche en une phrase : qui appelle ? Un assistant qui converse avec vous — Claude Desktop, un autre client MCP — passe par la connexion IA. Un programme que vous écrivez ou paramétrez — une automatisation n8n, un script, un tableau de bord maison — utilise une clé d'API. Où trouver cet écran — Menu latéral → Accès API pour vos clés, Clés d'agent pour les assistants connectés. Ce qui les distingue vraiment | | Connexion IA | Clé d'API | | --- | --- | --- | | Qui l'obtient | L'assistant, en vous demandant votre accord | Vous, en la créant | | Comment | Un écran de consentement où vous cochez | Un formulaire où vous choisissez la portée | | Ce qui est accordé | Des capacités, action par action | Une portée de permissions | | Durée | Expire | Jusqu'à révocation | | Où la retrouver | Clés d'agent | Accès API | La différence de fond : la connexion IA accorde des actions nommées — « Audit (13) », « Contenu (14) » — que vous avez vues et cochées une par une. La clé d'API accorde une portée, plus large par nature, parce qu'un programme fait rarement une seule chose. La règle qui protège les deux Ni l'une ni l'autre ne peut faire plus que vous. Pour la connexion IA, c'est vérifié au moment où vous accordez : vous ne pouvez ouvrir que des capacités que vous détenez, et le rôle qui en découle ne peut pas dépasser le vôtre. Pour la clé d'API, c'est vérifié à chaque appel : la portée déclarée est recoupée avec vos permissions du moment. Une portée trop large est simplement rétrécie au passage. Et si vous perdez une permission, la clé la perd aussi — immédiatement, sans qu'il y ait rien à faire. En cas de doute Prenez la connexion IA. Elle est plus étroite, elle expire d'elle-même, et elle vous montre exactement ce que vous ouvrez avant de l'ouvrir. La clé d'API se justifie quand aucun humain n'est devant l'écran. Et ne créez jamais un accès « au cas où » : les deux se réaccordent en quelques secondes, alors qu'un accès oublié dure des mois. Ce que vous pouvez faire 1. Demandez-vous qui appelle : un assistant, ou un programme. 2. Préférez la connexion IA quand les deux conviennent. 3. Choisissez la portée la plus étroite qui fait le travail. 4. Notez pourquoi vous créez une clé — c'est ce qui permettra de la révoquer sans hésiter plus tard. Voir aussi - Voir les accès accordés, et en révoquer un - Connecter Claude Desktop à vos données - Quels rôles existent, et qui peut quoi ?

Voir les accès accordés, et en révoquer un

Deux écrans, deux natures d'accès. Les confondre fait chercher au mauvais endroit ce qu'on veut couper. Clés d'agent — ce que vous avez autorisé en connectant un assistant, Claude Desktop ou un autre client MCP. L'accès a été accordé par une cérémonie d'autorisation, écran de consentement à l'appui. Accès API — les clés que vous avez créées vous-même pour vos propres outils et automatisations. Les deux se révoquent au même endroit que celui où on les consulte, et l'effet est immédiat. Où trouver cet écran — Menu latéral → Accès API pour vos clés, Clés d'agent pour les assistants connectés. Les clés d'agent : ce que l'assistant a le droit de faire Le tableau « Clés d'agent » : deux lignes « OAuth — Claude Code », avec leur date de création, le périmètre projet « Digitalyser.io », les familles de capacités accordées — Audit (13), Contenu (14), Stratégie éditoriale (3), +4 — l'expiration, le statut « Active » et l'action « Révoquer ». Chaque ligne vous dit exactement ce qui a été accordé : Périmètre projet — sur quel projet l'agent peut travailler. Un accès accordé sur un projet ne donne rien sur les autres. Capacités — regroupées par famille, avec leur nombre. « Audit (13) » signifie treize actions du domaine audit. Le compte est ce qui compte : c'est la mesure de ce que vous avez ouvert. Expiration — une clé d'agent a une date de fin. Passée cette date, l'assistant devra redemander votre accord. La garantie qui compte Un accès ne peut jamais dépasser la personne qui l'a accordé. Deux bornes, vérifiées au moment du consentement : - vous ne pouvez accorder que des capacités que vous détenez vous-même ; - le rôle qui en découle ne peut pas dépasser votre propre rôle. Autrement dit, connecter un assistant n'ouvre aucune porte que vous n'aviez pas déjà. Et si votre offre ne comprend pas une capacité, elle n'est accordable par personne. Les clés d'API : ce que vos outils peuvent faire L'écran « Accès API » : une clé « n8n Integration » avec sa description, sa date de création, une étiquette orange « Portée héritée — à re-scoper », la mention « Jamais utilisée », son statut « Active » et l'action « Révoquer ». Chaque clé porte la portée choisie à son émission. La colonne Dernier usage est votre meilleur signal de ménage : une clé « Jamais utilisée » créée il y a des mois n'a aucune raison de rester active. Une clé plus ancienne que le système de portées affiche « Portée héritée — à re-scoper » : elle fonctionne, mais son périmètre n'a jamais été précisé. Recréez-la avec la portée qui convient, puis révoquez l'ancienne. Révoquer Le bouton Révoquer est au bout de la ligne, sur les deux écrans. La révocation prend effet immédiatement : l'outil concerné perd l'accès à son prochain appel. Révoquez sans hésiter — un accès se réaccorde en quelques secondes, alors qu'un accès oublié dure des mois. Ce que vous pouvez faire 1. Passez les deux écrans en revue de temps en temps : agents d'un côté, clés d'API de l'autre. 2. Regardez la colonne « Dernier usage » : jamais utilisée, jamais nécessaire. 3. Traitez les portées héritées : recréez, puis révoquez. 4. Révoquez au moindre doute — c'est réversible, l'oubli ne l'est pas. Voir aussi - Quels rôles existent, et qui peut quoi ? - Connecter Claude Desktop à vos données - Sécuriser votre compte

Ce qu'un outil connecté peut faire — et ce qu'il ne peut pas

Quand un assistant demande à se connecter à votre espace, l'écran de consentement vous montre la liste exacte de ce qu'il pourra faire. La règle tient en une phrase, écrite sur l'écran lui-même : l'agent ne pourra faire que ce que vous cochez. Rien ne s'ajoutera ensuite sans repasser par vous. Où trouver cet écran — Cet écran ne s'ouvre pas depuis le menu : c'est l'outil que vous connectez qui vous y amène, dans votre navigateur, au moment de la demande d'autorisation. Ce que vous accordez : des actions, pas un accès global La section « Capacités accordées » de l'écran de consentement : la phrase « L'agent ne pourra faire que ce que vous cochez — rien ne s'ajoutera sans repasser par vous », un champ de recherche avec le compteur « 0 / 43 », et la famille « Audit 0/14 » dépliée montrant deux capacités avec leur description complète et l'étiquette audit:read. Chaque ligne est une action nommée, avec sa description entière et une étiquette technique — audit:read — qui dit à quel domaine elle appartient et si elle lit ou écrit. Elles sont regroupées par famille, avec un compteur : « Audit 0/14 » signifie zéro coché sur quatorze disponibles. Le compteur du haut fait la somme : 0 / 43. Prenez le temps de lire les descriptions : elles disent précisément ce qui sera consulté. « Résultats du dernier audit de visibilité locale du projet : fiche Google Business, citations locales, avis, cohérence NAP… » — c'est ça que vous autorisez, pas « l'audit » en général. Un projet à la fois Un agent connecté n'accède qu'à un seul projet. Le sélecteur en haut de l'écran vous le fait choisir, et l'accès s'arrête là : si vous suivez trois marques, il vous faut trois connexions, et chacune ignore les deux autres. Ce qu'un outil connecté ne peut jamais faire Plus que vous. C'est vérifié au moment où vous accordez, sur deux plans : - vous ne pouvez ouvrir que des capacités que vous détenez vous-même ; - le niveau d'accès qui en découle ne peut pas dépasser votre propre rôle. Si votre offre ne comprend pas une capacité, elle n'est accordable par personne — ni par vous, ni par un administrateur. Agir sans repasser par l'écran. Une capacité non cochée reste fermée. Pour en ajouter une, l'assistant doit redemander votre accord. Rester connecté indéfiniment. Une connexion a une date d'expiration, et vous pouvez la révoquer à tout moment. Ce que vous pouvez faire 1. Lisez les descriptions, pas seulement les noms de famille. 2. Regardez le compteur avant d'autoriser : il dit combien d'actions vous ouvrez. 3. Une connexion par projet — c'est la limite, pas un réglage. 4. En cas de doute, refusez : l'assistant vous le redemandera, et vous n'aurez rien perdu. Voir aussi - Choisir le bon niveau d'accès - Voir les accès accordés, et en révoquer un - Connecter Claude Desktop à vos données

Choisir le bon niveau d'accès

Cocher quarante-trois capacités une par une n'est raisonnable pour personne. L'écran propose donc trois raccourcis, du plus étroit au plus large. Où trouver cet écran — Cet écran ne s'ouvre pas depuis le menu : c'est l'outil que vous connectez qui vous y amène, dans votre navigateur, au moment de la demande d'autorisation. Les trois niveaux d'accès de l'écran de consentement — « Lecture seule », « Optimisation de contenu », « Boucle complète » — suivis de l'étiquette « Personnalisé » en pointillés, d'un champ de recherche et du compteur « 0 / 43 ». Les trois niveaux Lecture seule — l'agent consulte, jamais il ne modifie. Vos audits, vos scores, vos contenus existants : il peut tout lire et tout expliquer, mais rien changer. C'est le bon choix par défaut, et le seul qui ne demande aucune confiance particulière. Optimisation de contenu — la lecture, plus l'écriture sur la sphère éditoriale : contenus, stratégie, voix de marque, personas, clusters. L'agent peut proposer et appliquer sur ces domaines-là. Le reste — audits, organisation, accès — reste en lecture. Boucle complète — tout ce qui vous est accordable. À réserver aux outils que vous avez construits ou choisis en connaissance de cause. Un raccourci, pas une case à part Un niveau remplit la sélection ; il ne la remplace pas par une règle floue. Cliquer « Lecture seule » coche les capacités de lecture, une par une, et vous restez libre d'ajuster ensuite. C'est pour ça que l'étiquette « Personnalisé » apparaît dès que vous touchez une case : la sélection ne correspond plus exactement à un niveau, donc aucun ne prétend plus la décrire. C'est honnête — mieux vaut « personnalisé » qu'un nom qui ne dirait plus la vérité. Et le nom du niveau n'est jamais transmis : ce qui part, c'est la liste finale des cases cochées. Le serveur revérifie chacune de son côté. Comment choisir en dix secondes 1. L'assistant doit-il écrire quelque chose ? Si non → Lecture seule, et c'est fini. 2. Si oui, doit-il écrire ailleurs que sur vos contenus ? Si non → Optimisation de contenu. 3. Sinon → Boucle complète, en sachant ce que ça ouvre. Dans le doute, prenez le niveau en dessous : ajouter une capacité plus tard prend quelques secondes, et l'assistant vous le redemandera de lui-même s'il en a besoin. Ce que vous pouvez faire 1. Commencez par Lecture seule — vous verrez vite si ça suffit. 2. Vérifiez le compteur après avoir cliqué : il chiffre ce que le niveau a coché. 3. Ajustez case par case si un seul détail vous gêne ; l'étiquette passera à « Personnalisé ». 4. Ne prenez « Boucle complète » que pour un outil dont vous répondez. Voir aussi - Ce qu'un outil connecté peut faire — et ce qu'il ne peut pas - Voir les accès accordés, et en révoquer un - Clé d'API ou connexion IA : laquelle choisir ?

Créer une clé de service pour un usage automatisé

À retenir - Une clé de service s'utilise avec un en-tête technique, pas en vous connectant : elle est faite pour un programme, pas pour une personne. - Sa portée se choisit à la création, parmi les permissions que vous détenez vous-même — jamais plus large. - La clé en clair ne s'affiche qu'une seule fois, au moment de la création : copiez-la avant de quitter l'écran. - La portée ne se modifie pas après coup. Pour l'élargir ou la resserrer, révoquez la clé et recréez-en une. Où trouver cet écran — Menu latéral → Accès API. Une portée choisie à la création, jamais au-delà de la vôtre Créer une clé, c'est choisir une portée : la liste des permissions qu'elle emportera. L'écran ne vous propose que celles que vous détenez vous-même — impossible d'émettre une clé plus puissante que votre propre compte. Cette portée est figée dès la création. Ce n'est pas un oubli : changer la portée d'une clé déjà en circulation serait un changement d'autorisation invisible pour qui l'utilise. Si vos besoins changent, la marche à suivre est toujours la même : révoquer, puis recréer avec la nouvelle portée. Ce que vous réglez en la créant Le formulaire de création vous demande : - un nom, pour vous souvenir plus tard à quoi la clé sert ; - une description facultative ; - la portée : les permissions à accorder, cochées une par une ; - une date d'expiration facultative, au-delà de laquelle la clé cesse de fonctionner d'elle-même ; - une limite d'appels par heure, avec une valeur par défaut raisonnable pour un usage normal. La clé ne peut jamais dépasser vos droits du moment La portée déclarée à la création n'est qu'un plafond. À chaque appel, elle est recoupée avec vos permissions du moment, recalculées à chaque requête. Si vous perdez une permission après coup, la clé la perd aussitôt — sans qu'il y ait quoi que ce soit à faire sur la clé elle-même. Ce que vous pouvez faire 1. Ouvrez « Accès API » depuis le menu latéral et cliquez sur le bouton de création de clé. 2. Nommez-la clairement : une clé sans nom explicite est une clé qu'on n'ose plus révoquer plus tard, de peur de casser quelque chose. 3. Cochez la portée la plus étroite qui suffit au programme qui va l'utiliser — pas plus. 4. Copiez la clé affichée immédiatement : elle ne réapparaîtra plus jamais en clair, ni dans l'écran ni dans un e-mail. Questions fréquentes J'ai perdu ma clé : puis-je la revoir ? Non. Digitalyser.io ne conserve qu'une empreinte de la clé, pas sa valeur en clair — elle ne peut donc être ni retrouvée ni réaffichée. Révoquez la clé perdue et créez-en une nouvelle. Que se passe-t-il si on me retire une permission après avoir créé la clé ? Rien à faire de votre côté : la portée de la clé est recoupée avec vos permissions actuelles à chaque appel. La perte est répercutée immédiatement, à l'appel suivant. Puis-je élargir la portée d'une clé existante ? Non, la portée est immuable après création. Révoquez la clé et recréez-en une avec la portée qui convient désormais. Voir aussi - Clé d'API ou connexion IA : laquelle choisir ? - Voir les accès accordés, et en révoquer un - Quels rôles existent, et qui peut quoi ?

L'outil connecté ne voit pas mes données, ou son accès est refusé : pourquoi ?

À retenir - Le refus vient presque toujours d'un décalage entre ce que vous avez coché à la connexion et ce que l'outil demande maintenant — pas d'une panne. - Une connexion ne porte que sur un seul projet : demander les données d'un autre projet est refusé par construction, pas par erreur. - Si la connexion a expiré, a été révoquée, ou si le projet a été archivé, l'outil perd l'accès dès l'appel suivant. - Le geste qui répare la plupart des cas : ouvrez de nouveau l'écran de consentement depuis l'outil, et cochez ce qui manque. Où trouver cet écran — Menu latéral → Clés d'agent, pour voir le statut d'une connexion existante ; l'écran de consentement lui-même s'ouvre depuis l'outil que vous connectez, pas depuis le menu. La capacité demandée n'a jamais été cochée L'agent ne peut faire que ce que vous avez coché au moment de la connexion — rien ne s'ajoute ensuite sans repasser par l'écran de consentement. S'il vous répond qu'il ne peut pas lire une donnée, c'est le plus souvent qu'aucune case correspondante n'a été cochée, ou que votre propre compte ne détenait pas cette capacité ce jour-là. La connexion ne porte pas sur le bon projet Un agent connecté n'accède qu'à un seul projet, celui choisi à la connexion. S'il vous répond qu'il ne trouve pas des données, vérifiez d'abord qu'il s'agit bien du projet pour lequel vous l'avez autorisé : suivre trois marques demande trois connexions distinctes, chacune ignorant les deux autres. La connexion a expiré, a été révoquée, ou le projet a changé Trois situations coupent l'accès sans avertissement préalable, et le contrôle se refait à chaque appel, sans aucune mise en cache : - la connexion a atteint sa date d'expiration ; - elle a été révoquée, par vous ou un autre administrateur, depuis « Clés d'agent » ; - le projet visé a été archivé, ou vous avez perdu votre accès dessus. Dans les trois cas, l'outil découvre le refus à son prochain appel, sans délai de propagation. Ce que vous pouvez faire 1. Ouvrez « Clés d'agent » et vérifiez le statut de la connexion concernée : active, expirée, révoquée. 2. Vérifiez le projet sur lequel l'agent a été autorisé — c'est la cause la plus fréquente d'un « je ne trouve pas cette donnée ». 3. Reconnectez l'outil en repassant par l'écran de consentement, et cochez plus large si la capacité demandée manquait. 4. Si le refus persiste alors que tout semble correct, vérifiez que votre propre compte détient toujours la capacité en question : l'agent ne peut jamais faire plus que vous. Questions fréquentes Dois-je attendre un peu après avoir corrigé l'accès ? Non. Le contrôle se refait à chaque appel, sans mise en cache : dès que la connexion, le projet et vos droits sont en ordre, l'appel suivant de l'outil passe. Si je perds l'accès au projet, l'outil connecté le perd-il aussi ? Oui, immédiatement. L'accès de l'agent est revérifié à chaque appel : s'il ne trouve plus votre accès au projet, ou si l'offre de votre organisation ne couvre plus la capacité demandée, l'outil perd l'accès dès l'appel suivant, sans action de votre part. L'outil peut-il redemander une capacité que j'ai refusée ? Oui. Une capacité non cochée reste fermée, mais l'outil peut redemander votre accord à tout moment en vous renvoyant vers l'écran de consentement. Voir aussi - Ce qu'un outil connecté peut faire — et ce qu'il ne peut pas - Voir les accès accordés, et en révoquer un - Connecter Claude Desktop à vos données