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 só consulta os seus dados. Não é possível incluir, alterar ou excluir membros, benefícios, movimentações ou faturas por meio dele. Para isso, use a Plataforma do RH ou os endpoints de movimentação da Pipo Public API.A única ferramenta que grava algo é registrar_feedback. Ela guarda o feedback que você envia para o time da Pipo e não altera nenhum dado da sua operação.

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?”
  • “Tem algum boleto vencido ou perto de vencer nesta empresa?”
O assistente escolhe sozinho a ferramenta certa para cada pergunta. A lista completa está na referência de ferramentas, organizada em nove áreas: empresas, membros, movimentações, sinistralidade, saúde, uso do plano, analíticos, faturamento e utilidades.
As ferramentas de saúde e análise identificam a empresa por um UUID interno, não pelo CNPJ. Você não precisa saber esse identificador. Diga de qual empresa você fala, por CNPJ ou por nome. O assistente encontra o UUID entre as empresas às quais você tem acesso, com buscar_empresa ou listar_empresas. listar_empresas aceita também parte do nome da empresa.Duas ferramentas de saúde recebem o CNPJ diretamente: consultar_contexto_relatorio_saude e relatorio_sinistralidade. As ferramentas de faturamento também recebem o CNPJ. Cada consulta de faturamento mostra só a empresa daquele CNPJ, não o grupo.
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. Ela encontra a matriz a partir do CNPJ e mostra o recorte disponível.

Regras das consultas de saúde

Estas regras valem para as ferramentas de saúde, sinistralidade, uso do plano e analíticos.
  • Escolha da operadora. Se você não informa a operadora (carrier_name), a ferramenta não consulta os indicadores. Ela mostra os contratos e as operadoras com dados publicados, para você escolher uma. Isso acontece mesmo quando a empresa tem só uma operadora. custos_evitados, dados_meajuda e maior_desvio_saude não recebem operadora.
  • Contrato e dado publicado são diferentes. Uma operadora com dados pode não ter mais contrato ativo. Um contrato novo pode ainda não ter dados. O status do contrato não confirma a cobertura atual dos beneficiários.
  • Período. Use o formato YYYY-MM. O início não pode ser depois do fim, e o intervalo tem no máximo 36 meses. Sem período, a consulta usa os últimos 12 meses, incluindo o mês atual.
  • Resposta sem resultado. A resposta diz qual é o caso. Nenhum dos três casos quer dizer zero:
    • sem dados: a origem informa que não há dados publicados;
    • sem acesso: a sua conta não tem permissão para aquela consulta;
    • indisponível: a origem falhou. Isso não confirma que os dados não existem.
  • Meses ausentes. Algumas ferramentas mostram os meses que vieram e os meses que faltam. A ferramenta não preenche um mês ausente com zero.

O que o MCPipo não devolve

As respostas das ferramentas de saúde passam por uma remoção de dados pessoais antes de chegar ao assistente. CPF, e-mail, telefone, endereço, data de nascimento, diagnóstico, nomes e identificadores de beneficiário são retirados. O que sobra são agregados e perfis, não pessoas identificadas. As respostas de saúde muito grandes são recusadas em vez de cortadas sem aviso. Acima de 100 mil caracteres, a ferramenta pede que você reduza o período ou consulte uma dimensão específica. As ferramentas de cadastro e movimentação usam outra regra. Elas devolvem só os campos operacionais: identificadores, nome, status, empresa, centro de custo e datas. CPF, matrícula, data de nascimento, e-mail, telefone, endereço e dados financeiros ficam de fora. A exceção é listar_aniversariantes_empresa: ela mostra o dia do aniversário e a idade nova, e com isso dá para saber a data de nascimento.
Os documentos de fatura não passam por essa remoção. Ao ler um boleto ou demonstrativo, o MCPipo esconde o texto com formato de CPF ou de e-mail, mas nomes e outros dados pessoais podem continuar no documento. O link de download dá acesso ao arquivo original: compartilhe-o só com quem pediu.

Listas longas

As listas de empresas, membros e movimentações podem ter milhares de itens. Nesse caso, a ferramenta não devolve tudo de uma vez:
  • Sem limite, a resposta traz um link para a lista completa, dividida em páginas de até 50 itens. O assistente lê página por página até o fim. Se o seu assistente não abre esse link, ele usa ler_pagina_listagem. Nas listas de membros, o link só vem sem filtros. Em movimentacoes_ativas e historico_movimentacoes, o link só vem sem datas.
  • Com limite, ou com esses filtros e datas, a resposta traz a lista na própria conversa, até o limite (padrão 50). Essa lista pode não estar completa.
A resposta avisa quando uma lista está incompleta. As ferramentas de faturamento usam outra regra. Elas sempre trazem a primeira página na conversa, com até 50 itens. Nelas, limite só muda o tamanho da página. Quando há mais itens, a resposta traz um next_uri, que o assistente lê com ler_pagina_faturamento.
Nenhuma ferramenta de faturamento confirma pagamento. O total de uma fatura não é o valor em aberto, e a ausência de alertas não quer dizer que a fatura foi paga.

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.