Servidor MCP de CircleCI

Conecta tu asistente de IA con tus datos de CircleCI para depurar fallos, analizar resultados de pruebas y mejorar pipelines mediante lenguaje natural.

Descripción general del MCP
Qué puede hacer el MCP
Empezar
Herramientas disponibles
Más información

Contexto de CI/CD para herramientas de IA

El servidor MCP de CircleCI permite que herramientas de IA como Cursor, Claude Code, Windsurf y otras comprendan tu sistema de compilación. Está basado en el Model Context Protocol (MCP), un estándar ligero que permite a los agentes impulsados por modelos de lenguaje obtener datos estructurados de sistemas externos.

Al conectarse al servidor MCP de CircleCI, los agentes obtienen visibilidad en tiempo real de:

Registros de compilación y resultados de pruebas
Estados del pipeline
Cambios recientes de configuración
Métricas de rendimiento de los flujos de trabajo

Eso significa que, en lugar de revisar registros de tareas o paneles de control manualmente, puedes simplemente preguntar:

why did my last build fail?

y obtener todo el contexto necesario para resolver el problema y seguir trabajando sin interrupciones.

Convierte los datos de compilación en acciones

Una vez instalado, el servidor MCP pone tus datos de CI/CD a tu alcance mediante lenguaje natural. Las herramientas basadas en LLM pueden:

Diagnosticar compilaciones fallidas
Obtener resúmenes de errores y registros estructurados.

Rastrear fallos hasta cambios recientes
Vincular regresiones con cambios de código, diferencias o flujos de trabajo.

Detectar pruebas inestables
Identificar patrones de inestabilidad a partir del historial de pruebas.

Recomendar mejoras
Sugerir optimizaciones de configuración o tiempos según el contexto.

Llevar los datos de CI a tu editor
Analizar compilaciones con herramientas LLM sin cambiar de pestaña.

Con acceso tanto al código como al contexto de compilación, estas herramientas te ayudan a corregir errores más rápido, lanzar cambios con confianza y centrarte en lo que realmente importa.

Empieza a usar MCP

El servidor CircleCI MCP se ejecuta localmente y se integra con una gran variedad de editores y herramientas de desarrollo con LLM.

A continuación se presentan ejemplos de configuración listos para usar que le ayudarán a instalar el servidor MCP en su entorno preferido.

Requisitos previos

Antes de configurar su IDE, asegúrese de contar con lo siguiente:

Token de API personal de CircleCI (PAT):
- Vaya a Configuración de usuario > Tokens de API personales
- Haga clic en Crear nuevo token
- Cópielo y guárdelo en un lugar seguro — lo utilizará como CIRCLECI_TOKEN durante la configuración
Para la instalación con NPX:
- Gestor de paquetes pnpm
- Node.js versión ≥ 18.0.0
Para la instalación con Docker:
- Docker

Instrucciones de configuración

Cursor

Con NPX:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Con Docker:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CIRCLECI_TOKEN",
        "-e", "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Documentación de configuración de Cursor

VS Code

Con NPX:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "Token de la API de CircleCI",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "URL base de CircleCI",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

Con Docker:


{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "Token de la API de CircleCI",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "URL base de CircleCI",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CIRCLECI_TOKEN",
        "-e", "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

Documentación de configuración de VS Code

Claude Desktop

Con NPX:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Con Docker:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CIRCLECI_TOKEN",
        "-e", "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Ubicación del archivo de configuración:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Documentación de configuración de Claude Desktop

Claude Code

Con NPX:


claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

Con Docker:


claude mcp add circleci-mcp-server \
  -e CIRCLECI_TOKEN=your-circleci-token \
  -e CIRCLECI_BASE_URL=https://circleci.com \
  -- docker run --rm -i \
  -e CIRCLECI_TOKEN \
  -e CIRCLECI_BASE_URL \
  circleci/mcp-server-circleci

Documentación de configuración de Claude Code

Windsurf

Con NPX:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Con Docker:


{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "CIRCLECI_TOKEN",
        "-e", "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com"
      }
    }
  }
}

Documentación de configuración de Windsurf

Amazon Q Developer / Kiro

Requisitos previos:

Token de API personal de CircleCI
NPX: Node.js >= v18 y pnpm

Archivos de configuración:
Amazon Q Developer y Kiro CLI almacenan la configuración del cliente MCP en formato JSON. Las rutas de configuración varían según la herramienta que utilice:

Amazon Q Developer:
- Local: .amazonq/agents/default.json
- Global: ~/.aws/amazonq/agents/default.json

Kiro CLI:
- Espacio de trabajo: .kiro/settings/mcp.json
- Global: ~/.kiro/settings/mcp.json

Las rutas de Amazon Q Developer indicadas anteriormente corresponden al agente predeterminado. Si utiliza agentes personalizados, agregue la configuración del servidor MCP al archivo de configuración del agente correspondiente.

Ambas son opcionales. Si existen ambas, la configuración se leerá de las dos. Si el mismo servidor está definido en ambas, se utilizará la configuración local o del espacio de trabajo.

Con NPX (servidor MCP local):

Agregue lo siguiente a su archivo de configuración:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com" // opcional, requerido solo para instalaciones on-premises
      },
      "timeout": 60000
    }
  }
}

Con un servidor MCP remoto autogestionado:

Cree un script contenedor (por ejemplo, circleci-remote-mcp.sh):

#!/bin/bash
export CIRCLECI_TOKEN="your-circleci-token"
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Otórguele permisos de ejecución:

chmod +x circleci-remote-mcp.sh

Agregar el servidor remoto:

Mediante Kiro CLI:

kiro-cli mcp add --name circleci --command "/full/path/to/circleci-remote-mcp.sh"

Mediante la interfaz de configuración de Amazon Q MCP:

Elija el ámbito global o local
Introduzca un nombre de servidor (por ejemplo, circleci-remote-mcp)
Configure el protocolo de transporte: stdio
Configure el comando: la ruta al script contenedor (por ejemplo, /full/path/to/circleci-remote-mcp.sh)
Guarde la configuración

Instalar con Smithery


npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci@latest --client claude

Herramientas disponibles

Desde la aceleración del desarrollo impulsado por IA hasta la orquestación de flujos de trabajo agénticos, cada herramienta expuesta por el servidor MCP proporciona a los desarrolladores de IA contexto CI/CD estructurado para ciclos de lanzamiento más rápidos y fiables.

Herramienta	Usos
`config_helper`	Corregir problemas de configuración antes de que interrumpan el pipeline
`create_prompt_template`	Generar prompts que favorezcan un comportamiento coherente de la IA
`find_flaky_tests`	Identificar y solucionar pruebas inestables
`get_build_failure_logs`	Depurar y resolver builds fallidos más rápidamente
`get_job_test_results`	Analizar y corregir fallos de pruebas y problemas de rendimiento
`get_latest_pipeline_status`	Supervisar el estado del pipeline y actuar en consecuencia
`list_followed_projects`	Encontrar los proyectos que sigue y su `projectSlug`
`recommend_prompt_template_tests`	Probar y mejorar la fiabilidad de los prompts
`rerun_workflow`	Volver a ejecutar flujos de trabajo desde el inicio o desde un trabajo fallido
`run_pipeline`	Lanzar builds sin salir del editor
`run_rollback_pipeline`	Revertir despliegues defectuosos con un único comando

Más información

Comience a usar el servidor CircleCI MCP, explore ejemplos o manténgase al día con las actualizaciones de la plataforma:

Repositorio del proyecto – Código fuente, incidencias y guía de contribución.
MCP Cookbook – Ejemplos de prompts y patrones de uso de herramientas.
Entrada del blog: Presentamos el servidor CircleCI MCP – Contexto de diseño y casos de uso.
Registro de cambios de CircleCI – Consulte las últimas actualizaciones de la plataforma y los lanzamientos de nuevas funciones.

Descripción general

Características

Integraciones

Rol

Casos de uso

Tamaño de la empresa

Desarrolladores

Explorar

Registro de cambios

Beneficios

Comparar

Empresa

Descripción general

Características

Integraciones

Rol

Casos de uso

Tamaño de la empresa

Desarrolladores

Explorar

Registro de cambios

Beneficios

Comparar

Empresa

Servidor MCP de CircleCI

Contexto de CI/CD para herramientas de IA

Convierte los datos de compilación en acciones

Empieza a usar MCP

Requisitos previos

Instrucciones de configuración

Herramientas disponibles

Más información