Come collegare Zenhub a Cursor — via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Zenhub, inserisci le credenziali, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale.

Zenhub + Cursor

Lavora con le board di Zenhub da un agente AI tramite la GraphQL API: workspace, pipeline e le issue al loro interno, dettagli delle issue, sprint e relative issue, epic e relative issue figlie, stime; sposta issue, imposta stime, pianifica sprint, crea issue e commenta. 17 tool tipizzati più un tool di query generico, chiave API personale.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ZENHUB_API_KEY

Step 1 — Ottieni le credenziali

Il connettore dialoga con la Zenhub GraphQL API tramite una chiave API personale. La chiave agisce come il suo utente: workspace e repository che quell'utente non vede mancano da ogni risultato.

1. In Zenhub apri la sezione API della dashboard (https://app.zenhub.com/settings/tokens) e crea una Personal API Key per la GraphQL API. Un utente può avere fino a 5 chiavi.
2. Copia subito la chiave (viene mostrata una sola volta) e inseriscila in ZENHUB_API_KEY senza Bearer davanti. Un vecchio token REST qui non funziona.
3. Chiama zenhub_get_viewer per verificare la chiave, trova un workspace con zenhub_search_workspaces, poi leggi la board con zenhub_list_pipelines e zenhub_list_pipeline_issues.

Da sapere:

• Ogni chiave ha 90 secondi di elaborazione al minuto e al massimo 30 richieste contemporanee, e una query non può superare 200 punti di complessità. Per questo i tool di elenco restituiscono 10-30 elementi di default; pagina con after impostato a pageInfo.endCursor.
• Gli id di Zenhub sono stringhe opache. I tool di scrittura vogliono l'id Zenhub della issue, non il suo numero.
• Per ciò che i tool tipizzati non coprono (release, roadmap, dipendenze, priorità, label) usa zenhub_graphql_query o zenhub_graphql_mutation.
• zenhub_move_issue, zenhub_set_estimate, zenhub_add_issues_to_sprints, zenhub_create_issue e zenhub_add_comment modificano la board o pubblicano contenuti visibili al team.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Zenhub.

Tool disponibili

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Gemini
• Collega a Meta Muse