Servidor MCP de Almendra

El servidor MCP de Almendra permite que ChatGPT, Claude y cualquier cliente del Model Context Protocol trabajen dentro de una cuenta de Almendra: buscar pacientes, crear y enviar planes alimenticios, buscar alimentos, crear recetas y reagendar citas, con los permisos que elige el dueño de la cuenta.

Datos de conexión

• URL del servidor: https://api.almendra.io/mcp
• Transporte: Streamable HTTP.
• Autenticación: OAuth 2.1, sin clave de API. Sin token, el servidor responde 401 con WWW-Authenticate apuntando a sus metadatos (https://api.almendra.io/.well-known/oauth-protected-resource/mcp, RFC 9728). Los clientes se registran con un Client ID Metadata Document.
• Quién puede conectarlo: el dueño de una cuenta de Almendra con un plan de pago. Elige los permisos en la pantalla de consentimiento y puede desconectarlo en Configuración › Desarrolladores › ChatGPT y Claude.

Herramientas

Cada herramienta aparece solo si la cuenta dio su permiso.

Herramienta	Qué hace	Permiso
find_patients	Busca pacientes por nombre o correo.	patients:read
get_patient	Lee el perfil de un paciente.	patients:read
list_appointments	Lista las citas agendadas.	appointments:read
reschedule_appointment	Reagenda una cita (también mueve el evento de Google Calendar, la reunión de Zoom y el recordatorio).	appointments:write
list_meal_plans	Lista los planes alimenticios de un paciente.	meal_plans:read
get_meal_plan	Lee un plan alimenticio con sus días, comidas, alimentos y macros.	meal_plans:read
create_meal_plan	Crea un plan alimenticio como borrador.	meal_plans:write
update_meal_plan	Edita un plan alimenticio.	meal_plans:write
send_meal_plan	Envía el plan al paciente.	meal_plans:write
search_foods	Busca alimentos (5 resultados, 50 búsquedas al día por cuenta).	library:read
list_recipes	Lista las recetas de la cuenta.	library:read
get_recipe	Lee una receta con sus ingredientes y nutrientes.	library:read
create_recipe	Crea una receta privada y calcula sus nutrientes.	library:write
get_clinical_history	Lee la historia clínica de un paciente.	clinical:read
list_consultations	Lista las consultas de un paciente con notas y mediciones.	clinical:read
search_help_center	Busca en el centro de ayuda de Almendra.	ninguno
get_help_article	Lee un artículo del centro de ayuda.	ninguno

Siempre bajo control

• Los planes que crea el asistente se guardan como borrador, y el asistente pide confirmación antes de cambiar o enviar algo.
• Los resultados de laboratorio nunca se comparten con asistentes de IA, aunque se permitan los datos clínicos.

Cómo conectarlo

• Claude: en Personalizar › Conectores, haz clic en +, elige Agregar conector personalizado y escribe https://api.almendra.io/mcp.
• ChatGPT: en Plugins, haz clic en Add, elige Add custom MCP server, escribe https://api.almendra.io/mcp y elige OAuth.

Guía paso a paso, con los plugins de ChatGPT y Claude: Cómo usar Almendra desde ChatGPT y Claude.

Para desarrolladores

¿Prefieres una clave de API? Mira la API de Almendra para desarrolladores.