Su IA sobre nuestra app: gestionar los SOP con Claude

Hace un tiempo, alguien escribió en LinkedIn a un fabricante de software, más o menos: «No quiero su IA dentro de su app. Quiero mi IA sobre su app». La frase señala algo que muchos proveedores pasan por alto. Quien trabaja a diario con su propio asistente de IA no quiere un asistente distinto y más pequeño en cada programa. Quiere que su asistente sepa usar el programa.

Aplicamos esa frase al propio Viali: Viali tiene ahora un servidor MCP. El primer ámbito que abre son los procedimientos operativos estándar (SOP) y las guías de una clínica.

El manual de calidad como una carpeta llena de archivos

En la mayoría de las clínicas, el manual de gestión de la calidad es una carpeta: archivos de Word, PDF generados a partir de ellos, una lista de versiones en Excel y, además, copias en la unidad de red y en adjuntos de correo electrónico. Cuando cambia una norma de rango superior, por ejemplo la directriz interna de la clínica sobre higiene de manos, empieza la búsqueda: ¿cuáles de los cuarenta documentos tratan el tema? ¿Qué copia es la válida? ¿Quién fue el último en cambiar algo?

En Viali, un SOP no es un archivo adjunto. Es un documento digital con un estado (borrador o publicado), un historial de versiones, solicitudes de firma al equipo y un asistente que responde a las preguntas del personal a partir de las guías publicadas. Esa era la base. Con el servidor MCP, ahora también un agente de IA puede trabajar con estos documentos, y con muchos a la vez.

Qué hace el servidor MCP

MCP (Model Context Protocol) es un estándar abierto que permite a los agentes de IA usar las herramientas de otros programas. En https://use.viali.app/mcp, Viali ofrece 12 herramientas para los SOP de una clínica:

• Leer y encontrar: listar los SOP (por estado, tema o palabra de búsqueda), leer un SOP completo, buscar en el texto completo (borradores incluidos).
• Escribir: crear un SOP nuevo (siempre como borrador), modificar un SOP, publicarlo o devolverlo a borrador.
• Versiones: ver el historial de versiones, leer una versión anterior y restaurarla.
• Temas: asignar temas (etiquetas), listar todos los temas de la clínica con su número de usos, renombrar un tema en todos los SOP o fusionar dos temas.

No hay, a propósito, ninguna herramienta para borrar. Borrar sigue siendo una decisión que toma una persona en Viali.

Una petición en lugar de cuarenta diálogos

El ejemplo de arriba muestra una petición típica: «Revisa todos los SOP de higiene según la nueva directriz de desinfección de manos y asígnales el tema "Hygiene"». El agente lee la nueva directriz desde un archivo local, busca en Viali todos los SOP afectados, los lee uno por uno, ajusta el texto y asigna el tema. Al final informa de lo que ha hecho y de lo que la clínica tiene que revisar.

Nosotros mismos lo usamos en Viali. Nuestro fundador escribe y mantiene ahora los SOP como usuario a través de Claude Code, mucho más rápido que con la IA del editor de SOP («Draft with AI», «Improve with AI»). El editor va bien para una sola guía. Para un manual completo, su propio agente tiene ventaja: tiene a mano los demás documentos de la clínica, trabaja muchos SOP de una pasada y una persona revisa el resultado en lugar de teclear cada cambio.

Los temas son una novedad en Viali. Aparecen en la lista de SOP como pequeñas etiquetas y como filtro, para los administradores y para el personal. Una enfermera encuentra todas las guías de higiene con un clic.

No se pierde nada

Una clínica solo puede confiar sus guías a un agente si cada cambio se puede rastrear y deshacer. Por eso el agente sigue las mismas reglas que la app:

• Cada cambio es una versión. El historial de versiones muestra el nombre de la persona que creó el acceso, con «(Claude)» añadido, por ejemplo «Dr. Anna Keller (Claude)». Cualquier versión anterior puede restaurarse en cualquier momento.
• Nada se sobrescribe sin avisar. Cada cambio indica la versión en la que se basa. Si una compañera ha modificado el SOP en Viali entretanto, Viali rechaza el cambio. El agente vuelve a leer el texto actual y aplica su cambio sobre él.
• Los SOP nuevos empiezan como borrador. El personal solo los ve una vez publicados.
• Las firmas siguen en sus manos. Publicar no envía solicitudes de firma. Si todavía hay solicitudes abiertas sobre una versión anterior, el agente recibe un aviso de que esas personas están firmando el texto antiguo.

Seguridad: una clínica, solo SOP, ningún dato de pacientes

• Solo SOP. El servidor MCP no conoce pacientes, citas, facturas ni otros datos. Ninguna herramienta va más allá de los SOP, y ninguna otra interfaz de Viali acepta el token.
• Una clínica. Cada acceso pertenece exactamente a una clínica.
• Personal y con caducidad. Un administrador de la clínica crea el acceso para sí mismo. Se muestra una sola vez, es válido durante 30, 60 o 90 días y puede revocarse en cualquier momento. Si la persona pierde el rol de administrador o de manager, el acceso deja de funcionar de inmediato.
• Limitado. Como máximo 120 peticiones por minuto y acceso. Cuando una clínica está en modo de solo lectura por motivos de facturación, Viali rechaza cualquier cambio.

Encontrará más información sobre cómo guarda Viali los datos en la página de seguridad.

Cómo empezar

1. 1En Viali, vaya a Admin → Integrations, pestaña API Key, abra la tarjeta AI access (MCP), elija un nombre y una validez y haga clic en Create access.
2. 2Pegue el comando, que se muestra una sola vez, en un terminal donde se ejecute Claude Code:

claude mcp add --transport http viali https://use.viali.app/mcp --header "Authorization: Bearer vct_…"

1. 1Dele una petición a Claude Code, por ejemplo: «Lista todos los SOP sin tema y propón temas para ellos».

En claude.ai, Claude Desktop y ChatGPT, se añade Viali como conector personalizado (dirección https://use.viali.app/mcp) y se inicia sesión con el usuario de Viali; su rol decide qué puede hacer el asistente. Claude Code sigue conectándose con un acceso creado en Admin → Integrations. La descripción técnica está en la documentación de la API de Viali.

Por qué lo construimos así

Un software para clínicas no tiene que inventar cada asistente de IA por su cuenta. Tiene que ofrecer sus datos bien estructurados, versionados y limitados de forma segura, para que el asistente propio de la clínica pueda trabajar con ellos. Los SOP son el primer ámbito. Las reglas siguen siendo las mismas: acceso claramente limitado, cada cambio rastreable, ningún dato de pacientes.

Preguntas frecuentes

¿Qué es el servidor MCP de Viali?

Un endpoint en https://use.viali.app/mcp que usa el Model Context Protocol (Streamable HTTP). Permite a un agente de IA como Claude Code listar, leer, buscar, crear, modificar, publicar, versionar y etiquetar los SOP de una clínica. Hay 12 herramientas. No existe ninguna herramienta para borrar.

¿Puede el agente de IA ver datos de pacientes?

No. El token es válido para una sola clínica y solo para los SOP. Ninguna herramienta del servidor MCP llega a pacientes, citas ni a ningún otro dato, y ninguna otra ruta de Viali acepta el token.

¿Quién puede crear un acceso y cuánto tiempo es válido?

Un administrador de la clínica crea un acceso personal en Admin → Integrations, pestaña API Key, tarjeta AI access (MCP). El token se muestra una sola vez. Es válido durante 30, 60 o 90 días, puede revocarse en cualquier momento y deja de funcionar cuando la persona pierde el rol de administrador o de manager.

¿Qué pasa si un compañero modifica el mismo SOP al mismo tiempo?

Cada cambio debe indicar la versión en la que se basa. Si el SOP ha cambiado entretanto, Viali rechaza el cambio y devuelve el número de la versión actual. El agente vuelve a leer el texto actual y aplica su cambio sobre él. Nada se sobrescribe sin avisar.

¿Con qué herramientas de IA funciona?

En claude.ai, Claude Desktop y ChatGPT como conector personalizado, con su propio inicio de sesión de Viali. En Claude Code, con un solo comando.