Collegare Bitbucket a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Bitbucket.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse