# CaosLab Agent Authentication & Registration (Auth.md)

> Guía de autenticación y registro programático para agentes autónomos de Inteligencia Artificial en CaosLab.

## 1. Visión General
CaosLab expone herramientas, APIs de consulta de servicios, casos de éxito e integración de proyectos que pueden ser invocados por agentes de IA autónomos (ChatGPT, Claude, Perplexity, LangChain, CrewAI, AutoGen, etc.).

- **Servidor Base:** `https://caoslab.dev/api`
- **Catálogo de APIs:** `https://caoslab.dev/.well-known/api-catalog`
- **MCP Server Card:** `https://caoslab.dev/.well-known/mcp/server-card.json`
- **Agent Skills Index:** `https://caoslab.dev/.well-known/agent-skills/index.json`
- **Discovery OAuth / OIDC:** `https://caoslab.dev/.well-known/oauth-authorization-server`

## 2. Métodos de Autenticación para Agentes

### A. Acceso Público (Lectura Libre)
Los agentes pueden consultar sin credenciales los siguientes recursos:
- `GET /api/health` — Estado operativo de la API.
- `GET /api/services` — Lista de servicios técnicos de CaosLab.
- `GET /llms.txt` — Ontología semántica directa.
- `GET /.well-known/mcp/server-card.json` — Definición de capacidades Model Context Protocol.

### B. Registro y Envío de Inquiries / Acciones B2B
Para registrar solicitudes de proyectos o ejecutar llamadas transaccionales:
1. **Header de Identificación de Agente:**
   ```http
   User-Agent: YourAgentName/1.0 (+https://your-agent-domain.com; agent-id: uuid)
   Accept: application/json, text/markdown
   ```
2. **Bearer Token (Opcional para partners):**
   ```http
   Authorization: Bearer <CAOSLAB_AGENT_TOKEN>
   ```

## 3. Scopes Soportados
- `read:services`: Permite leer capacidades, tarifas estimadas y documentación.
- `write:inquiries`: Permite registrar leads y solicitudes de contacto empresarial.
- `agent:execute`: Ejecución de herramientas mediante WebMCP o Model Context Protocol.

## 4. Contacto Técnico y Soporte de Integración
- WhatsApp Directo: [+52 627 889 3344](https://wa.me/526278893344)
- Dominio Oficial: [https://caoslab.dev](https://caoslab.dev)