# auth.md — Acceso de asistentes a OpoSERGAS

Esta guía se dirige a asistentes que consultan los recursos públicos de `https://oposergas.com`. Las consultas públicas funcionan sin registro, autenticación, claves o cookies. No existe un flujo de registro de agentes ni una delegación de cuentas personales mediante OAuth/WorkOS auth.md.

## 1. Descubrir los recursos públicos

Consulta el [catálogo de API](https://oposergas.com/.well-known/api-catalog) y la [documentación de integración](https://oposergas.com/docs/agent-api). El catálogo permite localizar categorías, guías públicas y páginas de consulta.

```http
GET /agent-api/v1/catalog?category=tcae-sergas HTTP/1.1
Host: oposergas.com
Accept: application/json
```

La respuesta incluye la categoría solicitada y enlaces públicos. Los códigos admitidos están enumerados en [OpenAPI](https://oposergas.com/agent-api/openapi.json). No se aceptan URLs arbitrarias ni identificadores de estudiantes.

## 2. Elegir una conexión pública

- REST: `GET https://oposergas.com/agent-api/v1/catalog`, con filtro opcional `category`.
- MCP: `POST https://oposergas.com/mcp`, mediante un cliente compatible con Streamable HTTP público. Consulta la [ficha MCP](https://oposergas.com/mcp/server-card) para conocer las versiones y herramientas.
- A2A: consulta la [Agent Card](https://oposergas.com/.well-known/agent-card.json) y utiliza la interfaz y versión que anuncia. El servicio localiza recursos públicos y devuelve la guía de integración.

No envíes `Authorization`, credenciales, correos personales, cookies de sesión, historiales de estudio ni otros datos personales a estas conexiones. Omitir autenticación no permite saltarse los permisos del área de estudio.

## 3. Registro, credenciales y revocación

Estas consultas no crean cuentas o registros de agentes ni emiten tokens. No hay endpoints de registro, intercambio de credenciales o revocación para estas interfaces públicas. No fabriques solicitudes a `/agent/identity` o a endpoints OAuth a partir de ejemplos de otros servicios.

No se publican metadatos de un servidor OAuth propio ni de un recurso OAuth protegido. Este documento describe el acceso público que funciona actualmente; no anuncia implementación del protocolo de registro de WorkOS.

## 4. Área personal de estudio

Los tests, simulacros, supuestos, preguntas restringidas, documentos, resultados, soporte y facturación utilizan la cuenta personal en la web y los permisos del plan. Estas interfaces públicas no permiten leerlos ni modificarlos y no ofrecen acceso delegado en nombre de un opositor.

Para estudiar, la persona puede entrar en [OpoSERGAS](https://oposergas.com/). Para solicitar una integración adicional, utiliza [Contacto](https://oposergas.com/contacto). Consulta las condiciones publicadas en [Planes y precios](https://oposergas.com/precios) y los enlaces legales de la web.

## 5. Errores y exactitud

Un código de categoría no reconocido devuelve HTTP 400. Un método HTTP no admitido devuelve 405. Los protocolos MCP y A2A devuelven sus errores JSON-RPC documentados. No respondas a estos errores intentando usar las credenciales personales del estudiante.

Cita las páginas concretas consultadas. Para fechas, plazas, requisitos y estructura de un examen, contrasta las bases o resoluciones del organismo convocante: el directorio público no sustituye esas fuentes.
