Come collegare Bitbucket a Cursor via MCP

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

Bitbucket + Cursor

Fai lavorare la tua AI in Bitbucket Cloud: esplora repository, branch, commit e file, rivedi pull request con diff e commenti, approva, commenta e fai il merge dopo la tua conferma, e controlla le esecuzioni di Bitbucket Pipelines, i log degli step e i deployment.

Prerequisiti

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

BITBUCKET_API_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a https://id.atlassian.com/manage-profile/security/api-tokens (Security → API tokens nel tuo account Atlassian) e fai clic su Create API token with scopes.
2. Dai un nome al token (per esempio AnythingMCP), scegli una data di scadenza e seleziona l'app Bitbucket.
3. Spunta gli scope di lettura read:user:bitbucket, read:workspace:bitbucket, read:repository:bitbucket, read:pullrequest:bitbucket e read:pipeline:bitbucket. Aggiungi write:pullrequest:bitbucket per creare, commentare, approvare e fare il merge delle pull request, e write:pipeline:bitbucket per avviare le pipeline.
4. Copia il token (inizia con ATATT) e incollalo in BITBUCKET_API_TOKEN senza la parola Bearer, poi installa il connettore. Il connettore lo invia come token Bearer, quindi la tua email Atlassian non serve.
5. Verifica la configurazione con bitbucket_get_current_user e poi con bitbucket_list_workspaces.

Le app password non funzionano più: Bitbucket ha smesso di crearle il 9 settembre 2025 e ha disattivato quelle rimaste il 28 luglio 2026. Usa un API token con scope come sopra. Nello stesso campo funziona anche un access token di repository, progetto o workspace (Repository settings → Access tokens; i token di progetto e di workspace richiedono un piano Premium), che però agisce come un bot limitato a quel repository, progetto o workspace: bitbucket_get_current_user e bitbucket_list_workspaces possono essere rifiutati, e tutto ciò che è fuori dalla sua portata risponde 403 o 404.

Chi vede cosa: l'AI agisce come l'utente a cui appartiene il token e vede e modifica esattamente ciò che quell'utente e gli scope spuntati consentono. Senza i due scope di scrittura il token resta in sola lettura.

Modifica branch reali e raggiunge il tuo team, quindi l'AI chiede prima: bitbucket_create_pull_request apre una pull request a tuo nome (il branch di origine deve essere già pushato). bitbucket_add_pull_request_comment pubblica un commento generale, una risposta o un commento al codice su una riga, che tutti i partecipanti alla pull request vedono e di cui possono ricevere una notifica. bitbucket_approve_pull_request aggiunge la tua approvazione, che conta per i merge check. bitbucket_merge_pull_request cambia il branch di destinazione per tutti, può avviare pipeline di deployment e, con close_source_branch, elimina il branch di origine; prima l'AI controlla stato e approvazioni con bitbucket_get_pull_request. bitbucket_run_pipeline consuma minuti di build ed esegue tutto ciò che fa la pipeline, step di deploy compresi. Prima di ognuna di queste azioni l'AI ti indica repository, branch, pull request e strategia di merge o pipeline e aspetta il tuo sì. All'installazione non è disattivato nulla, e nessuno strumento elimina repository, branch o commenti, a parte il branch di origine in un merge con close_source_branch.

Come lavorare: bitbucket_list_workspaces fornisce lo slug del workspace e bitbucket_list_repositories quello del repository; entrambi compaiono nell'indirizzo bitbucket.org/<workspace>/<repo>. Codice: bitbucket_get_repository (branch principale), bitbucket_list_branches, bitbucket_list_commits, bitbucket_get_commit e bitbucket_get_file (il testo di un file o il contenuto di una cartella). Review: bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_get_pull_request_diffstat per l'entità della modifica, poi bitbucket_get_pull_request_diff, bitbucket_list_pull_request_commits e bitbucket_list_pull_request_comments. Deployment: bitbucket_list_environments e bitbucket_list_deployments.

Pipeline: bitbucket_list_pipelines, poi bitbucket_get_pipeline, bitbucket_list_pipeline_steps e bitbucket_get_pipeline_step_log per lo step fallito. Gli uuid di pipeline e step contengono parentesi graffe; l'AI li passa esattamente come vengono restituiti. I log degli step oltre i 200 KB vengono troncati e mantengono l'inizio, mentre l'errore di solito è alla fine; per i log lunghi l'AI legge quindi la parte finale con un intervallo come bytes=-150000 (gli ultimi 150 KB). Anche diff e file vengono troncati a 200 KB.

Elenchi e filtri: una risposta a elenco contiene next quando c'è un'altra pagina; l'AI richiama con page (un numero per la maggior parte degli elenchi, un token opaco per i commit), e pagelen imposta la dimensione della pagina. q accetta il linguaggio di query di Bitbucket, per esempio name ~ "api" o destination.branch.name = "main".

Niente issue né wiki: Bitbucket ha rimosso il suo issue tracker integrato e il wiki il 20 agosto 2026 (l'API risponde 410), quindi questo connettore non ha strumenti per loro. Per le issue aggiungi un connettore Jira.

Errori comuni: 401: il token è errato, scaduto o revocato, oppure è una vecchia app password; crea un API token con scope. 403: manca uno scope (il messaggio lo indica) o l'utente non ha il permesso. 404: il workspace, il repository o l'elemento non esiste, oppure il token non può vederlo. 429: è stato raggiunto il limite orario; attendi e riprova.

Il connettore non copre la creazione o l'eliminazione di repository e branch, la modifica di file o il push di commit, il rifiuto di pull request, l'arresto delle pipeline, le variabili e le impostazioni dei repository né l'amministrazione.

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

Tool disponibili

Esempi di prompt

• "Quali pull request in acme/gestionale sono ancora aperte, chi le ha aperte e quali non hanno ancora un'approvazione?"
• "Rivedi la pull request #42 in gestionale: riassumi i file modificati, segnala le modifiche rischiose ed elenca i commenti di review ancora aperti."
• "Perché è fallita l'ultima pipeline su main? Leggi il log dello step fallito e mostrami l'errore."
• "Fai il merge della pull request #42 in main con squash quando ha due approvazioni. Mostrami prima branch e strategia di merge e chiedimi conferma prima di procedere."
• "Qual è l'ultimo deployment su Production, quando è stato fatto, da chi e quale commit ha rilasciato?"

FAQ

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

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT