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.
Configuración guiada
Conecta CircleCI a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta CircleCI con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
CircleCI. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?