Bitbucket

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General

Conecta tu cuenta de Bitbucket a Nirvai para automatizar la gestión de repositorios, pull requests y webhooks.

Métodos de Autenticación Soportados

• Repository Access Token - Para acceso específico al repositorio
• Workspace Access Token - Para acceso a todo el workspace
• App Password - Método de autenticación alternativo

Requisitos Previos

• Una cuenta de Bitbucket Cloud
• Acceso para crear access tokens o app passwords

Instrucciones de Configuración

Opción 1: Repository Access Token (Recomendado)

1. Inicia sesión en tu cuenta de Bitbucket
2. Navega al repositorio que quieres acceder
3. Ve a Repository settings > Access tokens
4. Haz clic en Create Repository Access Token
5. Ingresa una etiqueta para el token (ej., "Integración Nirvai")
6. Selecciona los scopes requeridos:
   • read:repository - Leer contenido del repositorio
   • write:repository - Hacer push de cambios
   • read:webhook - Leer webhooks
   • write:webhook - Crear/actualizar webhooks
7. Haz clic en Create
8. Copia el token y pégalo en Nirvai

Opción 2: Workspace Access Token

1. Ve a la configuración de tu Workspace
2. Selecciona Access tokens bajo Security
3. Haz clic en Create workspace access token
4. Ingresa una etiqueta y selecciona los scopes requeridos
5. Copia y usa el token en Nirvai

Opción 3: App Password

1. Haz clic en tu avatar > Personal settings
2. Ve a App passwords bajo Security
3. Haz clic en Create app password
4. Ingresa una etiqueta y selecciona permisos
5. Copia el app password
6. Usa tu nombre de usuario de Bitbucket con el app password

Scopes Requeridos

Scope	Descripción	Requerido Para
read:user:bitbucket	Leer información del usuario	Operaciones relacionadas con usuarios
read:workspace:bitbucket	Leer datos del workspace	Acceso al workspace
read:repository:bitbucket	Leer repositorio	Operaciones de repositorio
write:repository:bitbucket	Escribir al repositorio	Push, merge
read:webhook:bitbucket	Leer webhooks	Gestión de webhooks
write:webhook:bitbucket	Crear webhooks	Configuración de webhooks
delete:webhook:bitbucket	Eliminar webhooks	Limpieza de webhooks

Solución de Problemas

Problemas Comunes

• 401 Unauthorized: El token puede estar revocado o expirado. Crea un nuevo token.
• 403 Forbidden: El token carece de permisos requeridos. Verifica la selección de scopes.
• Repositorio no encontrado: Asegúrate de que el token tenga acceso al repositorio específico.
• Rate limiting: Bitbucket tiene límites de tasa de API. Espacia las solicitudes si es necesario.

Token vs App Password

• Access Tokens: Con scope a repositorio o workspace, más seguros
• App Passwords: A nivel de cuenta, requiere nombre de usuario para autenticación

Recursos Relacionados

• Documentación de Access Tokens de Bitbucket
• App Passwords de Bitbucket
• Documentación de la API REST de Bitbucket

---

Adaptado de la documentación de n8n para la plataforma Nirvai

---

Siguientes Pasos

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.