# Tutorial del MCP de QuizIA

Este servidor MCP expone formularios, preguntas y sesiones de entrevista de QuizIA
para que un agente (Cline y similares) los opere por chat.

## 1) Crear la agent key

1. Entrar a /profile/api-keys.
2. En "Tipo de API Key" elegir "Agente IA / MCP".
3. Poner un nombre y presionar "Generar API Key".
4. Copiar la key: se muestra UNA sola vez.

Nota: la agent key actua como su propio usuario (no otorga permisos extra).

## 2) Conectar el cliente MCP

Transporte Streamable HTTP:

- URL: https://quizia.tecsi.com.ar/mcp
- Header: Authorization: Bearer <AGENT_KEY>

En Cline, fijar "type": "streamableHttp". Si se omite, algunos clientes usan SSE legacy y el proxy del hosting puede bufferizar la respuesta.

## 3) Tools disponibles

- listar_formularios: lista los formularios del usuario.
- ver_formulario: detalle de un formulario por slug (preguntas, tipos, dependencias).
- generar_preguntas: genera/refina preguntas por chat (Arquitecto). Iterativo.
- crear_formulario: guarda un formulario con las preguntas del ultimo chat.
- responder_pregunta: responde una pregunta (mismo pipeline del plugin).
- listar_sesiones: lista sesiones (permite recuperar id/token).
- resumen_sesion: resumen de una sesion por token.
- reporte_sesion: auditoria de una sesion (respuestas + logs de agentes).

## 4) Flujo recomendado

1. generar_preguntas (iterar hasta conformar).
2. crear_formulario (persistir y obtener el slug).
3. responder_pregunta (simular/completar una entrevista).
4. listar_sesiones -> resumen_sesion / reporte_sesion (auditar resultados).

## 5) Troubleshooting

- 401: falta el header Authorization: Bearer <key> (todo /mcp requiere token).
- 403: la key no es de tipo agent (usar una API key "Agente IA / MCP").
- La IA no razona: la app necesita una AI provider key (OpenAI/OpenRouter)
  configurada; es distinta de la agent key.
- SSE no llega: usar "type": "streamableHttp" (POST/JSON) en lugar de SSE.