Skip to main content
O MCPipo é o servidor MCP da Pipo Saúde. Ele entrega os dados da sua operação de benefícios como ferramentas para assistentes de IA (como o Claude e o ChatGPT) para que você consulte empresas, membros, movimentações e indicadores de saúde em linguagem natural, sem abrir a Plataforma do RH nem escrever código.
O MCPipo é somente leitura. Não é possível incluir, alterar ou excluir membros, benefícios ou movimentações por meio dele. Para isso, use a Plataforma do RH ou os endpoints de movimentação da Pipo Public API.

​
O que dá para perguntar

Depois de conectado, basta perguntar ao assistente em português. Alguns exemplos:
  • “Quais empresas eu tenho acesso na Pipo?”
  • “Quais membros da empresa estão no centro de custo Engenharia?”
  • “Quais movimentações estão em andamento nessa empresa?”
  • “Qual a sinistralidade dessa empresa?”
  • “Quais procedimentos mais pesam no custo do plano?”
  • “Quanto a empresa evitou em custos com o Pipo Cuida?”
O assistente escolhe sozinho a ferramenta certa para cada pergunta. A lista completa está na referência de ferramentas, organizada em oito áreas: empresas, membros, movimentações, sinistralidade, saúde, uso do plano, analíticos e utilidades.
Boa parte das ferramentas de saúde e análise identifica a empresa por um UUID interno, não pelo CNPJ. Você não precisa saber esse identificador: basta dizer de qual empresa está falando, por CNPJ ou por nome, que o assistente o resolve sozinho a partir das empresas às quais você tem acesso — é o que fazem buscar_empresa e listar_empresas, esta última aceitando também o nome parcial da empresa.Duas exceções recebem o CNPJ diretamente, sem passar pelo UUID: consultar_contexto_relatorio_saude e relatorio_sinistralidade.
Quando o identificador for de uma filial, a consulta de saúde pode voltar sem dados. Os indicadores de saúde costumam ser publicados no nível da matriz, e é a matriz que o assistente deve usar. Em caso de dúvida, comece por consultar_contexto_relatorio_saude, que faz essa resolução sozinha a partir do CNPJ e mostra o recorte disponível.

​
O que o MCPipo não devolve

As respostas das ferramentas de saúde passam por uma remoção de dados pessoais (PII) antes de chegarem ao assistente: CPF, e-mail, telefone, endereço, data de nascimento, diagnóstico e nomes de beneficiário são retirados. O que sobra são agregados e perfis, não pessoas identificadas. Respostas muito grandes também são recusadas em vez de truncadas silenciosamente: acima de 100 mil caracteres, a ferramenta pede que você estreite o período ou consulte uma dimensão específica.
Isso vale para as ferramentas de saúde, sinistralidade, uso do plano e analíticos. As ferramentas de cadastro e movimentação devolvem os dados operacionais sem essa remoção.

​
MCPipo e Pipo Public API

São duas superfícies distintas, para públicos distintos: Os escopos não são equivalentes: uma ferramenta do MCPipo não corresponde necessariamente a um endpoint da API, e vice-versa.

​
Próximos passos

Instalação

Como liberar o acesso e conectar o MCPipo ao Claude ou ao ChatGPT.

Ferramentas

A lista completa do que dá para consultar, com os parâmetros de cada ferramenta.

Pipo Public API

Se o seu time precisa de integração programática em vez de consulta em linguagem natural.

Falar com a Pipo

Em caso de dúvida no acesso, procure a sua gerente de contas.