Saltar al contenido
Pedro Gomes
Todos los proyectos

Servidor MCP de Clínica Aurora

La agenda de la clínica publicada como servidor Model Context Protocol, para que cualquier cliente MCP pueda agendar, reprogramar y cancelar a través de ella. Las reglas de negocio se imponen en el servidor, no se piden en un prompt.

Una solicitud initialize exitosa y las capacidades devueltas por el endpoint MCP de Aurora

Quién tiene este problema

Una integración MCP debe separar la propuesta de cambio de su escritura en la agenda. El servidor vincula cada propuesta a un token de un solo uso, vuelve a comprobar las reglas al escribir y registra la decisión. El cliente MCP o el flujo que lo rodea debe obtener y exigir la aprobación humana.

Mi papel

Servidor MCP integrado con la API de la clínica y su motor determinista de políticas.

Cómo probarlo

  1. Un navegador no puede abrir este endpoint: habla un protocolo, no sirve una página. Un GET devuelve 406 a propósito.
  2. Haz un POST a https://aurora.pgdev.com.br/mcp con Content-Type: application/json, Accept: application/json, text/event-stream y una llamada initialize. Completa la inicialización antes de llamar a tools/list con el id de sesión recibido.
  3. O conecta un cliente MCP compatible a esa URL y consulta las herramientas disponibles.

Decisiones que tomé

  • Cada escritura usa dos llamadas. La primera devuelve la propuesta y un token de un solo uso sin cambiar la agenda; la segunda envía esa operación con el token y el servidor vuelve a comprobar la política. El token vincula la operación, pero no demuestra aprobación humana; esa responsabilidad corresponde al cliente MCP.
  • Las reglas de negocio son un motor de políticas determinista detrás de las herramientas, no instrucciones en el prompt de sistema. Una escritura que la política rechaza vuelve como un rechazo con el código de la regla, y al modelo se le indica que lea ler_politica antes de prometerle nada a nadie.
  • Las herramientas de lectura exponen la política y los registros de decisión con código de regla, para que el cliente MCP pueda inspeccionar por qué se permitió o rechazó una operación.
  • Es la misma clínica que usa la demo de chat, así que las dos se pueden comparar lado a lado: una muestra a una persona hablando con un agente, la otra muestra a otro agente conectándose a la misma agenda protegida.
  • Versión del protocolo 2025-06-18, Streamable HTTP con ids de sesión, funcionando detrás de Traefik como un servicio propio.

Límites que siguen vigentes

  • Solo sirve la agenda de demostración, la misma que usa la demo de chat, y esa agenda se reinicia sola.