Nextvisit

Consulta y edita historiales de pacientes, encuentros, medicamentos y documentos clínicos desde Nextvisit, la plataforma de documentación con IA para salud conductual.

Ver en nextvisit.ai

Documentación

Los asistentes compatibles con MCP se conectan una sola vez, luego leen datos estructurados de la historia clínica y escriben de vuelta mediante herramientas tipadas. Se aplica el mismo alcance de espacio de trabajo que con las claves API y OAuth. La PHI nunca sale del límite del espacio de trabajo.

Endpoint del servidor

https://nextvisit.app/mcp/clinic

El transporte es HTTPS. La autenticación es OAuth 2.0: tu cliente MCP abre un navegador, inicias sesión en Nextvisit y apruebas la conexión en la misma pantalla de consentimiento utilizada para las aplicaciones OAuth, y el cliente almacena el token resultante. No hay ninguna clave API que pegar, copiar o rotar manualmente. El servidor admite las tres clases de operaciones MCP:

  • Interactivas: herramientas que devuelven un bloque de interfaz de Nextvisit incrustado (una tarjeta de paciente, una lista de pacientes recientes) en línea dentro de la respuesta del asistente.
  • Lectura: herramientas tipadas que obtienen pacientes, encuentros, notas, documentos, medicamentos y líneas de tiempo como JSON estructurado.
  • Escritura: herramientas tipadas que crean pacientes, editan contenido de encuentros sin firmar y líneas de tiempo, vinculan o desvinculan asociaciones de pacientes, gestionan instrucciones de notas y firman o no firman un encuentro.

Lo que necesitas primero

  1. Una cuenta de Nextvisit con acceso al espacio de trabajo que deseas que el asistente lea o escriba.
  2. Un cliente compatible con MCP. Claude de escritorio, Claude en la web, ChatGPT, Cursor, Continue y la mayoría de los entornos de ejecución de LLM locales (Ollama, LM Studio, Open WebUI) admiten servidores MCP remotos con OAuth.

Si el administrador de tu espacio de trabajo ha deshabilitado el acceso de aplicaciones externas para el espacio de trabajo, la pantalla de consentimiento OAuth rechazará la conexión. Contacta con ellos o con nuestro equipo de soporte para habilitarlo.

MCP connection workflow: enter the endpoint, approve workspace scopes, and use scoped tools

Flujo de trabajo de conexión MCP: introduce el endpoint, aprueba los alcances del espacio de trabajo y utiliza herramientas con alcance

Conexión de Claude

Los clientes de escritorio y web de Claude admiten servidores MCP remotos como Conectores personalizados.

  1. Abre Configuración > Conectores en Claude.
  2. Haz clic en Añadir conector personalizado.
  3. Nómbralo Nextvisit.
  4. Establece la URL del servidor MCP en https://nextvisit.app/mcp/clinic.
  5. Haz clic en Conectar. Se abre una ventana del navegador con la pantalla de consentimiento OAuth de Nextvisit.
  6. Inicia sesión en Nextvisit (si aún no lo has hecho), elige el espacio de trabajo que deseas que el conector vea y revisa los alcances que el asistente está solicitando. Haz clic en Permitir.
  7. El navegador te devuelve a Claude. Las herramientas aparecen bajo el conector de Nextvisit y están disponibles en cualquier conversación de Claude donde habilites el conector.

Los mismos pasos funcionan en cualquier lugar donde Claude exponga un campo de Conector personalizado. Revoca desde Configuración > Aplicaciones externas en Nextvisit. El encabezado de la página es Autenticación.

Conexión de otros clientes

Cualquier cliente que admita servidores MCP remotos autenticados con OAuth funciona. Introduce la URL; el cliente gestiona el flujo del navegador.

  • ChatGPT: Añádelo como conector MCP personalizado en Configuración > Conectores en ChatGPT. Pega la URL y completa el flujo OAuth en la ventana emergente.
  • Cursor, Continue, Zed y otros clientes IDE: Añade la URL al bloque mcpServers del archivo de configuración del cliente. En la primera llamada, el cliente abre el flujo OAuth en tu navegador predeterminado y almacena en caché el token resultante.
  • Entornos de ejecución de LLM locales: Ollama, LM Studio y Open WebUI aceptan endpoints MCP remotos en su panel de configuración MCP. Cada cliente admite servidores MCP remotos autenticados con OAuth; consulta la documentación MCP del entorno para conocer el formato actual.

Si tu cliente solo admite servidores MCP que se autentican con un token portador estático, no podrá conectarse al servidor MCP de Nextvisit. El endpoint es solo OAuth y no acepta claves API de larga duración.

Herramientas disponibles

El servidor MCP incluye la misma superficie de herramientas que impulsa las funciones de IA propias de Nextvisit. Agrupadas por clase de operación:

Interactivas

  • recent_patients: Devuelve los pacientes actualizados más recientemente para el espacio de trabajo actual como un bloque de interfaz incrustado.
  • fetch_patient: Busca un paciente por MRN o UUID. Devuelve los detalles de la historia clínica y una visualización del paciente incrustada.

Lectura

  • fetch_encounter: Información detallada del encuentro. Modos de visualización: full, content, transcript, context.
  • search_encounters: Busca por nombre de paciente, contenido del encuentro o palabra clave. Admite filtros de rango de fechas y paginación.
  • utility_global_search: Búsqueda en todo el sistema entre pacientes, encuentros y documentos. Admite búsqueda de frases ([exact phrase]) y búsqueda negativa (-term).
  • fetch_patient_medications: Lista de medicamentos actuales e históricos, incluidos dosis, frecuencia, clasificación, prescriptor y estado.
  • fetch_patient_timeline: Historial de visitas del paciente como una línea de tiempo cronológica de encuentros.
  • fetch_document: Recupera un documento subido por ID. Admite lectura completa con paginación o búsqueda de frases dentro del documento.
  • manage_note_instructions (acción get): Lee tus instrucciones personalizadas de generación de notas con IA.
  • manage_patient_chart_notes (acción get): Lee las notas persistentes de la historia clínica de un paciente.

Escritura

  • create_patient: Crea un nuevo registro de paciente. Siempre busca primero para evitar duplicados. El nombre y el apellido son obligatorios; los datos demográficos, alergias, medicamentos y notas persistentes son opcionales.
  • edit_encounter: Edita content (documentación clínica) o transcript en un encuentro sin firmar. Tres operaciones: str_replace, insert (antes o después de un ancla) y regex.
  • edit_encounter_timeline: Edita o añade eventos en la línea de tiempo de un encuentro.
  • link_patient_to_encounter: Vincula o desvincula la asociación de paciente en un encuentro.
  • sign_encounter: Firma (bloquea) o no firma (desbloquea) un encuentro. Solo el creador del encuentro puede realizar esta acción.
  • manage_note_instructions (acción update): Reemplaza, añade, antepone o borra tus instrucciones de notas con IA.
  • manage_patient_chart_notes (acción update): Reemplaza, añade, antepone o borra las notas persistentes de la historia clínica de un paciente.

El servidor devuelve JSON estructurado.

Cómo es una llamada del asistente

Un flujo de lectura típico desde Claude:

User: "What did Dr. Patel see Jane Doe for in April?"

Claude calls search_encounters(query="Jane Doe", date_from="2026-04-01", date_to="2026-04-30")
→ returns a list of encounter IDs with dates and titles.

Claude calls fetch_encounter(id="enc_a1b2", view="content")
→ returns the merged clinical note for that encounter.

Claude summarizes the visit back to you.

Un flujo de escritura típico:

User: "Add 'patient declined PHQ-9 today' to the timeline on encounter 41822."

Claude calls edit_encounter_timeline(encounter_id=41822, action="add",
  find="Patient declined PHQ-9 today")
→ event appears on the encounter timeline.

Cada llamada lleva el alcance del espacio de trabajo. El asistente no puede ver ni modificar historias clínicas en otro espacio de trabajo.

Permisos y auditoría

  • Las llamadas a herramientas respetan el mismo límite de espacio de trabajo que el resto de la plataforma. Nunca hay lecturas entre espacios de trabajo.
  • Los alcances se conceden en el momento del consentimiento OAuth y puedes revisarlos antes de aprobarlos. Los alcances de lectura desbloquean las herramientas de lectura e interactivas; los alcances de escritura desbloquean adicionalmente create_patient, edit_encounter, edit_encounter_timeline, link_patient_to_encounter, sign_encounter y las operaciones de actualización de manage_*. Una llamada a una herramienta que exceda el alcance concedido devuelve un 403 y nunca modifica datos.
  • sign_encounter está restringido además al creador del encuentro.
  • edit_encounter solo funciona en encuentros sin firmar. Primero no firmes, edita y luego vuelve a firmar.
  • Cada llamada MCP se registra en el registro de auditoría del espacio de trabajo con la marca de tiempo, la aplicación conectada, el nombre de la herramienta y el ID del recurso afectado.
  • Puedes revocar la conexión en cualquier momento desde Configuración > Aplicaciones externas. La revocación invalida el token de inmediato; las llamadas posteriores de ese cliente devuelven 401 hasta que vuelvas a autorizar.

Privacidad

El servidor MCP es parte de tu espacio de trabajo de Nextvisit y opera bajo el mismo Acuerdo de Asociado Comercial. La PHI devuelta al asistente se rige por el propio manejo de datos del proveedor del asistente, por lo que cuando conectas Claude, ChatGPT o cualquier modelo de terceros, los datos de la historia clínica de tu espacio de trabajo están sujetos a los términos de ese proveedor durante la conversación.

Para espacios de trabajo con 42 CFR Parte 2, el acceso MCP sigue las mismas puertas de consentimiento que OAuth y las aplicaciones externas. Consulta la guía de 42 CFR Parte 2 para conocer la política completa.

Solución de problemas

Error de autenticación o errores 401

El token almacenado caducó o la conexión fue revocada. Desconecta y vuelve a conectar el conector de Nextvisit en tu cliente para ejecutar el flujo OAuth nuevamente. Puedes confirmar que la conexión sigue activa en Configuración > Aplicaciones externas en Nextvisit.

Ventana emergente de OAuth bloqueada

Algunos navegadores bloquean la ventana emergente de OAuth la primera vez. Permite ventanas emergentes para el dominio del cliente (para Claude en la web, ese es claude.ai) y reintenta la conexión.

La lista de herramientas no aparece

El cliente almacenó en caché una lista de herramientas vacía. Desconecta y vuelve a conectar el conector de Nextvisit, o reinicia el cliente. Los Conectores personalizados en Claude se actualizan al reconectar.

"No se puede editar un encuentro firmado. No lo firmes primero."

Llama a sign_encounter con status: "unsigned" primero (debes ser el creador), realiza las ediciones y luego vuelve a firmar.

"Paciente no encontrado"

Confirma que el MRN o UUID proviene del mismo espacio de trabajo que aprobaste al conectar el asistente. Los MRN tienen alcance de espacio de trabajo, por lo que el mismo número puede existir en dos espacios de trabajo diferentes y apuntar a pacientes distintos.

Contacta con el soporte para configuración, alcances o un espacio de trabajo de pruebas si no deseas probar con historias clínicas reales.