Conectar SonarQube MCP con ChatGPT: quality gates

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → SonarQube, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

SonarQube + ChatGPT

Deja que tu IA lea SonarQube: proyectos, estado del quality gate, métricas como la cobertura y su histórico, incidencias abiertas por severidad y calidad del software, análisis y ramas. SonarQube Server o SonarQube Cloud, solo lectura, con un token de usuario.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

SONARQUBE_URL, SONARQUBE_TOKEN

Paso 1 — Obtén las credenciales

La configuración lleva unos 3 minutos. Necesitas un SonarQube Server (la Community Build gratuita sirve) o una cuenta de SonarQube Cloud con al menos un proyecto analizado, y un token de usuario.

1. Define SONARQUBE_URL, sin /api y sin barra final: https://sonarcloud.io para SonarQube Cloud en la región de la UE, https://sonarqube.us para SonarQube Cloud en la región de EE. UU., o la dirección de tu SonarQube Server tal como la abres en el navegador, incluida cualquier ruta de contexto (por ejemplo https://sonar.example.com o https://example.com/sonarqube).
2. Crea un token de usuario y pégalo en SONARQUBE_TOKEN, sin la palabra Bearer. En Server: avatar → My Account → Security, y genera un token de tipo User. En Cloud: avatar → My Account → Access tokens → Personal Tokens, y genera un token. Los tokens de análisis de proyecto y globales sirven para ejecutar escaneos y no funcionan con la Web API.
3. En SonarQube Cloud, define SONARQUBE_ORGANIZATION con la clave de tu organización, que aparece en la URL sonarcloud.io/organizations/<key>. Cloud la necesita para listar proyectos y buscar incidencias. En Server, déjala vacía.
4. Instala el conector y ejecuta sonarqube_list_projects: lista los proyectos que el token puede explorar, con las claves de proyecto que usan las demás herramientas.

Qué lee: si un proyecto superó su quality gate (OK o ERROR, con cada condición que falla), métricas actuales como coverage, duplicated_lines_density, ncloc y los recuentos de incidencias software_quality_*, cómo han cambiado esas métricas de un análisis a otro, incidencias filtradas por calidad del software (SECURITY, RELIABILITY, MAINTAINABILITY), severidad y estado, los análisis del proyecto con sus eventos, y sus ramas con su último análisis y el estado del gate. Las 7 herramientas son de solo lectura, y el token decide qué proyectos ve la IA.

Proyectos y ramas: las herramientas toman la clave del proyecto (por ejemplo payments-api, o my-org_payments-api en Cloud), no el nombre visible. Sin branch ni pullRequest leen la rama principal. La Community Build analiza solo la rama principal.

Red privada: en un AnythingMCP autoalojado, un SonarQube Server en un host interno o con una IP privada necesita que ese host esté en SSRF_ALLOWED_HOSTS; de lo contrario, la protección de salida rechaza la llamada. AnythingMCP Cloud solo puede acceder a SonarQube Cloud o a un SonarQube Server accesible desde internet público.

Límites: las herramientas de listado devuelven hasta 500 elementos por página (1.000 para sonarqube_get_measures_history). La búsqueda de incidencias devuelve como máximo 10.000 resultados en total, así que acota los filtros en lugar de paginar más. SonarQube Cloud responde con 429 cuando un token envía demasiadas solicitudes: espera unos minutos y vuelve a intentarlo. SonarQube Server no tiene límite de velocidad por defecto.

Errores comunes: 401 significa que el token es incorrecto, ha caducado o se ha revocado, o que es un token de análisis en lugar de un token de usuario. 403 significa que el usuario del token no tiene el permiso Browse sobre el proyecto. 404 significa que la clave del proyecto, la rama o la pull request no existe, o que SONARQUBE_URL es incorrecta. 400 indica el parámetro que falta o no es válido, por ejemplo una organización ausente en Cloud.

El conector no modifica nada en SonarQube (sin transiciones de incidencias, asignaciones ni comentarios, sin cambios en quality gates, perfiles de calidad, proyectos o tokens), y no cubre security hotspots, portfolios y aplicaciones, Web API v2, endpoints de administración y de sistema, ni filtros de incidencias solo de código nuevo.

Paso 2 — Instala el adaptador

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ñade el conector en ChatGPT

La URL de tu servidor: en AnythingMCP, abre MCP Servers → el servidor en el que está este conector, y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestre YOUR_SERVER_ID.

ChatGPT añade los servidores MCP como plugins en su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio de trabajo Business solo pueden añadirlo los administradores y propietarios; en Enterprise y Edu, un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, haz clic en Add y después en Add custom MCP server.
2. Introduce un nombre, p. ej. Name: SonarQube.
3. En Connection, introduce la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT te lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales, luego escribe @ en un chat y elígelo.

Herramientas disponibles

Preguntas frecuentes

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para planes de pago; el plan Free no figura en su lista.

Próximos pasos

• Página del conector
• Conectar con Claude