Conectar un asistente a los recursos públicos
Encuentra categorías, guías y enlaces de consulta desde una aplicación compatible. Las tres conexiones consultan el mismo directorio público y no necesitan una cuenta.
API REST
Para aplicaciones que consultan JSON por HTTP.
GET /agent-api/v1/catalog
MCP
En un cliente compatible con Streamable HTTP público, añade https://oposergas.com/mcp. Permite consultar las categorías y leer esta guía.
A2A
Para asistentes compatibles que envían mensajes al directorio y reciben recursos públicos. La Agent Card describe las operaciones y la versión admitida.
Acceso y límites
Estas conexiones no acceden a tu cuenta, preguntas de estudio, resultados, soporte o pagos. Para estudiar, utiliza tu cuenta habitual en la web.
Guía de acceso para asistentes · Solicitar ayuda con una integración
Guía completa de integración
# Recursos públicos de OpoSERGAS para asistentes OpoSERGAS es una plataforma de preparación de oposiciones. Este servicio permite encontrar las guías públicas de sus categorías y las páginas de consulta. La fuente de las convocatorias es el organismo oficial correspondiente; una guía de preparación no sustituye sus bases o resoluciones. ## Consultar categorías `GET https://oposergas.com/agent-api/v1/catalog` Devuelve JSON con `categories`, `resources` y los límites de acceso. Cada categoría contiene `code`, `name`, `url` y `syllabus_url`. No requiere registro, claves ni cookies. Puedes filtrar con `?category=tcae-sergas`; un código desconocido devuelve HTTP 400. Los códigos disponibles son `celador-sergas`, `enfermeria-sergas`, `tcae-sergas`, `sergas-ti`, `sergas-aux-admin`, `psx-sergas` y `pir`. Ejemplo de consulta: `/agent-api/v1/catalog?category=tcae-sergas`. Sigue los enlaces de la respuesta para leer la información publicada. Los precios, plazas, fechas de examen y cifras del banco no se fijan en este catálogo: compruébalos en su página específica y en la resolución oficial cuando corresponda. ## Formatos y descubrimiento - [Especificación OpenAPI 3.1](https://oposergas.com/agent-api/openapi.json). - [Catálogo de API, RFC 9727](https://oposergas.com/.well-known/api-catalog). - [Estado de este servicio de metadatos](https://oposergas.com/agent-api/v1/status). Comprueba exclusivamente este servicio, sin diagnosticar pagos, correo o base de datos. - [Índice de instrucciones para asistentes](https://oposergas.com/.well-known/agent-skills/index.json). - [Manifiesto ARD](https://oposergas.com/.well-known/ard.json). - [Ficha del servidor MCP público](https://oposergas.com/mcp/server-card). - [Agent Card del directorio A2A](https://oposergas.com/.well-known/agent-card.json). - [Guía de acceso de asistentes](https://oposergas.com/auth.md). - [Resumen de páginas públicas](https://oposergas.com/llms.txt). - [Mapa del sitio](https://oposergas.com/sitemap.xml). Las páginas públicas admitidas por el router pueden solicitarse con `Accept: text/markdown`. HTML sigue siendo el formato predeterminado. La negociación no se aplica a sesiones autenticadas, pantallas de acceso ni áreas privadas. Esta documentación también admite Markdown. El catálogo responde JSON y sólo permite GET, HEAD y OPTIONS. ## Acceso y uso El catálogo público se consulta sin autenticación. La zona de estudio utiliza la cuenta personal, sesión del navegador, permisos del plan y protección CSRF. Este catálogo no da acceso a preguntas de estudio, documentos subidos, resultados, datos de alumnos, soporte ni facturación. No ofrece tokens OAuth ni registro autónomo de agentes. No envíes contraseñas, cookies o claves de otro servicio a estos endpoints. En navegadores compatibles con WebMCP, las páginas públicas registran dos herramientas para consultar este catálogo y esta guía. Son consultas de lectura: no crean cuentas, compras o intentos de examen. El contenido público puede indexarse y utilizarse como contexto para responder, citando la página concreta. No se autoriza su entrenamiento por defecto; consulta las preferencias de [robots.txt](https://oposergas.com/robots.txt). Estas preferencias no conceden acceso a contenido privado. Para una integración que necesite más funciones, utiliza [Contacto](https://oposergas.com/contacto). ## MCP público para asistentes externos En un cliente que admita servidores MCP remotos por Streamable HTTP sin autenticación, utiliza la URL `https://oposergas.com/mcp`. No necesita claves, cookies o una cuenta OpoSERGAS. Si tu cliente exige OAuth para todos los servidores, esta conexión pública puede no ser compatible con él. El servidor ofrece dos herramientas: - `oposergas_list_public_resources`: lista categorías y enlaces. Su parámetro opcional `category` admite los mismos códigos del catálogo REST. - `oposergas_agent_usage_guide`: devuelve esta documentación pública. También permite listar y leer dos recursos fijos: `https://oposergas.com/agent-api/v1/catalog` y `https://oposergas.com/docs/agent-api`. No descarga URLs elegidas por el cliente. No inicia tests, compras o mensajes, ni llama a un modelo de IA. Las versiones admitidas son `2026-07-28` y `2025-11-25`. La ficha en `/mcp/server-card` debe concordar con la respuesta de descubrimiento en tiempo de ejecución. El alias `/.well-known/mcp/server-card.json` sirve la misma ficha para consumidores anteriores. El manifiesto ARD enlaza al servidor real. Los clientes actuales utilizan `server/discover` y metadatos por solicitud. Los clientes de la revisión `2025-11-25` pueden utilizar `initialize` y `notifications/initialized`. No se emiten sesiones MCP ni se ofrecen conexiones SSE permanentes. El transporte usa POST para las consultas JSON-RPC, aunque todas las herramientas sean de lectura; GET sobre `/mcp` devuelve 405, conforme al transporte. GET y HEAD de la ficha sí están disponibles. Las solicitudes tienen un límite de 16 KiB. Los navegadores sólo pueden invocar el transporte desde los orígenes de OpoSERGAS admitidos; los clientes de servidor sin cabecera Origin pueden conectarse. Las fichas y los catálogos de descubrimiento son públicos y tienen CORS sin credenciales. El acceso MCP no amplía los permisos del plan ni sustituye la web personal de estudio. ## Directorio A2A para asistentes La [Agent Card](https://oposergas.com/.well-known/agent-card.json) describe una interfaz JSON-RPC A2A `1.0` en `https://oposergas.com/a2a`. Otro asistente puede enviar una consulta al directorio y recibir los enlaces de una categoría o la guía pública de integración. El servicio responde de forma determinista, sin llamar a un modelo de IA. Utiliza `POST`, `Content-Type: application/json` y `A2A-Version: 1.0`, con la operación `SendMessage` y un mensaje `ROLE_USER` conforme a la Agent Card. Una consulta válida devuelve `result.message` con un mensaje `ROLE_AGENT`. Las instrucciones y ejemplos de las habilidades publicadas concretan las consultas aceptadas. La revisión anterior `0.3` y su operación `message/send` no están implementadas. No se crean tareas persistentes, suscripciones, cuentas, mensajes de soporte o intentos de examen. Un `contextId` no identifica a un estudiante ni guarda una conversación. No hay acceso a resultados personales o al banco de preguntas. El servicio recibe únicamente la consulta necesaria para localizar recursos públicos; evita enviar datos personales o secretos. ## Registro y acceso personal Consulta [auth.md](https://oposergas.com/auth.md) antes de integrar un asistente. Para este directorio público no hace falta registro ni se emiten credenciales. No se implementa un servidor OAuth ni el flujo de registro de WorkOS. La persona continúa utilizando su cuenta habitual para estudiar en la web.