Conectar Bitbucket MCP con Microsoft Copilot

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

Bitbucket + Microsoft Copilot

Deja que tu IA trabaje en Bitbucket Cloud: explora repositorios, ramas, commits y archivos, revisa pull requests con diffs y comentarios, aprueba, comenta y fusiona después de que lo confirmes, y consulta las ejecuciones de Bitbucket Pipelines, los logs de los pasos y los despliegues.

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:

BITBUCKET_API_TOKEN

Paso 1 — Obtener credenciales

1. Inicia sesión en https://id.atlassian.com/manage-profile/security/api-tokens (Security → API tokens en tu cuenta de Atlassian) y haz clic en Create API token with scopes.
2. Ponle un nombre al token (por ejemplo AnythingMCP), elige una fecha de caducidad y selecciona la app Bitbucket.
3. Marca los scopes de lectura read:user:bitbucket, read:workspace:bitbucket, read:repository:bitbucket, read:pullrequest:bitbucket y read:pipeline:bitbucket. Añade write:pullrequest:bitbucket para crear, comentar, aprobar y fusionar pull requests, y write:pipeline:bitbucket para lanzar pipelines.
4. Copia el token (empieza por ATATT) y pégalo en BITBUCKET_API_TOKEN sin la palabra Bearer; después instala el conector. El conector lo envía como token Bearer, así que no hace falta tu correo de Atlassian.
5. Comprueba la configuración con bitbucket_get_current_user y luego con bitbucket_list_workspaces.

Las app passwords ya no funcionan: Bitbucket dejó de crearlas el 9 de septiembre de 2025 y desactivó las que quedaban el 28 de julio de 2026. Usa un API token con scopes como arriba. Un access token de repositorio, proyecto o workspace (Repository settings → Access tokens; los tokens de proyecto y de workspace necesitan un plan Premium) también funciona en el mismo campo, pero actúa como un bot limitado a ese repositorio, proyecto o workspace: bitbucket_get_current_user y bitbucket_list_workspaces pueden ser rechazados, y todo lo que quede fuera de su alcance responde 403 o 404.

Quién ve qué: la IA actúa como el usuario dueño del token y ve y cambia exactamente lo que ese usuario y los scopes marcados permiten. Sin los dos scopes de escritura, el token queda en solo lectura.

Cambia ramas reales y llega a tu equipo, así que la IA pregunta antes: bitbucket_create_pull_request abre una pull request en tu nombre (la rama de origen ya tiene que estar subida). bitbucket_add_pull_request_comment publica un comentario general, una respuesta o un comentario de código en una línea, que todos los participantes de la pull request ven y del que pueden recibir aviso. bitbucket_approve_pull_request añade tu aprobación, que cuenta para los merge checks. bitbucket_merge_pull_request cambia la rama de destino para todos, puede lanzar pipelines de despliegue y, con close_source_branch, borra la rama de origen; antes, la IA comprueba el estado y las aprobaciones con bitbucket_get_pull_request. bitbucket_run_pipeline gasta minutos de build y ejecuta todo lo que haga la pipeline, pasos de despliegue incluidos. Antes de cada una, la IA te indica el repositorio, las ramas, la pull request y la estrategia de merge o la pipeline, y espera tu sí. No hay nada desactivado al instalar, y ninguna herramienta borra repositorios, ramas ni comentarios, salvo la rama de origen en un merge con close_source_branch.

Cómo trabajar: bitbucket_list_workspaces da el slug del workspace y bitbucket_list_repositories el del repositorio; ambos aparecen en la dirección bitbucket.org/<workspace>/<repo>. Código: bitbucket_get_repository (rama principal), bitbucket_list_branches, bitbucket_list_commits, bitbucket_get_commit y bitbucket_get_file (el texto de un archivo o el contenido de una carpeta). Revisiones: bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_get_pull_request_diffstat para ver el tamaño del cambio, y después bitbucket_get_pull_request_diff, bitbucket_list_pull_request_commits y bitbucket_list_pull_request_comments. Despliegues: bitbucket_list_environments y bitbucket_list_deployments.

Pipelines: bitbucket_list_pipelines, después bitbucket_get_pipeline, bitbucket_list_pipeline_steps y bitbucket_get_pipeline_step_log para el paso que falló. Los uuid de pipelines y pasos llevan llaves; la IA los pasa tal como llegan. Los logs de pasos de más de 200 KB se cortan y conservan el principio, pero el error suele estar al final, así que en logs largos la IA lee el final con un rango como bytes=-150000 (los últimos 150 KB). Los diffs y los archivos también se cortan a 200 KB.

Listas y filtros: una respuesta de lista trae next cuando hay otra página; la IA vuelve a llamar con page (un número en la mayoría de las listas, un token opaco en los commits), y pagelen fija el tamaño de página. q admite el lenguaje de consulta de Bitbucket, por ejemplo name ~ "api" o destination.branch.name = "main".

Sin issues ni wikis: Bitbucket eliminó su gestor de incidencias integrado y su wiki el 20 de agosto de 2026 (la API responde 410), así que este conector no tiene herramientas para ellos. Para las incidencias, añade un conector de Jira.

Errores comunes: 401: el token es incorrecto, ha caducado o se revocó, o es una app password antigua; crea un API token con scopes. 403: falta un scope (el mensaje lo nombra) o el usuario no tiene permiso. 404: el workspace, el repositorio o el elemento no existe, o el token no puede verlo. 429: se alcanzó el límite por hora; espera y vuelve a intentarlo.

El conector no cubre crear ni borrar repositorios y ramas, editar archivos ni subir commits, rechazar pull requests, detener pipelines, las variables y la configuración de los repositorios ni la administración.

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

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Bitbucket.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pull requests de acme/tienda-web siguen abiertas, quién las abrió y cuáles no tienen todavía ninguna aprobación?"
• "Revisa la pull request #42 de tienda-web: resume los archivos cambiados, señala los cambios arriesgados y enumera los comentarios de revisión pendientes."
• "¿Por qué falló la última pipeline en main? Lee el log del paso que falló y muéstrame el error."
• "Fusiona la pull request #42 en main con squash cuando tenga dos aprobaciones. Muéstrame antes las ramas y la estrategia de merge y pregúntame antes de fusionar."
• "¿Qué se desplegó por última vez en Production, cuándo, quién lo hizo y qué commit se publicó?"

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse