Cómo conectar Medmis a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Medmis, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Medmis + Gemini

Medmis, la plataforma de gestión de clínicas (Rusia): sedes, especialistas y agendas, citas, pacientes, facturas, pagos, tarifa de servicios, existencias, tareas y reconocimientos médicos laborales. Reservar o cambiar una cita y crear una tarea están incluidos, pero desactivados al instalar; no se elimina nada.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MEDMIS_URL, MEDMIS_LOGIN, MEDMIS_PASSWORD, MEDMIS_SYSTEM_NAME

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta de clínica en Medmis y un usuario de API del soporte de Medmis o de tu administrador de Medmis.

1. Pide al soporte de Medmis ([email protected], con el asunto marcado DEV / API_CORE) o a tu administrador de Medmis un usuario de API: un login, su contraseña y el nombre de sistema con el que se inicia sesión. Los permisos del usuario de API deciden qué pueden leer las herramientas (appointments.get, patients.get, patient_invoices.get, payments.get, schedules.get, stores.get, todo.tasks.get, profex.*, etc.).
2. Pon en MEDMIS_URL la dirección del nodo de Medmis de tu clínica, por ejemplo https://node3.medmis.ru, sin /apix. La referencia de su API está en <MEDMIS_URL>/apix/swagger.
3. Rellena MEDMIS_LOGIN, MEDMIS_PASSWORD (al menos 6 caracteres) y MEDMIS_SYSTEM_NAME.
4. Instala el conector y ejecuta medmis_list_branches para comprobar el acceso.

El conector inicia sesión con POST /apix/v1/Auth/login y envía el access token como cabecera Bearer. Los tokens duran alrededor de una hora y se renuevan automáticamente.

Qué lee: las sedes de la clínica con dirección, contactos, horario, licencia y desfase UTC; los especialistas con sus especialidades y sedes, y los servicios que puede prestar cada uno; la agenda de los especialistas para una o varias sedes y un rango de fechas, opcionalmente solo con los huecos libres; las citas con hora UTC y local, estado, paciente, especialista, origen, tipo de visita, consulta y etiquetas, además de sus listas de referencia (estados, tipos, primera visita o revisión, orígenes, etiquetas); los pacientes por nombre, teléfono, correo, número de historia, fecha de nacimiento o edad, sexo, etiquetas y más, y la ficha completa de un paciente; las facturas de pacientes con sus líneas, y los pagos con sus importes por método de pago; la tarifa (categorías de servicios y servicios); las reservas (tiempo retenido en la agenda de un especialista); los almacenes, el catálogo de materiales, las existencias y los lotes con caducidad; las tareas internas; y el módulo de reconocimientos médicos laborales (Профосмотры): empresas, contratos y las personas incluidas en ellos.

Desactivadas al instalar: medmis_create_appointment (reservar un hueco libre), medmis_update_appointment (mover una cita, cancelarla o confirmarla a través del estado, cambiar comentario o etiquetas) y medmis_create_task. Cambian la agenda real de la clínica, así que un administrador las activa a conciencia. Incluso entonces la IA te muestra el paciente, el especialista, el día y la hora y espera tu sí. A través de este conector nunca se elimina nada.

Datos de pacientes: pacientes, citas, facturas y pagos son datos personales de salud. La IA solo lee lo que necesita la pregunta y no repite documentos de identidad ni datos de contacto salvo que lo pidas. La lista de pacientes omite los números de documento de identidad, INN y SNILS.

Fechas e ids: los filtros por día son YYYY-MM-DD; los filtros por hora de cambio son yyyy-MM-ddTHH:mm:ss en UTC. Las citas llevan la hora UTC y la local (datetimeFromLocal) además de utcOffsetMinutes, y la IA cita la hora local. Sedes, especialistas, pacientes, citas y pagos usan UUID; facturas, almacenes, materiales, tareas y registros de reconocimientos usan números.

Límites: las listas devuelven items con totalCount y totalPages, como máximo 100 por página, empezando por la página 1. Medmis limita cada método: listas filtradas 20 peticiones por minuto, listas de referencia 40, registros individuales 100 e inicio de sesión 40 por minuto. Un 429 significa esperar.

Errores comunes: 401 indica un login, contraseña o nombre de sistema incorrectos, o una sesión caducada (el conector vuelve a iniciar sesión una vez). 403 significa que al usuario de API le falta el permiso para ese método. 400 ValidationError lista los campos erróneos, por ejemplo una contraseña de menos de 6 caracteres o una fecha mal formada. 404 significa que el id no existe en tu nodo.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Medmis.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué especialistas tienen huecos libres mañana por la tarde en nuestra sede principal?"
• "Lista las citas de hoy de los cardiólogos con su estado y su hora local de inicio."
• "¿Cuánto facturamos la semana pasada por sede y qué facturas siguen sin pagar?"
• "¿Qué materiales del almacén tienen lotes caducados y cuánto queda de cada uno en existencias?"
• "Muéstrame los contratos de reconocimientos médicos creados este mes y cuántas personas hay en cada uno."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot