Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Bitbucket con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
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.
Prueba a pedir
Prompts de ejemplo para Bitbucket
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Claude
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
- 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. - Ponle un nombre al token (por ejemplo AnythingMCP), elige una fecha de caducidad y selecciona la app Bitbucket.
- Marca los scopes de lectura
read:user:bitbucket,read:workspace:bitbucket,read:repository:bitbucket,read:pullrequest:bitbucketyread:pipeline:bitbucket. Añadewrite:pullrequest:bitbucketpara crear, comentar, aprobar y fusionar pull requests, ywrite:pipeline:bitbucketpara lanzar pipelines. - Copia el token (empieza por
ATATT) y pégalo enBITBUCKET_API_TOKENsin 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. - Comprueba la configuración con
bitbucket_get_current_usery luego conbitbucket_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 Claude
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 muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Bitbucket, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
bitbucket_get_current_user | Get the Bitbucket account the token belongs to: display name, nickname, uuid, account_id and profile link |
bitbucket_list_workspaces | List the workspaces the token's user belongs to: slug, name, uuid and whether the user is an administrator there |
bitbucket_list_repositories | List repositories in a workspace, most recently updated first: full_name, slug, description, private flag, language, main branch, project… |
bitbucket_get_repository | Get one repository: description, main branch, project, privacy, language, size, fork parent, clone URLs and web link |
bitbucket_list_branches | List branches of a repository with the latest commit of each (hash, date, message, author) |
bitbucket_list_commits | List commits newest first: hash, date, message, author and parents |
bitbucket_get_commit | Get one commit: full hash, date, full message, author, parents and web link |
bitbucket_get_file | Read a file or list a folder at a commit or branch |
bitbucket_list_pull_requests | List pull requests of a repository, open ones by default: id, title, state, draft, author, source and destination branch, comment and task… |
bitbucket_get_pull_request | Get one pull request: title, description, state, branches and commits, merge commit, reviewers and participants with their approval state… |
bitbucket_get_pull_request_diffstat | List the files a pull request changes: status (added, removed, modified, renamed), old and new path, lines added and removed |
bitbucket_get_pull_request_diff | Read the unified diff of a pull request as plain text |
bitbucket_list_pull_request_commits | List the commits a pull request contains, newest first: hash, date, message and author |
bitbucket_list_pull_request_comments | List comments on a pull request, oldest first: id, author, text, inline position (file and line) for code comments, parent id for replies… |
bitbucket_create_pull_request | Open a pull request from a source branch into a destination branch of the same repository, as the token's user |
bitbucket_add_pull_request_comment | Post a comment on a pull request as the token's user: a general comment, a reply (parent) or a code comment on a line (inline) |
bitbucket_approve_pull_request | Approve a pull request as the token's user |
bitbucket_merge_pull_request | Merge an open pull request into its destination branch |
bitbucket_list_pipelines | List Bitbucket Pipelines runs of a repository, newest first: uuid, build number, state (PENDING, IN_PROGRESS, COMPLETED), result… |
bitbucket_get_pipeline | Get one pipeline run: state, result, branch or tag, commit, custom pipeline name, trigger, creator, start, end and duration |
bitbucket_list_pipeline_steps | List the steps of a pipeline run: uuid, name, state, result, start, end, duration, build image name and script command names |
bitbucket_get_pipeline_step_log | Read the log of one pipeline step as plain text |
bitbucket_run_pipeline | Start a Bitbucket Pipelines run on a branch or tag, optionally a custom pipeline from bitbucket-pipelines.yml |
bitbucket_list_environments | List the deployment environments of a repository (for example Test, Staging, Production): uuid, name, type, rank and lock state |
bitbucket_list_deployments | List deployments of a repository: environment uuid, state (UNDEPLOYED, IN_PROGRESS, COMPLETED), status (SUCCESSFUL, FAILED, STOPPED), who… |
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
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
¿Te ha sido útil esta guía?