Conectar el asistente
Conectar Claude a BehaviorOS para que te guíe en la integración y ejecute la configuración por vos
Con la credencial andando, podés hacer el resto de la integración acompañado: un asistente conectado a BehaviorOS que contesta desde esta documentación y la referencia de la API, arma los cambios para tu proyecto y ejecuta la configuración en tu cuenta — siempre con tu aprobación.
Es opcional. Todo lo que hace el asistente se puede hacer también a mano con los pasos que siguen.
Tu administrador te entrega dos datos, uno por ambiente:
- URL del asistente, con la forma
https://<tu-host-del-asistente>/mcp/integration. - Client ID: identifica al asistente frente al inicio de sesión de UIN. No es secreto ni es tu credencial; es el mismo para todas las personas de tu organización.
Qué necesitás
- Un usuario de tu organización en UIN. El asistente no usa la API key: te identificás con tu propio usuario, el mismo con el que entrás al Control Center. Así cada acción queda registrada a tu nombre. Si todavía no tenés usuario, pedíselo a tu administrador.
- Un cliente compatible. Claude (web, Desktop o Claude Code).
Conectarlo
Claude web o Desktop.
- En Configuración → Conectores, agregá un conector personalizado con la URL del asistente.
- En Opciones avanzadas:
- Authentication: Sign in now.
- OAuth client: Use your own OAuth client.
- OAuth client ID: el client ID que te entregaron. Dejá el secret vacío.
- Conectalo. Se abre el inicio de sesión de UIN: entrá con tu usuario.
Claude Code. Desde tu proyecto:
claude mcp add --transport http \
--client-id <tu-client-id> \
--callback-port 8765 \
uin https://<tu-host-del-asistente>/mcp/integrationDespués corré /mcp dentro de Claude Code, elegí uin y autenticá: se abre el navegador para que inicies sesión. El puerto tiene que ser 8765; es el único que el inicio de sesión acepta desde la terminal.
Si no te pide usuario y contraseña, el navegador ya tenía una sesión de UIN abierta y la reutilizó. Para entrar con otro usuario, conectalo desde una ventana privada.
No pegues tu API key en el asistente. No la necesita: tu sesión ya identifica a tu organización, y una key pegada en una conversación es una key expuesta.
Qué puede hacer
| Responder desde la documentación | Cada respuesta trae el link a la página que la respalda. Si algo no está documentado, lo dice en lugar de inventarlo. |
| Leer la referencia de la API | Los endpoints disponibles para una integración, sus parámetros y respuestas. |
| Armar la integración para tu proyecto | Te pregunta lenguaje, framework, cliente HTTP y qué eventos querés reportar, y te devuelve los cambios para tu código. Con los datos incompletos, te pide lo que falta en lugar de suponer. |
| Validar un evento antes de enviarlo | Revisa campos obligatorios, el uso de idType y la clave de idempotencia. |
| Configurar tu cuenta | Crear un código de evento, registrar el endpoint de notificaciones y enviar una notificación de prueba. |
| Probar la integración de punta a punta | Envía un evento real y te muestra qué hizo el motor con él: si llegó, qué misiones avanzó y qué recompensas otorgó. |
Todo lo que cambia algo se propone antes. El asistente te muestra qué va a hacer, dónde, qué efecto tiene y si se puede deshacer, y solo lo ejecuta si lo aprobás. Si lo rechazás, queda registrado y no te lo vuelve a proponer por su cuenta.
Un evento de prueba es un evento real. Puede crear una cuenta, avanzar misiones y otorgar recompensas, y no se deshace. El asistente te lo advierte antes de enviarlo.
Lo que no hace: habilitar capacidades que tu organización no tiene contratadas, ni cambiar nada en producción.
Verificar que funciona
Pedile el estado de tu integración, por ejemplo "¿cuál es el estado de mi integración con UIN?". Te responde qué organización reconoció, qué capacidades están activas y qué falta configurar. Si ves tu organización, la conexión está lista.
Si algo falla
| Lo que ves | Qué significa | Qué hacer |
|---|---|---|
invalid_token | La sesión venció o no es válida. | Desconectá y volvé a conectar el asistente para iniciar sesión de nuevo. |
wrong_token_type | El cliente envió el token equivocado. | Es un problema de configuración del cliente; reconectalo. Si persiste, avisanos. |
integration_tenant_unresolved | Tu usuario no está asociado a ninguna organización. | Pedile a tu administrador que te asocie. |
integration_tenant_not_found | La organización de tu usuario ya no existe. | Contactá a tu representante de UIN. |
identity_provider_unavailable | No se pudo verificar tu sesión en este momento. | Reintentá en unos minutos. |
capability_not_enabled | Tu organización no tiene contratada esa capacidad. | No se habilita desde el asistente: contactá a tu representante de UIN. |
Organizaciones con mTLS
Si tu organización tiene TLS mutuo activo, el asistente completo se usa con inicio de sesión con certificado:
- Instalá en tu navegador (o en el llavero del sistema) el certificado de cliente que tu organización registró en UIN.
- Conectá el asistente con la URL con certificado que te entrega tu administrador — tiene la forma
https://<tu-host-del-asistente>/mcp/integration/gated— y con el client ID de acceso con certificado. - Al conectarlo, el navegador te pide elegir el certificado y después se abre el inicio de sesión de UIN como siempre.
Si el navegador no presenta un certificado registrado y activo, el inicio de sesión se detiene con un mensaje que lo explica.
Una conexión por la URL común, sin certificado, queda limitada a documentación y referencia de la API: el asistente te lo indica al conectarse. Las respuestas de documentación no tocan datos de tu organización, por eso siguen disponibles.
Qué sigue
Con o sin asistente, el paso siguiente es el mismo: Identificar usuarios.