Ressources · Connecteur Claude

Connecteur Claude PrefectCe que Claude sait faire dans tes workspaces Prefect.

Le connecteur Claude Prefect expose 15 outils : les 15 lisent, 0 n'écrit, 0 n'est laissé sans description. Ici : ce que Claude inspecte dans tes workspaces Prefect Cloud, pourquoi il s'arrête au diagnostic, ce qu'il demande, et qui peut le couper chez toi.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Aperçu

Ce que ça change de laisser Claude regarder dans Prefect

Quand un run échoue, la voie manuelle consiste à ouvrir l'interface Prefect, retrouver le run, faire défiler ses logs, puis vérifier le work pool et le déploiement. Avec ce connecteur, tu demandes à Claude pourquoi le run a échoué : il parcourt lui-même runs, logs, pools et événements avant de t'expliquer ce qu'il a trouvé. Prefect présente ses outils hébergés comme en lecture seule : Claude diagnostique, il ne répare pas.

Un échec expliqué en clair. Un run a fini en échec : get_flow_runs le repère, et get_flow_run_logs remonte ses entrées de log avec niveaux, horodatages et messages.

Des retards ramenés à leur cause. Les runs s'accumulent en retard : get_dashboard donne les statistiques, l'état des pools et les limites de concurrence actives, et get_work_pools renvoie le nom, le type, l'état et la limite de concurrence de chaque pool, un outil que Prefect juge essentiel quand des runs bloquent ou ne démarrent pas.

Des réponses tirées de la doc actuelle. Une question sur un concept Prefect se pose : docs_search_prefect fouille la documentation Prefect, et docs_get_release_notes vérifie ce qu'apporte une version donnée.

Maintenant, ce que la fiche du répertoire ne dit pas. Le guide de Prefect est net : créer ou mettre à jour une ressource passe par la CLI prefect ou le SDK, pas par ces outils. Le connecteur atteint les workspaces Prefect Cloud que tu coches à la connexion ; un serveur Prefect auto-hébergé relève d'une autre installation, documentée à part. Et rien ne tourne seul : aucun outil ne se déclenche quand un run échoue. Pour des alertes en arrière-plan, il te faut un outil d'automatisation, un autre métier ; la page Intégrations rassemble ce versant.

Vocabulaire

Le vocabulaire en une minute

Cinq mots que tu vas croiser en branchant Prefect.

Connecteur
Le lien que tu poses une fois entre Claude et un compte que tu as déjà, pour qu'il puisse y travailler pendant qu'il te répond.
Outil
Une action nommée que le connecteur ouvre à Claude dans ce compte. Il prend seul celles qu'il lui faut ; la fiche du répertoire les liste.
Autorisation
L'écran de connexion de Prefect Cloud, où tu choisis ce que Claude pourra atteindre. Donnée une fois par personne, reprise à volonté.
Approbation
La confirmation que Claude attend avant d'aller au bout d'une action, affichée dans la conversation au moment où elle compte.
MCP
Le standard commun des connecteurs : c'est lui qui permet à un assistant comme Claude de dialoguer avec un service extérieur.
Connexion

Brancher le connecteur Claude Prefect en trois étapes

  1. 01

    Retrouver Prefect dans Claude

    Dans les réglages de Claude, ouvre Customize puis Connectors et repère Prefect dans la liste. Sur un espace Team ou Enterprise, un Owner ou un Primary Owner active le connecteur avant que chaque membre puisse s'y connecter de son côté.

  2. 02

    Lancer le branchement

    Clique sur Connect depuis sa ligne, puis identifie-toi sur Prefect Cloud dans la fenêtre que le service ouvre lui-même. Si le lien casse plus tard, Disconnect puis rebranche.

  3. 03

    Relire l'écran d'autorisation

    Lis l'écran d'autorisation avant de valider. Il appartient à Prefect, pas à Claude, et c'est lui qui fixe jusqu'où va l'accès, y compris la liste des workspaces que Claude pourra consulter.

Outils

Les 15 outils, rangés selon ce qu'ils font

Prefect donne à Claude 15 outils : 15 qui lisent ton compte, 0 qui y changent quelque chose.

Les quinze consultent tes workspaces Prefect Cloud ou la documentation de Prefect. Les noms restent ceux que Claude affiche, en anglais.

  • 15 lecture

Ce que Claude lit (15)

15 outils

Quinze outils qui inspectent workflows et documentation sans toucher à ton workspace.

docs_get_release_notes

Récupère les notes de version open source de Prefect, les plus récentes ou celles d'une version précise, pour une question liée à une version. C'est un des outils de documentation : il lit les notes publiques de Prefect, pas ton workspace.

Quand ça sert
tu veux savoir ce qu'a changé une version donnée de Prefect.

Sourcegithub.com · 1 octobre 2026 ↗

docs_search_prefect

Fouille la documentation Prefect à la recherche de concepts, d'exemples d'usage et de bonnes pratiques. Claude répond alors d'après la documentation plutôt que de mémoire.

Quand ça sert
il te faut un exemple d'usage pour une fonction de Prefect que tu n'as jamais configurée.

Sourcegithub.com · 1 octobre 2026 ↗

get_automations

Renvoie les automations d'un workspace sous forme de résumé, ou en détail avec leurs déclencheurs et leurs actions quand tu en vises certaines. Le résumé par défaut donne le type de déclencheur et le nombre d'actions.

Quand ça sert
tu veux voir quel déclencheur et quelles actions porte une automation donnée.

Sourcegithub.com · 1 octobre 2026 ↗

get_dashboard

Donne une vue d'ensemble : statistiques des flow runs en cours, état des work pools et toutes les limites de concurrence actives. Prefect le présente comme le premier arrêt face aux retards et aux goulets.

Quand ça sert
plusieurs runs sont en retard et il te faut le tableau général avant de creuser.

Sourcegithub.com · 1 octobre 2026 ↗

get_deployments

Liste les déploiements avec filtres facultatifs, en résumé par défaut. Pour ceux que tu nommes, il ajoute paramètres, variables de job, détails du work pool et derniers runs.

Quand ça sert
tu veux savoir quels paramètres et quelles variables de job utilise un déploiement donné.

Sourcegithub.com · 1 octobre 2026 ↗

get_flow_run_logs

Remonte les entrées de log d'un flow run avec leurs horodatages, leurs niveaux et leurs messages, pour que Claude lise l'échec là où il s'est produit.

Quand ça sert
un run a fini en erreur et tu cherches l'entrée de log qui l'explique.

Sourcegithub.com · 1 octobre 2026 ↗

get_flow_runs

Retrouve les flow runs qui répondent à des filtres, en résumé compact par défaut et en détail complet, paramètres et work pool compris, pour ceux que tu désignes.

Quand ça sert
il te faut les runs échoués d'un même flow, puis le détail de l'un d'eux.

Sourcegithub.com · 1 octobre 2026 ↗

get_flows

Liste les flows enregistrés dans le workspace, avec filtres si besoin. Claude dispose ainsi de l'inventaire avant de regarder les runs ou les déploiements. Prefect l'enregistre, comme les autres outils d'inspection, en lecture seule dans le code de son serveur.

Quand ça sert
tu veux la liste des flows que contient un workspace.

Sourcegithub.com · 1 octobre 2026 ↗

get_identity

Indique vers quelle instance Prefect pointe la connexion : son adresse d'API, s'il s'agit de Cloud ou de l'open source, et les informations utilisateur quand elles existent.

Quand ça sert
tu jongles entre plusieurs environnements Prefect et veux être sûr que Claude regarde le bon.

Sourcegithub.com · 1 octobre 2026 ↗

get_object_schema

Renvoie le schéma d'un type d'objet complexe, les automations en particulier, pour que Claude comprenne comment il est structuré. L'outil orientation de Prefect range les schémas parmi les capacités prises en charge.

Quand ça sert
tu prépares une automation hors de Claude et il te faut la structure attendue.

Sourcegithub.com · 1 octobre 2026 ↗

get_task_runs

Liste les task runs qui répondent à des filtres, avec leur détail, à l'intérieur des flows du workspace.

Quand ça sert
tu veux les task runs d'un flow listés avec leur détail.
Attention
selon Prefect, le champ des entrées d'un task run retrace les dépendances amont, pas les valeurs réellement passées à la tâche.

Sourcegithub.com · 1 octobre 2026 ↗

get_work_pools

Montre les work pools, avec filtres facultatifs, en résumé compact par défaut : nom, type, état et limite de concurrence. Prefect le juge essentiel pour déboguer des runs bloqués ou qui ne démarrent pas.

Quand ça sert
des runs ne démarrent pas et tu veux vérifier le pool dont ils dépendent.

Sourcegithub.com · 1 octobre 2026 ↗

list_authorized_workspaces

Liste les workspaces Prefect Cloud que tu as cochés au moment d'autoriser la connexion, avec les identifiants du compte et de chaque workspace.

Quand ça sert
Claude dit ne pas trouver un workspace et tu veux vérifier s'il a bien été sélectionné à la connexion.

Sourcegithub.com · 1 octobre 2026 ↗

orientation

Donne à Claude une vue d'ensemble de ce que couvrent les outils Prefect et de leurs frontières, sans aller chercher la moindre donnée dans ton workspace.

Quand ça sert
en début de session, pour que Claude sache d'emblée quel outil couvre quel type de question.

Sourcegithub.com · 1 octobre 2026 ↗

read_events

Lit et filtre les événements de l'instance Prefect, et les présente de façon structurée, avec des filtres sur ce que tu cherches.

Quand ça sert
tu veux les événements enregistrés autour d'un moment précis.
Attention
sans période précisée, Prefect ne renvoie que la dernière heure d'événements.

Sourcegithub.com · 1 octobre 2026 ↗

Approbations

Ce que Claude te demande avant d'agir

Par défaut, Claude s'arrête et demande ton accord avant chaque action qu'il mène sur un compte à ta place. Le guide de Prefect te dit d'ailleurs d'approuver les appels d'outils quand Claude te le propose.

Les quinze outils se contentent de consulter, et Prefect les décrit comme en lecture seule. Aucune source ne fixe de confirmation propre à un outil Prefect en particulier : c'est le comportement par défaut qui joue. Sur un espace Team ou Enterprise, les propriétaires décident si un membre peut laisser passer certaines actions sans demande, et peuvent borner ce qu'un connecteur fait pour toute l'organisation. Claude travaille avec tes droits Prefect, rien de plus : ce que ton compte ne voit pas, il ne le voit pas non plus.

Plans

Sur quels plans c'est disponible

Sur les 819 fiches du répertoire officiel, aucune n'affiche de disponibilité par plan. La réponse connecteur par connecteur n'est publiée nulle part : c'est un vrai trou du catalogue.

La règle générale, elle, est publiée : les connecteurs distants sont ouverts à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile. Sur Team et Enterprise, un Owner ou un Primary Owner active le connecteur pour l'organisation avant que les membres puissent s'y connecter. Pour l'état à jour, ouvre la fiche Prefect du répertoire officiel.

Limites

Là où ce connecteur s'arrête

Un connecteur n'est pas une automatisation. Claude appelle ces outils pendant qu'il te répond : rien ne démarre quand un run échoue, qu'un pool se vide ou qu'un déploiement bouge.

Par défaut, la fiche n'expose que de la lecture, et c'est un plancher constaté, pas une promesse : un administrateur peut ouvrir des actions qu'aucune fiche publique ne montre. Ce connecteur n'a pas d'article d'aide Claude dédié ; ce qu'on en sait vient de la fiche du répertoire, du guide de Prefect et du code que Prefect publie pour son serveur. Le badge vérifié n'a rien d'un audit de sécurité, et Anthropic précise sur chaque fiche qu'il ne choisit pas les outils qu'un éditeur expose.

Besoin d'aide

Besoin d'aide pour brancher Prefect sur Claude ?

Une personne lit chaque message.

FAQ

Questions fréquentes sur le connecteur Claude Prefect

01Que peut faire Claude avec le connecteur Prefect ?
Claude peut inspecter tes workspaces Prefect Cloud et t'aider à comprendre pourquoi des runs échouent, bloquent ou partent en retard. Ses quinze outils couvrent les flows, les flow runs et leurs logs, les task runs, les déploiements, les work pools, les automations, les événements, un tableau de bord, l'identité de l'instance connectée et la liste des workspaces autorisés. Deux autres fouillent la documentation et les notes de version. Prefect présente l'ensemble comme un outil de diagnostic en lecture.
02Claude peut-il créer ou modifier des déploiements dans Prefect ?
Pas avec les outils listés de ce connecteur : par défaut, sa fiche n'expose que de la lecture. Le guide de Prefect précise que les outils hébergés sont en lecture seule et que créer ou mettre à jour une ressource passe par la CLI prefect ou le SDK. Claude peut en revanche te retrouver la bonne commande dans la documentation. C'est un plancher constaté, pas une garantie pour toute configuration, puisqu'un administrateur peut ouvrir des actions qu'aucune fiche publique ne liste.
03Claude me demande-t-il avant d'utiliser un outil Prefect ?
Le guide de Prefect te dit d'approuver les appels d'outils quand Claude te le propose, et la règle par défaut de Claude consiste à demander avant chaque action qu'il mène sur un compte à ta place. Aucune source ne décrit de règle propre à un outil Prefect en particulier. Sur un espace Team ou Enterprise, les propriétaires décident si les membres peuvent laisser passer certaines actions sans demande, et peuvent restreindre ce que fait le connecteur pour toute l'organisation.
04Sur quels plans Claude le connecteur Prefect est-il disponible ?
Aucune source officielle ne publie la disponibilité par plan connecteur par connecteur, et aucune des 819 fiches du répertoire ne l'affiche. La règle générale ouvre les connecteurs distants à tous les utilisateurs sur Claude, Cowork, Claude Desktop et mobile, avec une activation préalable par un Owner sur Team et Enterprise. Côté Prefect, le guide demande seulement un accès à un workspace Prefect Cloud. La fiche Prefect du répertoire montre l'état à jour pour ton compte.
05Claude voit-il tous mes workspaces Prefect ?
Non, seulement ceux que tu sélectionnes au moment d'autoriser la connexion. Prefect te demande à la connexion quels workspaces Claude pourra consulter, et l'outil list_authorized_workspaces affiche ensuite exactement ceux-là, avec leurs identifiants, pour que tu vérifies ce qui a été accordé. À l'intérieur, Claude n'atteint que ce que ton propre compte Prefect atteint. Sur un espace Team ou Enterprise, un propriétaire peut en plus restreindre ce que le connecteur fait pour chacun.
06Le connecteur Prefect fonctionne-t-il avec un serveur Prefect auto-hébergé ?
Le connecteur du répertoire est pensé pour Prefect Cloud : le guide de Prefect indique qu'il suppose un accès à un workspace Prefect Cloud et aucune installation locale. Pour un serveur auto-hébergé, ce même guide renvoie vers une installation locale ou le déploiement de ton propre serveur, une configuration distincte de celle du répertoire de Claude. Prefect présente aussi son serveur comme une bêta : outils, fonctions et comportement décrits ici peuvent changer sans préavis.
07Claude ou un outil d'automatisation pour Prefect ?
Ils ne font pas le même métier, donc tout dépend de l'usage. Claude et ce connecteur conviennent à une enquête sur le moment : tu demandes pourquoi un run a échoué, il lit logs, pools et événements pour te l'expliquer. Un outil d'automatisation convient à ce qui doit se passer sans que personne ne le demande, comme prévenir un canal quand un run plante, puisqu'un connecteur ne démarre jamais seul. Le guide de Prefect propose de commencer par demander à Claude à quels workspaces Prefect il a accès.