GitLab

¿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 GitLab a Nirvai para automatizar la gestión de repositorios, issues, merge requests y pipelines de CI/CD.

Métodos de Autenticación Soportados

• Personal Access Token (PAT) - Recomendado para la mayoría de casos de uso
• Soporta tanto GitLab.com como instancias self-hosted de GitLab

Requisitos Previos

• Una cuenta de GitLab (GitLab.com o self-hosted)
• Acceso para crear Personal Access Tokens

Instrucciones de Configuración

Personal Access Token (Recomendado)

1. Inicia sesión en tu cuenta de GitLab
2. Haz clic en tu avatar en la esquina superior derecha
3. Selecciona Edit profile
4. En la barra lateral izquierda, selecciona Access tokens
5. Haz clic en Add new token
6. Ingresa un nombre descriptivo (ej., "Integración Nirvai")
7. Establece una fecha de expiración (opcional pero recomendado)
8. Selecciona los scopes requeridos:
   • api - Acceso completo a la API (requerido para la mayoría de operaciones)
   • read_user - Leer información del perfil de usuario
   • read_repository - Leer datos del repositorio
9. Haz clic en Create personal access token
10. Copia el token inmediatamente (no se mostrará de nuevo)
11. En Nirvai, ingresa:
    • GitLab Server URL: https://gitlab.com (o tu URL self-hosted)
    • Token: Pega tu Personal Access Token

Para GitLab Self-Hosted

Si estás usando una instancia self-hosted de GitLab:

1. Usa la URL de tu servidor GitLab (ej., https://gitlab.tuempresa.com)
2. Asegúrate de que tu servidor permita acceso a la API
3. El proceso de creación del token es el mismo que en GitLab.com

Scopes Requeridos

Scope	Descripción	Requerido Para
api	Acceso completo a la API	Mayoría de operaciones
read_user	Leer info de usuario	Acciones relacionadas con usuarios
read_repository	Leer repos	Acceso a repositorios
write_repository	Escribir en repos	Push, operaciones de merge

Solución de Problemas

Problemas Comunes

• 401 Unauthorized: El token puede estar expirado o inválido. Genera un nuevo token.
• 403 Forbidden: El token puede carecer de scopes requeridos. Verifica los permisos de scope.
• Error de Conexión (Self-hosted): Verifica que la URL del servidor sea correcta y accesible.
• Error de Certificado SSL: Asegúrate de que tu servidor self-hosted tenga certificados SSL válidos.

Expiración del Token

Los Personal Access Tokens pueden tener fechas de expiración. Si tu integración deja de funcionar:

1. Verifica si tu token ha expirado
2. Genera un nuevo token con expiración apropiada
3. Actualiza la credencial en Nirvai

Recursos Relacionados

• Documentación de Personal Access Tokens de GitLab
• Documentación de la API de GitLab
• Referencia de la API REST de GitLab

---

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.