Cómo conectar Zenhub a Cursor — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Zenhub, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Zenhub + Cursor

Trabaja con tableros de Zenhub desde un agente de IA a través de la GraphQL API: workspaces, pipelines y sus issues, detalles de issues, sprints y sus issues, epics y sus issues hijas, estimaciones; mueve issues, fija estimaciones, planifica sprints, crea issues y comenta. 17 herramientas tipadas más una herramienta de consulta genérica, clave API personal.

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:

ZENHUB_API_KEY

Paso 1 — Obtener credenciales

El conector habla con la Zenhub GraphQL API con una clave API personal. La clave actúa como su usuario: los workspaces y repositorios que ese usuario no ve faltan en todos los resultados.

1. En Zenhub abre la sección API del panel (https://app.zenhub.com/settings/tokens) y crea una Personal API Key para la GraphQL API. Un usuario puede tener hasta 5 claves.
2. Copia la clave enseguida (solo se muestra una vez) y pégala en ZENHUB_API_KEY sin Bearer delante. Un token REST antiguo no sirve aquí.
3. Llama a zenhub_get_viewer para comprobar la clave, busca un workspace con zenhub_search_workspaces y luego lee el tablero con zenhub_list_pipelines y zenhub_list_pipeline_issues.

Conviene saber:

• Cada clave tiene 90 segundos de procesamiento por minuto y como mucho 30 peticiones simultáneas, y una consulta no puede superar 200 puntos de complejidad. Por eso las herramientas de listado devuelven de 10 a 30 elementos por defecto; pagina con after igual a pageInfo.endCursor.
• Los ids de Zenhub son cadenas opacas. Las herramientas de escritura necesitan el id Zenhub de la issue, no su número.
• Para lo que no cubren las herramientas tipadas (releases, roadmaps, dependencias, prioridades, etiquetas), usa zenhub_graphql_query o zenhub_graphql_mutation.
• zenhub_move_issue, zenhub_set_estimate, zenhub_add_issues_to_sprints, zenhub_create_issue y zenhub_add_comment cambian el tablero o publican contenido que ve el equipo.

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 Zenhub.

Herramientas disponibles

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
• Conectar a Gemini
• Conectar a Meta Muse