Servidor MCP da Almendra

O servidor MCP da Almendra permite que o ChatGPT, o Claude e qualquer cliente do Model Context Protocol trabalhem dentro de uma conta da Almendra: buscar pacientes, criar e enviar planos alimentares, buscar alimentos, criar receitas e reagendar consultas, com as permissões que o dono da conta escolher.

Dados de conexão

• URL do servidor: https://api.almendra.io/mcp
• Transporte: Streamable HTTP.
• Autenticação: OAuth 2.1, sem chave de API. Sem token, o servidor responde 401 com WWW-Authenticate apontando para seus metadados (https://api.almendra.io/.well-known/oauth-protected-resource/mcp, RFC 9728). Os clientes se registram com um Client ID Metadata Document.
• Quem pode conectar: o dono de uma conta da Almendra com plano pago. Ele escolhe as permissões na tela de consentimento e pode desconectar em Configurações › Desenvolvedores › ChatGPT e Claude.

Ferramentas

Cada ferramenta só aparece se a conta deu a permissão.

Ferramenta	O que faz	Permissão
find_patients	Busca pacientes por nome ou e-mail.	patients:read
get_patient	Lê o perfil de um paciente.	patients:read
list_appointments	Lista as consultas agendadas.	appointments:read
reschedule_appointment	Reagenda uma consulta (o evento do Google Agenda, a reunião do Zoom e o lembrete também mudam).	appointments:write
list_meal_plans	Lista os planos alimentares de um paciente.	meal_plans:read
get_meal_plan	Lê um plano alimentar com seus dias, refeições, alimentos e macros.	meal_plans:read
create_meal_plan	Cria um plano alimentar como rascunho.	meal_plans:write
update_meal_plan	Edita um plano alimentar.	meal_plans:write
send_meal_plan	Envia o plano ao paciente.	meal_plans:write
search_foods	Busca alimentos (5 resultados, 50 buscas por dia por conta).	library:read
list_recipes	Lista as receitas da conta.	library:read
get_recipe	Lê uma receita com seus ingredientes e nutrientes.	library:read
create_recipe	Cria uma receita privada e calcula seus nutrientes.	library:write
get_clinical_history	Lê o histórico clínico de um paciente.	clinical:read
list_consultations	Lista as consultas de um paciente com notas e medidas.	clinical:read
search_help_center	Busca na central de ajuda da Almendra.	nenhuma
get_help_article	Lê um artigo da central de ajuda.	nenhuma

Sempre no controle

• Os planos que o assistente cria ficam como rascunho, e ele pede confirmação antes de mudar ou enviar algo.
• Os resultados de exames nunca são compartilhados com assistentes de IA, mesmo com os dados clínicos permitidos.

Como conectar

• Claude: em Personalizar › Conectores, clique em +, escolha Adicionar conector personalizado e digite https://api.almendra.io/mcp.
• ChatGPT: em Plugins, clique em Add, escolha Add custom MCP server, digite https://api.almendra.io/mcp e escolha OAuth.

Guia passo a passo, com os plugins do ChatGPT e do Claude: Como usar a Almendra no ChatGPT e no Claude.

Para desenvolvedores

Prefere uma chave de API? Veja a API da Almendra para desenvolvedores.