health-skillz MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Autenticación basada en OAuth contra cualquier proveedor compatible con FHIR
Solo lectura por defecto — sin recetas ni registros clínicos
Compatible con todos los principales portales hospitalarios de EE.UU. (Epic MyChart, Cerner, Athena)
Traduce códigos clínicos (LOINC, RxNorm, SNOMED) a lenguaje comprensible
Código abierto — ves exactamente qué se consulta

Demo en vivo

Cómo se ve en la práctica

health-skillz-skill.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "health-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "health-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jmandel/health-skillz",
          "~/.claude/skills/health-skillz"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add health-skillz-skill -- git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: health-skillz

Haz preguntas simples sobre las tendencias de tus resultados de laboratorio

👤 Pacientes que hacen seguimiento de condiciones crónicas, colesterol, A1c ⏱ ~15 min beginner

Cuándo usarlo: Has tenido análisis repetidos durante meses o años y quieres ver la tendencia, no solo cada resultado de forma aislada.

Requisitos previos

Un portal de paciente con acceso a FHIR — La mayoría de los grandes sistemas de salud de EE.UU. soportan SMART on FHIR — revisa tu portal para acceso a API o aplicaciones
Skill instalado — git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

Flujo

Autenticar

Usa health-skillz para conectar a mi cuenta de Epic MyChart.✓ Copiado

→ El navegador abre SMART launch; el token se almacena localmente
Obtener análisis

Muestra mi LDL, HDL y A1c durante los últimos 3 años como una tendencia.✓ Copiado

→ Tabla de series temporales o resumen con conversiones de unidades
Contextualizar

Relaciona estos con los rangos de referencia. No me des consejos médicos — solo muestra qué está dentro del rango y qué no.✓ Copiado

→ Encuadre explícito como rangos de referencia, no como diagnóstico

Resultado: Una vista longitudinal legible de tus análisis clave — útil antes de tu próxima cita.

Errores comunes

Tratar el resultado de Claude como consejo médico — Siempre lleva tus preguntas a tu médico. Este Skill es para entender tus propios registros, no para una segunda opinión.

Reconcilia la lista de medicamentos antes de una cita

👤 Pacientes en múltiples medicamentos de múltiples proveedores ⏱ ~10 min beginner

Cuándo usarlo: Estás a punto de ver a un nuevo especialista y quieres una lista de medicamentos limpia y actualizada.

Flujo

Obtener medicamentos activos

Usa health-skillz. Obtén mi lista de medicamentos actual con dosis, frecuencia y proveedor prescriptor.✓ Copiado

→ Lista estructurada con códigos RxNorm resueltos a nombres
Identifica duplicados y omisiones

¿Hay terapias duplicadas, redundancias de la misma clase, o medicamentos que parecen vencidos?✓ Copiado

→ Señales que puedes plantear a tu médico

Resultado: Una lista de medicamentos para entregarle a tu nuevo proveedor el primer día.

Errores comunes

Los portales a veces no incluyen medicamentos sin receta — Añádelos manualmente; el portal solo muestra lo que fue prescrito a través de él

Exporta un subconjunto relevante de registros para un nuevo especialista

👤 Pacientes que cambian de proveedor o ven a un especialista ⏱ ~20 min intermediate

Cuándo usarlo: Estás consolidando registros para una segunda opinión.

Flujo

Filtrar

Usa health-skillz. Obtén todos los encuentros relacionados con cardiología, análisis e imágenes de los últimos 2 años.✓ Copiado

→ Exportación filtrada agrupada por encuentro
Formatear

Formatea como un resumen de una página que un especialista pueda revisar en 30 segundos.✓ Copiado

→ Documento compacto con fechas clave, diagnósticos, hallazgos relevantes

Resultado: Un resumen portátil que te pertenece — no un volcado de PDF de 200 páginas.

Errores comunes

Perder matices al resumir — Siempre ten la exportación completa como respaldo; el resumen es para triaje rápido

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

health-skillz-skill + filesystem

Guarda las exportaciones en una estructura de carpetas locales organizada

Guarda la exportación de cardiología en ~/health/specialists/cardio-2026.md✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
smart_launch	URL de proveedor	Conexión inicial a un proveedor	Redirección OAuth
get_observations	id de paciente, categoría, rango de fechas	Obtención de análisis o signos vitales	Llamada FHIR API
get_medications	id de paciente, estado	Reconciliación de medicamentos	Llamada FHIR API
get_encounters	id de paciente, rango de fechas	Revisión del historial de citas	Llamada FHIR API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Depende de los límites de FHIR API del proveedor
Tokens por llamada: Moderado — los resultados de laboratorio son compactos
Monetario: Gratis (el acceso al portal está incluido en la atención)
Consejo: Obtén una categoría a la vez; las exportaciones completas de 'todo' son costosas en tokens.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: patient/*.read

Almacenamiento de credenciales: Token OAuth en el almacén de credenciales local; nunca comprometido

Salida de datos: Solo tu servidor FHIR y Anthropic API

No conceder nunca: user/*.write system/*.*

Esto NO es consejo médico. El Skill muestra tus propios registros; las decisiones permanecen contigo y tus médicos.
Los datos de salud son sensibles. Entiende que al consultar a través de Claude, extractos de tus registros se envían a la API de Anthropic según sus políticas de datos.
Revoca el acceso de la aplicación desde tu portal de paciente cuando termines.

Resolución de problemas

Errores comunes y soluciones

SMART launch falla con error de redirección

La mayoría de los portales requieren registrar previamente el URI de redirección de la aplicación. Revisa la documentación del Skill para tu proveedor.

Resultados vacíos a pesar de tener datos en el portal

Tu proveedor puede restringir los alcances de FHIR; intenta consultas más específicas o contacta al soporte.

Los códigos de laboratorio se muestran como IDs LOINC sin procesar

Asegúrate de que el mapa de códigos del Skill esté actualizado; puede que necesites actualizar el clon.

Verificar: cd ~/.claude/skills/health-skillz && git pull

Alternativas

health-skillz vs otros

Alternativa	Cuándo usarla	Contrapartida
Manual portal export	Exportación única de todos los registros	Volcado de PDF, no consultable
Apple Health app	Agregación de consumidor centrada en iOS	Datos cerrados; sin consultas LLM

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills