Recursos · Conector de Claude

Conector Claude PrefectLo que Claude sabe hacer en tus workspaces de Prefect.

El conector Claude Prefect expone 15 herramientas: las 15 leen, 0 escriben y 0 quedan sin documentar. Aquí verás qué revisa Claude en tus workspaces de Prefect Cloud, por qué se queda en el diagnóstico, qué pide antes de actuar y quién puede desactivarlo.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Resumen

Qué cambia cuando Claude puede mirar dentro de Prefect

Cuando falla un run, la vía manual es abrir la interfaz de Prefect, buscar el run, recorrer sus logs y luego revisar el work pool y el despliegue. Con este conector le preguntas a Claude por qué falló el run, y él repasa runs, logs, pools y eventos antes de contarte lo que encontró. Prefect describe sus herramientas alojadas como de solo lectura: Claude diagnostica, no arregla.

Un fallo explicado con palabras claras. Un run terminó en fallo: get_flow_runs lo localiza y get_flow_run_logs trae sus entradas de log con nivel, marca de tiempo y mensaje.

Retrasos rastreados hasta su origen. Los runs se acumulan con retraso: get_dashboard muestra estadísticas, estado de los pools y límites de concurrencia activos, y get_work_pools devuelve nombre, tipo, estado y límite de concurrencia de cada pool, una herramienta que Prefect considera esencial cuando los runs se atascan o no arrancan.

Respuestas sacadas de la documentación vigente. Surge una duda sobre un concepto de Prefect: docs_search_prefect busca en la documentación de Prefect y docs_get_release_notes comprueba qué trae una versión concreta.

Ahora, lo que la ficha del directorio no cuenta. La guía de Prefect es clara: crear o actualizar recursos se hace con la CLI prefect o el SDK, no con estas herramientas. El conector alcanza los workspaces de Prefect Cloud que marques al iniciar sesión; un servidor Prefect autoalojado necesita otra instalación que Prefect documenta aparte. Y nada funciona solo: ninguna herramienta se activa cuando falla un run. Para avisos en segundo plano hace falta una herramienta de automatización, que es otro oficio; la página Integraciones reúne esa parte.

Vocabulario

El vocabulario en un minuto

Cinco palabras que vas a ver al conectar Prefect.

Conector
El enlace que estableces una vez entre Claude y una cuenta que ya tienes, para que trabaje en ella mientras te responde.
Herramienta
Una acción con nombre que el conector le abre a Claude en esa cuenta. Él elige solo las que necesita; la ficha del directorio las enumera.
Autorización
La pantalla de acceso de Prefect Cloud, donde eliges lo que Claude podrá alcanzar. Se da una vez por persona y se puede retirar.
Aprobación
La confirmación que Claude espera antes de completar una acción, mostrada en la conversación en el momento en que importa.
MCP
El estándar común de los conectores: es lo que permite que un asistente como Claude se comunique con un servicio ajeno a él.
Conexión

Configurar el conector Claude Prefect en tres pasos

  1. 01

    Localiza Prefect en Claude

    En los ajustes de Claude, entra en Customize y después en Connectors, y busca Prefect en la lista. En un espacio Team o Enterprise, un Owner o un Primary Owner activa el conector antes de que cada miembro pueda conectarse por su cuenta.

  2. 02

    Inicia la conexión

    Pulsa Connect en su fila e inicia sesión en Prefect Cloud en la ventana que abre el propio servicio. Si más adelante el enlace falla, usa Disconnect y vuelve a conectar.

  3. 03

    Revisa la pantalla de autorización

    Lee la pantalla de autorización antes de aceptar. Pertenece a Prefect, no a Claude, y es la que decide hasta dónde llega el acceso, incluida la lista de workspaces que Claude podrá consultar.

Herramientas

Las 15 herramientas, ordenadas por lo que hacen

Prefect le da a Claude 15 herramientas: 15 que leen tu cuenta, 0 que cambian algo en ella.

Las quince consultan tus workspaces de Prefect Cloud o la documentación de Prefect. Los nombres se quedan tal como los muestra Claude, en inglés.

  • 15 lectura

Lo que Claude lee (15)

15 herramientas

Quince herramientas que revisan workflows y documentación sin tocar tu workspace.

docs_get_release_notes

Trae las notas de versión de código abierto de Prefect, las más recientes o las de una versión concreta, para una pregunta ligada a una versión. Es una de las herramientas de documentación: lee las notas públicas de Prefect, no tu workspace.

Cuándo sirve
quieres saber qué cambió una versión concreta de Prefect.

Fuentegithub.com · 1 de octubre de 2026 ↗

docs_search_prefect

Rastrea la documentación de Prefect en busca de conceptos, ejemplos de uso y buenas prácticas. Claude contesta así a partir de la documentación y no de memoria.

Cuándo sirve
necesitas un ejemplo de uso de una función de Prefect que nunca has configurado.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_automations

Devuelve las automations de un workspace en resumen, o con todo el detalle de disparadores y acciones cuando preguntas por algunas en concreto. El resumen por defecto da el tipo de disparador y el número de acciones.

Cuándo sirve
quieres ver qué disparador y qué acciones lleva una automation concreta.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_dashboard

Ofrece una visión de conjunto: estadísticas de los flow runs en curso, estado de los work pools y todos los límites de concurrencia activos. Prefect lo presenta como primera parada ante retrasos y cuellos de botella.

Cuándo sirve
varios runs van con retraso y necesitas el cuadro completo antes de profundizar.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_deployments

Lista los despliegues con filtros opcionales, en resumen por defecto. Para los que nombras, añade parámetros, variables de job, detalles del work pool y últimos runs.

Cuándo sirve
quieres saber qué parámetros y variables de job usa un despliegue concreto.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_flow_run_logs

Recupera las entradas de log de un flow run con su marca de tiempo, su nivel y su mensaje, para que Claude lea el fallo justo donde ocurrió.

Cuándo sirve
un run terminó en error y buscas la entrada de log que lo explica.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_flow_runs

Encuentra los flow runs que cumplen unos filtros, en resumen compacto por defecto y con detalle completo, parámetros y work pool incluidos, para los que señalas.

Cuándo sirve
necesitas los runs fallidos de un mismo flow y luego el detalle de uno de ellos.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_flows

Lista los flows registrados en el workspace, con filtros si hace falta. Así Claude tiene el inventario antes de mirar runs o despliegues. Prefect la registra, como las demás herramientas de inspección, como de solo lectura en el código de su servidor.

Cuándo sirve
quieres la lista de flows que contiene un workspace.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_identity

Indica a qué instancia de Prefect apunta la conexión: su dirección de API, si es Cloud o código abierto, y los datos del usuario cuando existen.

Cuándo sirve
trabajas con varios entornos de Prefect y quieres asegurarte de que Claude mira el correcto.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_object_schema

Devuelve el esquema de un tipo de objeto complejo, sobre todo las automations, para que Claude entienda cómo está estructurado. La herramienta orientation de Prefect cuenta los esquemas entre las capacidades que admite.

Cuándo sirve
preparas una automation fuera de Claude y necesitas la estructura que se espera.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_task_runs

Lista los task runs que cumplen unos filtros, con su detalle, dentro de los flows del workspace.

Cuándo sirve
quieres los task runs de un flow listados con su detalle.
Ojo
según Prefect, el campo de entradas de un task run recoge las dependencias previas, no los valores que recibió realmente la tarea.

Fuentegithub.com · 1 de octubre de 2026 ↗

get_work_pools

Muestra los work pools con filtros opcionales, en resumen compacto por defecto: nombre, tipo, estado y límite de concurrencia. Prefect la considera esencial para depurar runs atascados o que no arrancan.

Cuándo sirve
hay runs que no arrancan y quieres revisar el pool del que dependen.

Fuentegithub.com · 1 de octubre de 2026 ↗

list_authorized_workspaces

Lista los workspaces de Prefect Cloud que marcaste al autorizar la conexión, con los identificadores de la cuenta y de cada workspace.

Cuándo sirve
Claude dice que no encuentra un workspace y quieres comprobar si lo seleccionaste al iniciar sesión.

Fuentegithub.com · 1 de octubre de 2026 ↗

orientation

Le da a Claude una visión general de lo que abarcan las herramientas de Prefect y de sus fronteras, sin ir a buscar ningún dato de tu workspace.

Cuándo sirve
al empezar una sesión, para que Claude sepa desde el principio qué herramienta cubre cada tipo de pregunta.

Fuentegithub.com · 1 de octubre de 2026 ↗

read_events

Lee y filtra los eventos de la instancia de Prefect y los ordena en una vista estructurada.

Cuándo sirve
quieres los eventos registrados en torno a un momento concreto.
Ojo
si no indicas un intervalo, Prefect solo devuelve la última hora de eventos.

Fuentegithub.com · 1 de octubre de 2026 ↗

Aprobaciones

Lo que Claude te pide antes de actuar

Por defecto, Claude se detiene y te pide permiso antes de cada acción que realiza en una cuenta en tu nombre. La propia guía de Prefect te indica que apruebes las llamadas a herramientas cuando Claude te lo plantee.

Las quince herramientas se limitan a consultar, y Prefect las describe como de solo lectura. Ninguna fuente fija una confirmación propia de una herramienta concreta, así que rige el comportamiento por defecto. En un espacio Team o Enterprise, los propietarios deciden si un miembro puede dejar pasar ciertas acciones sin aviso, y pueden acotar lo que un conector hace para toda la organización. Claude trabaja con tus permisos de Prefect y nada más: lo que tu cuenta no ve, él tampoco lo ve.

Planes

En qué planes está disponible

De las 819 fichas del directorio oficial, ninguna muestra disponibilidad por plan. La respuesta conector por conector no se publica en ningún sitio: es un hueco real del catálogo.

La regla general sí está publicada: los conectores remotos están abiertos a todos los usuarios en Claude, Cowork, Claude Desktop y móvil. En Team y Enterprise, un Owner o un Primary Owner activa el conector para la organización antes de que los miembros puedan conectarse. Para ver el estado actual, abre la ficha de Prefect en el directorio oficial.

Límites

Dónde se detiene este conector

Un conector no es una automatización. Claude llama a estas herramientas mientras te responde: nada arranca cuando falla un run, se vacía un pool o cambia un despliegue.

Por defecto, la ficha solo expone lectura, y eso es un suelo observado, no una promesa: un administrador puede abrir acciones que ninguna ficha pública muestra. Este conector no tiene artículo de ayuda propio en Claude; lo que se sabe viene de la ficha del directorio, de la guía de Prefect y del código que Prefect publica para su servidor. La insignia de verificación no equivale a una auditoría de seguridad, y Anthropic avisa en cada ficha de que no decide qué herramientas expone un editor.

¿Necesitas ayuda?

¿Necesitas ayuda para conectar Prefect con Claude?

Una persona lee cada mensaje.

FAQ

Preguntas frecuentes sobre el conector Claude Prefect

01¿Qué puede hacer Claude con el conector de Prefect?
Claude puede revisar tus workspaces de Prefect Cloud y ayudarte a entender por qué los runs fallan, se atascan o llegan tarde. Sus quince herramientas cubren flows, flow runs y sus logs, task runs, despliegues, work pools, automations, eventos, un panel general, la identidad de la instancia conectada y la lista de workspaces autorizados. Otras dos buscan en la documentación y en las notas de versión. Prefect presenta el conjunto como una herramienta de diagnóstico en lectura.
02¿Puede Claude crear o cambiar despliegues en Prefect?
No con las herramientas listadas de este conector: por defecto, su ficha solo expone lectura. La guía de Prefect indica que las herramientas alojadas son de solo lectura y que crear o actualizar recursos se hace con la CLI prefect o el SDK. Claude sí puede encontrarte el comando correcto en la documentación. Es un suelo observado, no una garantía para cualquier configuración, ya que un administrador puede abrir acciones que ninguna ficha pública recoge.
03¿Claude me pregunta antes de usar una herramienta de Prefect?
La guía de Prefect te indica que apruebes las llamadas a herramientas cuando Claude te lo plantee, y la regla por defecto de Claude es preguntar antes de cada acción que realiza en una cuenta en tu nombre. Ninguna fuente describe una regla propia de una herramienta de Prefect en particular. En un espacio Team o Enterprise, los propietarios deciden si los miembros pueden dejar pasar algunas acciones sin aviso, y pueden restringir lo que hace el conector para toda la organización.
04¿En qué planes de Claude está disponible el conector de Prefect?
Ninguna fuente oficial publica la disponibilidad por plan conector por conector, y ninguna de las 819 fichas del directorio la muestra. La regla general abre los conectores remotos a todos los usuarios en Claude, Cowork, Claude Desktop y móvil, con activación previa de un Owner en Team y Enterprise. Por el lado de Prefect, la guía solo pide acceso a un workspace de Prefect Cloud. La ficha de Prefect en el directorio muestra el estado actual para tu cuenta.
05¿Ve Claude todos mis workspaces de Prefect?
No, solo los que seleccionas al autorizar la conexión. Prefect te pregunta al iniciar sesión qué workspaces podrá consultar Claude, y la herramienta list_authorized_workspaces muestra después exactamente esos, con sus identificadores, para que compruebes lo concedido. Dentro de ellos, Claude solo alcanza lo que alcanza tu propia cuenta de Prefect. En un espacio Team o Enterprise de Claude, un propietario puede además restringir lo que el conector hace para cada miembro.
06¿Funciona el conector de Prefect con un servidor Prefect autoalojado?
El conector del directorio está pensado para Prefect Cloud: la guía de Prefect dice que requiere acceso a un workspace de Prefect Cloud y ninguna instalación local. Para un servidor autoalojado, esa misma guía remite a una instalación local o a desplegar tu propio servidor, una configuración distinta de la del directorio de Claude. Prefect presenta además su servidor como beta: herramientas, funciones y comportamiento descritos aquí pueden cambiar sin aviso.
07¿Claude o una herramienta de automatización para Prefect?
No hacen el mismo trabajo, así que depende del uso. Claude con este conector encaja con una investigación en el momento: preguntas por qué falló un run y él lee logs, pools y eventos para explicártelo. Una herramienta de automatización encaja con lo que debe ocurrir sin que nadie lo pida, como avisar a un canal cuando un run se cae, porque un conector nunca arranca solo. La guía de Prefect propone empezar preguntando a Claude a qué workspaces de Prefect tiene acceso.