Cómo conectar Bitbucket a Cursor vía MCP

💡 ¿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 + Cursor

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Bitbucket.

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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT