# ur — Documentación de integración

> Plataforma de IA auto-hospedada. Esta documentación cubre qué puede integrar un cliente que ya
> tiene una instalación de `ur`: agentes conversacionales en su producto, una API HTTP para su
> backend, y un servidor MCP para su asistente de IA.

Tres superficies independientes: **agentes** (widget embebible o SDK `@nykk/ur-agent-client`),
**API HTTP** (`/api/*`, token Bearer, servidor a servidor) y **MCP** (`/mcp`, OAuth 2.1,
administración). Las vías soportadas para integrar son esas cuatro: MCP, API, widget y SDK.

## Empezar

- [Qué puedes integrar](/empezar/): las tres superficies y un mapa de decisión para elegir vía.
- [Conceptos](/empezar/conceptos): agente, inferencia, RAG, file source, tool, canal, subject/hilo.
- [Credenciales](/empezar/credenciales): access tokens — crearlos, formato `ur-…`, permisos por recurso, renovación. Solo los necesita la API HTTP.

## Agentes

- [Visión general](/agentes/): qué es un agente y cómo elegir entre widget, SDK y HTTP.
- [Configurar el agente](/agentes/configurar): prompt, modelo, resiliencia, áreas de conocimiento, tools, mensaje automático.
- [Canales](/agentes/canales): `widget` vs `js_sdk`, orígenes permitidos (no son autenticación), el canal `demo`.
- [Seguridad y límites](/agentes/seguridad): cinco filtros de contenido, límites de abuso, y por qué un bloqueo devuelve 200 y no un error.
- [Widget embebible](/agentes/widget): `<script src="/widget.js" data-agent="…">`, atributos, variables CSS, tema automático.
- [SDK — quickstart](/agentes/sdk): `@nykk/ur-agent-client`, instalación y el snippet canónico.
- [SDK — referencia](/agentes/sdk-referencia): `UrAgentClient` y `createChatStore` completos, con todos los tipos.
- [Contexto de cliente](/agentes/contexto-cliente): datos por turno para las tools, agrupados por tool; límite de 4 KB, descarte por namespace, acotar `rag_retrieve`.
- [HTTP sin streaming](/agentes/http): `POST /api/agents/{identifier}/invoke` — un turno completo desde tu backend. No está en el OpenAPI.
- [Ejemplos](/agentes/ejemplos): apps completas en Angular y React.
- [Limitaciones](/agentes/limitaciones): sin autenticación en el canal público, `getAuthHeaders` inerte, contexto no fiable, sin reintentos.

## API HTTP

- [Visión general](/api/): base URL, Bearer, permisos, errores, rate limits, ausencia de CORS, campos solo de administrador, OpenAPI en `/api/docs`.
- [Inferencias](/api/inferencias): ejecutar, recuperar contexto, ficheros indexados, estado de un fichero. `prompt` y `semanticSearch` son cosas distintas.
- [RAGs](/api/rags): listar, buscar, estado, ficheros y gestión de scopes.
- [Webhooks](/api/webhooks): empujar URLs a una fuente web; notificaciones de Google Drive.

## MCP

- [MCP Server](/mcp/): activarlo, conectar un cliente (Claude, Cursor, Claude Code), OAuth 2.1, revocar accesos, `PUBLIC_BASE_URL` tras un proxy.
- [Catálogo de tools](/mcp/tools): las 33 tools por dominio, paginación y annotations.

## Recursos

- [Integrar con un agente de IA](/recursos/con-ia): prompt autocontenido para dárselo a un agente de codificación, más recetas para React, Angular, Vue, Svelte y vanilla.

## Optional

- [@nykk/ur-agent-client](https://www.npmjs.com/package/@nykk/ur-agent-client): el SDK headless en npm.
- [@nykk/ur-agent-widget](https://www.npmjs.com/package/@nykk/ur-agent-widget): el Web Component embebible en npm.