Valeo Connector (MCP) — MVP

Un servidor MCP remoto mínimo que convierte los datos de los miembros de Valeo Health en un conector de Claude, igual que funciona el conector de Function Health.

• Cero dependencias. Solo Python de la biblioteca estándar. Se ejecuta con el python3 de macOS.

• Transporte: Streamable HTTP (especificación MCP 2025-06-18), un único endpoint /mcp.

• Autenticación: ninguna por ahora (demo). Todos los datos provienen de sample_data.py.

• Solo lectura. Cada herramienta está anotada con readOnlyHint: true.

Endpoint de demo en vivo (datos de ejemplo, sin autenticación):

https://valeo-connector.onrender.com/mcp

Añádelo en Claude en Configuración > Conectores > Añadir conector personalizado. Comprobación de estado: https://valeo-connector.onrender.com/health. Es una instancia gratuita, así que se duerme después de ~15 minutos de inactividad y la primera llamada tras la siesta tarda 30-60 s: abre la URL de estado para calentarla antes de una demo.

Archivos

Related MCP server: health-mcp

Herramientas

Categorías de salud en el panel de ejemplo: Corazón, Metabólico, Vitaminas y minerales, Tiroides, Hígado, Riñón, Sangre e inmunidad, Hormonas, Salud masculina.

Al igual que Function Health, el conector expone deliberadamente solo datos a nivel de resumen: recuentos, categorías, indicadores y direcciones ("Vitamina D, baja, significativa"), nunca valores de laboratorio sin procesar.

Icono

El servidor anuncia un icono de marca cuadrado en su serverInfo como URI de datos, según el campo de iconos de MCP (SEP-973), y lo sirve en /icon.png, /icon-128.png y /favicon.ico.

Claude.ai aún no lo muestra para conectores personalizados: los conectores personalizados muestran un icono genérico independientemente de lo que declare el servidor (claude-ai-mcp#152). Declararlo no cuesta nada y empezará a funcionar el día que se implemente. Hoy en día, un icono de marca requiere un listado en el Directorio de Conectores, donde el icono se sube durante el envío.

Ejecutarlo

./run.sh

Luego, en otra terminal:

python3 test_server.py

Comprobación de estado: http://127.0.0.1:8787/health

Ruta de demo 1 — Claude Code (la más rápida, ~30 segundos)

.mcp.json ya apunta a http://127.0.0.1:8787/mcp. Inicia el servidor, abre Claude Code en esta carpeta, aprueba el servidor valeo cuando se te pida y pregunta:

¿Cómo están mis análisis y cómo va mi programa?

Ruta de demo 2 — cualquiera con una suscripción de Claude (URL pública)

Los servidores de Claude llaman a tu endpoint, así que necesita una URL HTTPS pública estable; localhost y los túneles que mueren al reiniciar no sirven. Despliega el repositorio y cualquiera con un plan de Claude de pago (Pro, Max, Team, Enterprise) podrá añadirlo por su cuenta:

Claude → Configuración → Conectores → Añadir conector personalizado → pega

https://valeo-connector.onrender.com/mcp

Despliegue

render.yaml y Dockerfile están ambos en el repositorio y ejecutan server.py sin cambios.

Render (sin necesidad de CLI, gratis, sin tarjeta):

1. Haz clic en el botón Deploy to Render de la parte superior de este README, o ve a render.com → Nuevo → Blueprint → elige este repositorio → Aplicar. De cualquier forma, lee render.yaml.

2. Inicia sesión con GitHub y aprueba el acceso al repositorio.

3. Obtienes https://valeo-connector.onrender.com (Render puede añadir un sufijo si el nombre está ocupado). La URL del conector es esa más /mcp. Al hacer push a main se redespliega automáticamente.

Verifica el despliegue antes de conectarlo a Claude:

python3 test_server.py https://valeo-connector.onrender.com

Las 22 comprobaciones deberían pasar contra la URL en vivo exactamente igual que en local.

Las instancias gratuitas se duermen tras ~15 minutos de inactividad, así que la primera llamada después de la siesta tarda 30–60 s (el tiempo de espera de las herramientas de Claude es de 300 s, así que sigue funcionando, solo se nota lento). El plan de 7 $ o la propia infraestructura de Valeo eliminan ese problema.

Cualquier host de contenedores (Cloud Run, Fly, Railway) funciona con el Dockerfile. Establece HOST=0.0.0.0; el servidor lee PORT de las variables de entorno.

Con el tiempo esto debería vivir en el dominio propio de Valeo: Function Health sirve el suyo desde https://services.functionhealth.com/ai-chat/mcp.

Dos cosas que saber antes de compartir la URL

1. Aún no hay autenticación, así que todos los usuarios ven el mismo miembro ficticio. Eso está bien para una demo y se indica en las propias instrucciones del servidor para Claude. Es lo único que debe cambiar antes de que los datos reales de los miembros se acerquen a esto.

2. Aparecer en el Directorio de Conectores de Claude es un paso aparte: una solicitud a Anthropic. Sin ello, el conector sigue funcionando; los usuarios solo añaden la URL manualmente en lugar de encontrarlo en el directorio.

Qué añadir después del MVP

1. OAuth 2.0 para que cada miembro vea solo sus propios datos. Claude admite el registro dinámico de clientes; la devolución de llamada para superficies alojadas es https://claude.ai/api/mcp/auth_callback. Sirve /.well-known/oauth-protected-resource (RFC 9728) y limita el alcance de los tokens (read:labs, read:programs, read:appointments).

2. Datos reales: sustituye sample_data.py por llamadas autenticadas a la API de Valeo vinculadas al token.

3. Alojamiento estable: cualquier host de Python sirve, ya que no hay dependencias.

4. Una página de documentación como la de Function Health, y envía la solicitud al Directorio de Conectores.

Límites que conviene conocer

No es consejo médico; solo datos a nivel de resumen.