Cómo conectar CircleCI a Cursor vía MCP

💡 ¿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 + Cursor

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

1. Inicia sesión en CircleCI en https://app.circleci.com y abre User Settings → Personal API Tokens (https://app.circleci.com/settings/user/tokens).
2. 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.
3. Pega el token en CIRCLECI_TOKEN tal cual, sin prefijo, e instala el conector. Se envía en la cabecera Circle-Token solo a circleci.com.
4. Comprueba la configuración con circleci_get_current_user y después con circleci_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 Cursor

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 muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de CircleCI.

Herramientas disponibles

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT