Conector Claude CircleCILo que Claude sabe hacer en tu cuenta de CircleCI.
El conector Claude CircleCI expone 24 herramientas: 10 leen, 3 actúan sobre tus pipelines y 11 no están descritas en ningún sitio. Aquí: qué runs, logs y tests consulta Claude, qué puede relanzar, cancelar o revertir, qué pide CircleCI revisar antes y quién puede cortar el acceso.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
Qué cambia cuando un build se pone en rojo
Un build fallido suele obligar a abrir CircleCI, buscar el run, luego el workflow, luego el job y bajar por los logs. Con el conector activo, le preguntas a Claude por qué falló el último run de tu rama. Él encadena las búsquedas, lee la salida del paso que falló y te explica qué se rompió, en la misma conversación.
Encontrar la causa de un build en rojo. list_runs localiza el último run de la rama, get_run confirma el fallo y get_job_logs lee los pasos fallidos sin que tengas que nombrarlos.
Relanzar solo lo que falló. Un workflow largo se rompió casi al final. rerun_workflow puede relanzar solo los jobs fallidos y lo que depende de ellos.
Vigilar costes y versiones. download_usage_data exporta el consumo de una organización en archivos CSV, y list_deploy_component_versions revisa qué versiones de componentes corren en tu flota.
Lo que la ficha no cuenta: es el servidor alojado de CircleCI, pensado para inspeccionar runs. Gestionar contextos, variables de entorno, orbs o políticas corresponde a la herramienta de línea de comandos de CircleCI, no a este conector. Once herramientas de la ficha no tienen descripción. Y nada se ejecuta solo: ninguna herramienta reacciona por su cuenta a un push o a un fallo. Para reaccionar automáticamente a eventos del pipeline, la Integración CircleCI n8n hace ese trabajo, distinto de una conversación.
El vocabulario en un minuto
Cinco palabras que vas a encontrar al conectar CircleCI.
- Conector
- El enlace que configuras una vez entre Claude y una cuenta que ya tienes, para que Claude trabaje en ella mientras te responde.
- Herramienta
- Una acción con nombre que el conector abre a Claude. Él elige solo las que necesita, y el directorio las lista por su nombre.
- Autorización
- La pantalla de acceso del propio servicio, donde le das a Claude el permiso que usará después. Se da una vez por persona y se retira igual.
- Aprobación
- La confirmación que Claude espera antes de completar algo que cambia una cuenta, mostrada en la conversación en el momento justo.
- MCP
- El estándar común sobre el que se construyen los conectores: es lo que permite a un asistente como Claude hablar con un servicio externo.
Conectar CircleCI a Claude en tres pasos
- 01
Encontrar CircleCI en Claude
En los ajustes de Claude, abre Customize y luego Connectors, y busca CircleCI en la lista. En un espacio Team o Enterprise, un Owner o un Primary Owner tiene que activar antes el conector para que cada miembro pueda conectarse.
- 02
Lanzar la conexión
Pulsa Connect en su fila e inicia sesión en CircleCI en la ventana que abre el propio CircleCI. Si el enlace se rompe más adelante, usa Disconnect y vuelve a conectar; CircleCI también aconseja volver a autenticarse cuando falla el acceso.
- 03
Revisar la pantalla de autorización
Lee la pantalla de autorización antes de aceptar. Es de CircleCI, no de Claude, y es ella la que fija qué cubre el acceso. También puedes retirar ese acceso más tarde desde tu cuenta de CircleCI.
Las 24 herramientas del conector Claude CircleCI
CircleCI le da a Claude 24 herramientas: 10 que leen tu cuenta, 3 que cambian algo en ella, y 11 que ninguna fuente oficial describe.
Tres grupos: lo que Claude lee, lo que cambia en tus pipelines y lo que ninguna fuente oficial describe. Los nombres se quedan tal como los muestra Claude.
- 10 lectura
- 3 escritura
- 11 sin documentar
Lo que Claude lee (10)
10 herramientasDiez herramientas que consultan runs, jobs, logs, tests, artefactos y configuración sin modificar nada.
download_usage_data
Exporta los datos de consumo de una organización en archivos CSV descargables, para un periodo elegido, a partir de su identificador.
get_job
Trae un job con su fase, su resultado y el desglose paso a paso, con el código de salida de cada paso.
get_job_logs
Lee la salida de los pasos de un job. Si no nombras ninguno, va directo a los que fallaron, que suele ser justo lo que buscas.
get_run
Trae un run con su fase, su resultado, los datos de control de versiones y los errores de configuración que CircleCI haya detectado.
get_workflow
Devuelve el nombre, la fase y el resultado de un workflow, lo que sitúa un run antes de que Claude baje a los jobs.
list_deploy_component_versions
Según la ficha del directorio, permite a Claude revisar qué versiones de componentes están desplegadas en tu flota, como parte de la gestión diaria de proyectos.
list_job_artifacts
De acuerdo con la ficha del directorio, lista los artefactos que generan tus builds, para recuperar informes o paquetes sin rebuscar en la interfaz.
list_job_tests
Lista los resultados de tests de un job. Por defecto solo trae los que fallan, con una opción para incluir los que pasan o se omiten.
list_runs
Lista los runs de un proyecto, o tus propios runs en todos los proyectos, con filtros por rama y estado.
validate_config
Presentada por la ficha del directorio como una ayuda de configuración, sirve para validar y depurar tu archivo .circleci/config.yml.
Lo que Claude cambia (3)
3 herramientasTres herramientas que cambian el estado real de tu CI. Ninguna fuente les atribuye una confirmación propia; se aplica la regla general de abajo.
cancel_workflow
Aprobación: ver la reglaCancela un workflow que está en marcha.
rerun_workflow
Aprobación: ver la reglaVuelve a arrancar un workflow. Por defecto se repiten todos los jobs; con la opción adecuada, solo los fallidos y lo que depende de ellos.
rollback_deploy_component
Aprobación: ver la reglaLa ficha del directorio dice que puedes pedir a Claude que revierta un despliegue desde la conversación, sin abrir CircleCI.
Sin documentar (11)
11 herramientasEl directorio publica estos once nombres y nada más. Ningún texto oficial dice qué hacen, y no lo vamos a adivinar a partir de un nombre.
get_deploy_component
Este nombre está en la lista del directorio, y es todo lo que se publica sobre él. Ni la página MCP de CircleCI ni ningún artículo de Claude lo describen.
get_deploy_environment
Otro nombre listado que ninguna fuente oficial documenta. Mejor señalar el hueco que rellenarlo con una suposición sacada de cómo suena el nombre. El directorio lo muestra; la explicación falta.
get_job_resource_usage
Aparece en la ficha y no se explica en ningún sitio. Ni la página de herramientas de CircleCI ni ningún artículo de Claude le dedica una frase, así que esta página no la describe ni sugiere nada sobre su papel.
get_me
Ninguna página de CircleCI ni de Anthropic dice qué devuelve esta herramienta. El directorio solo imprime su nombre, y esta página se queda ahí también: ninguna fuente oficial lo documenta.
get_orb
El nombre aparece en la ficha sin ninguna explicación oficial. La página MCP de CircleCI no dice nada de ella, y ninguna página de Claude tampoco. Ninguna fuente oficial la documenta.
get_orb_source
Otra vez un nombre y nada más: ninguna fuente oficial lo documenta, y adivinar su comportamiento por cómo está escrito sería justo el error que esta página evita. El hueco es real, no un olvido.
list_deploy_components
Esta herramienta figura en la ficha del directorio sin una sola frase de CircleCI o de Claude detrás. Ninguna fuente oficial la documenta: sabemos que existe, no qué hace. Si CircleCI publica una descripción, esta nota la seguirá.
list_deploy_environments
Ninguna fuente documenta este nombre. El directorio lo lista, la página MCP de CircleCI lo omite y ningún artículo de ayuda de Claude cubre este conector. No se puede decir nada más con honestidad.
list_deployments
Un nombre más que la ficha muestra sin descripción oficial. Ninguna fuente oficial lo documenta. En lugar de deducir nada, esta página constata el silencio y se detiene ahí.
list_run_workflows
La página MCP de CircleCI describe una herramienta con un nombre parecido pero distinto, y nada documenta este nombre exacto. La página no da por hecho que sean la misma, y ninguna fuente oficial documenta esta.
list_workflow_jobs
El mismo desajuste: CircleCI documenta una herramienta de nombre vecino, mientras este nombre exacto no tiene descripción en ninguna fuente oficial. Ninguna fuente oficial la documenta, así que trátala como no documentada.
Lo que Claude te pide antes de actuar
Por defecto, Claude se detiene y pide tu visto bueno antes de cada acción que hace en una cuenta en tu nombre. La petición aparece en la conversación, en el momento en que importa.
Eso cubre relanzar, cancelar y revertir. CircleCI añade su propio consejo: revisar las acciones destructivas antes de confirmar, sobre todo en un proyecto compartido o cercano a producción. En Team o Enterprise, los propietarios deciden si un miembro puede dejar pasar ciertas acciones sin pregunta, y pueden limitar lo que un conector hace para todos. Claude trabaja con tus permisos y nada más: un proyecto que no puedes abrir en CircleCI sigue cerrado para él.
En qué planes de Claude está disponible
De las 819 fichas del directorio oficial, ninguna muestra disponibilidad por plan. Esa respuesta, conector por conector, no se publica en ningún sitio.
La regla general sí es pública: 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 cada miembro pueda conectarse. Para el estado actual, consulta la ficha del conector en el directorio oficial. Conviene saberlo: solo CircleCI documenta este conector, sin artículo de ayuda propio de Claude.
Dónde se detiene este conector
Un conector no es una automatización. Claude llama a estas herramientas mientras te responde: nada arranca cuando un build falla o un despliegue termina.
La lista de herramientas es un suelo observado, no una promesa: un administrador puede abrir acciones que ninguna ficha pública muestra. La insignia de partner tampoco es una auditoría de seguridad, y Anthropic lo escribe en cada ficha: no elige las herramientas que expone un editor ni garantiza cómo se comportan. Conecta solo lo que venga de un editor de confianza. Los demás conectores están en la página Integraciones.
¿Necesitas ayuda para conectar CircleCI con Claude?
Una persona lee cada mensaje.
