Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade CircleCI con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
Deja que tu IA revise CircleCI: pipelines, workflows y jobs, tests fallidos y artefactos, métricas de Insights y tests inestables, contextos y nombres de variables, y que inicie pipelines o vuelva a ejecutar y cancele workflows después de que lo confirmes.
Prueba a pedir
Prompts de ejemplo para CircleCI
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → CircleCI, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
CircleCI + Claude
Deja que tu IA revise CircleCI: pipelines, workflows y jobs, tests fallidos y artefactos, métricas de Insights y tests inestables, contextos y nombres de variables, y que inicie pipelines o vuelva a ejecutar y cancele workflows después de que lo confirmes.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
CIRCLECI_TOKEN
Paso 1 — Obtener credenciales
- Inicia sesión en CircleCI en
https://app.circleci.comy abre User Settings → Personal API Tokens (https://app.circleci.com/settings/user/tokens). - Haz clic en Create New Token, ponle un nombre y cópialo. Los tokens más nuevos empiezan por
CCIPAT_. Los tokens de API de proyecto de la configuración del proyecto no funcionan con la API v2. - Pega el token en
CIRCLECI_TOKENtal cual, sin prefijo, e instala el conector. Se envía en la cabeceraCircle-Tokensolo a circleci.com. - Comprueba la configuración con
circleci_get_current_usery después concircleci_list_collaborations, que muestra las organizaciones a las que perteneces.
Quién ve qué: el token tiene los mismos permisos que tu usuario de CircleCI en todas las organizaciones a las que perteneces. Comparte el servidor MCP solo con personas que puedan ver esas builds.
Slugs de proyecto: casi todas las herramientas necesitan el slug del proyecto que aparece en Project Settings → Overview. Los proyectos conectados con GitHub OAuth y Bitbucket Cloud usan gh/<org>/<repo> o bb/<workspace>/<repo> (por ejemplo gh/garcia-sl/tienda-web); los proyectos conectados con la GitHub App y GitLab usan circleci/<organization id>/<project id>. Pasa el slug tal cual, con sus barras.
Inicia builds y detiene trabajo en curso, así que la IA pregunta antes: circleci_trigger_pipeline inicia un pipeline nuevo en una rama o un tag. Necesita el id de una definición de circleci_list_pipeline_definitions, que a su vez necesita el id del proyecto de circleci_get_project, y no está disponible para proyectos de GitLab. circleci_rerun_workflow vuelve a ejecutar un workflow como uno nuevo: todos los jobs, solo desde el job fallido o los jobs que elijas. circleci_cancel_workflow detiene un workflow en curso, y los jobs que aún no han empezado ya no se ejecutan. Iniciar y volver a ejecutar consumen créditos y hacen todo lo que indique la configuración, jobs de despliegue incluidos; cancelar puede dejar un despliegue a medias. Antes de cada una, la IA te indica el proyecto, la rama, el workflow o los jobs y espera tu sí. Ninguna herramienta está desactivada al instalar, y nada de esto borra proyectos, contextos ni variables.
Averiguar por qué falló una build: circleci_list_pipelines (del más reciente al más antiguo, opcionalmente de una sola rama), circleci_get_pipeline por id o circleci_get_pipeline_by_number para el #número que ves en la app; después circleci_list_pipeline_workflows y circleci_list_workflow_jobs para encontrar el job fallido y su número. circleci_get_job da el estado, la duración, el executor, los contextos usados y el enlace web. circleci_list_job_tests cuenta los tests superados, omitidos y fallidos y muestra cada test fallido con su mensaje (solo en jobs que guardan resultados de tests). circleci_list_job_artifacts lista los artefactos guardados con enlaces de descarga, que necesitan el mismo token. Los logs completos de los pasos solo están en la app de CircleCI, a través del web_url del job.
Tendencias y tests inestables: circleci_get_workflow_metrics resume todos los workflows de un proyecto en una ventana que va de las últimas 24 horas a los últimos 90 días (ejecuciones, tasa de éxito, duración, créditos usados, tiempo de recuperación), para una rama o para todas. circleci_get_workflow_summary muestra un workflow en los últimos 90 días con su tendencia frente al periodo anterior. circleci_list_flaky_tests lista los tests que pasaron y fallaron en el mismo commit, con cuántas veces ocurrió y el tiempo perdido. Los datos de Insights se actualizan a diario, no en tiempo real.
Contextos y variables: circleci_list_contexts necesita el id de la organización de circleci_list_collaborations (o un slug de organización como gh/garcia-sl para organizaciones de GitHub OAuth y Bitbucket). circleci_list_context_env_var_names y circleci_list_project_env_var_names devuelven solo los nombres de las variables de entorno, nunca sus valores.
Paginación: las listas devuelven next_page_token; la IA lo vuelve a pasar como page_token hasta que llega vacío.
Errores comunes: 401: el token es incorrecto o está revocado, o es un token de API de proyecto; crea un token de API personal en User Settings. 404: el slug del proyecto es incorrecto o tu usuario no ve el proyecto; CircleCI responde 404 en lugar de 403 para proyectos fuera de tu acceso. 429: se alcanzó el límite de peticiones; espera un minuto y vuelve a intentarlo.
El conector no cubre la aprobación de jobs en espera, la creación o eliminación de proyectos, contextos, variables de entorno, programaciones y webhooks, ni la lectura de los logs completos de los pasos.
Paso 2 — Instalar el adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Añadir el conector en Claude
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
CircleCI, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
circleci_get_current_user | Get the CircleCI user the personal API token belongs to: id, login and name |
circleci_list_collaborations | List the organizations the user belongs to: id, name, VCS type and slug (e.g. gh/acme, or circleci/<org-id> for GitHub App and GitLab… |
circleci_get_project | Get a project by slug: name, project id, organization name, slug and id, and the connected repository URL and default branch |
circleci_list_pipeline_definitions | List the pipeline definitions of a project: id, name, description and where the config and code come from |
circleci_list_pipelines | List the pipelines of a project, newest first: id, number, state, branch or tag, commit, trigger, actor, time and setup errors |
circleci_get_pipeline | Get one pipeline by id: number, state, branch or tag, commit, trigger, actor, time and setup errors |
circleci_get_pipeline_by_number | Get one pipeline of a project by its number (the #123 shown in the CircleCI app) |
circleci_list_pipeline_workflows | List the workflows of a pipeline: id, name, status (success, running, failed, on_hold, canceled ...), start and stop time and who started… |
circleci_get_workflow | Get one workflow by id: name, status, pipeline id and number, project, start and stop time, and who started, canceled or errored it |
circleci_list_workflow_jobs | List the jobs of a workflow: id, job number, name, type (build or approval), status, dependencies, start and stop time |
circleci_get_job | Get the details of a job by project and job number: name, status, duration, executor and resource class, parallelism and per-run status… |
circleci_list_job_tests | Summarize the test results a job uploaded with store_test_results: how many passed, were skipped and failed, and for every failed test its… |
circleci_list_job_artifacts | List the artifacts a job stored with store_artifacts: path, node index and download URL |
circleci_get_workflow_metrics | Insights summary for every workflow of a project over a reporting window (default last 90 days): runs, success rate, failed runs, duration… |
circleci_get_workflow_summary | Insights for one workflow: metrics for the last 90 days (runs, success rate, duration, credits, time to recovery) and their trend against… |
circleci_list_flaky_tests | List the project's flaky tests (tests that passed and failed on the same commit): test name, class, file, job and workflow, how often it… |
circleci_trigger_pipeline | Start a new pipeline for a project from a pipeline definition, on a branch or tag |
circleci_rerun_workflow | Rerun a workflow as a new workflow: all jobs, only from the failed job (from_failed), or chosen jobs |
circleci_cancel_workflow | Cancel a running workflow; its running jobs stop and jobs not yet started will not run, which can leave a deployment half done |
circleci_list_contexts | List the contexts (shared sets of environment variables) of an organization: id, name and creation time |
circleci_list_context_env_var_names | List the names of the environment variables in a context, with created and updated time |
circleci_list_project_env_var_names | List the names of a project's environment variables (Project Settings > Environment Variables) with their creation time |
Ejemplos de prompts
- "¿Por qué falló el último pipeline en main de gh/garcia-sl/tienda-web? Muéstrame el job fallido, los tests que fallan con sus mensajes y el enlace al job."
- "¿Qué tests de gh/garcia-sl/tienda-web son inestables, cuántas veces han fallado al azar y cuánto tiempo nos han hecho perder?"
- "Compara todos los workflows de gh/garcia-sl/tienda-web en los últimos 30 días en todas las ramas: tasa de éxito, duración media y créditos usados."
- "Vuelve a ejecutar el workflow de despliegue del pipeline #1482 desde el job fallido. Dime qué jobs se volverán a ejecutar y pregúntame antes de lanzarlo."
- "Inicia un pipeline en la rama release/2.4 con el parámetro deploy a true. Muéstrame antes el proyecto, la rama y los parámetros."
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
¿Te ha sido útil esta guía?
