MCP CircleCI — build y deploy pipelines desde Claude Code

Qué es#

Si tu CI/CD vive en CircleCI, este MCP te ahorra el viaje constante al dashboard. Le da a Claude acceso a tu cuenta CircleCI para:

• Monitorear builds en tiempo real
• Disparar deployments desde el editor
• Leer insights (durations, failure rates, flaky tests)
• Acceder a logs de jobs

Útil cuando estás workflow-debugging y querés que Claude lea los logs del build que acaba de fallar sin tener que copiar-pegar todo.

Tabla resumen#

Cómo se instala#

npx claude-code-templates@latest --mcp devtools/circleci

Pre-requisito: API token de CircleCI generado desde User Settings.

Para Claude:

Instalé el MCP devtools/circleci. Después de setear CIRCLECI_TOKEN,
mostrame los últimos 10 builds del proyecto X, con status y duración.

Qué podés hacer con esto#

Debug de builds que fallan#

"El build #234 del proyecto X falló. Leé los logs y decime qué step rompió y qué error tira". Más rápido que abrir el dashboard, navegar al job, scrollear logs.

Insights de tests flaky#

"Mostrame los tests que fallaron al menos 3 veces en la última semana en el proyecto Y, ordenados por frecuencia". El MCP consulta el API de insights y Claude estructura.

Disparar deploys manualmente#

"Trigger un deploy a staging del workflow release-stg con la branch actual". Claude llama al endpoint correspondiente.

Comparación de duraciones#

"¿Qué jobs del workflow build-and-test se hicieron más lentos en la última semana? Compará con la semana anterior". Identifica regresiones de performance en CI.

Auditoría de uso#

"Listame todos los proyectos que corren más de 1 build por hora promedio, agrupados por equipo". Útil para optimización de costos.

Pre-requisitos#

• Cuenta CircleCI con acceso a los proyectos que vas a consultar
• Personal API token del User Settings
• Permisos correctos: el token hereda los permisos de tu usuario

Cuándo NO conviene#

Bajalo de la fuente#

• Ficha en aitmpl.com: CircleCI MCP — comando exacto.
• Config JSON: circleci.json — definición.
• CircleCI API tokens: app.circleci.com/settings/user/tokens.

Recursos relacionados#

• All Deploy — para deploys a hosting (Vercel, Railway). CircleCI es el orquestador, All Deploy es el publisher.
• Anatomía de Claude — para entender este MCP como conector externo (no skill ni agent).
• Agency Agents — para orquestar agents que reaccionen a builds fallidos automáticamente.