> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> O que é o MCPipo e o que dá para consultar com ele

O **MCPipo** é o servidor [MCP](https://modelcontextprotocol.io) 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](https://app.piposaude.com.br/) nem escrever código.

<Warning>
  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](https://app.piposaude.com.br/) ou os endpoints de movimentação da [Pipo Public API](/api-reference/inclusao-em-lote).
</Warning>

## 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.

<Note>
  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`.
</Note>

<Warning>
  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`](/mcp/tools/saude/consultar-contexto-relatorio-saude), que faz essa resolução sozinha a partir do CNPJ e mostra o recorte disponível.
</Warning>

## 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.

<Note>
  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.
</Note>

## MCPipo e Pipo Public API

São duas superfícies distintas, para públicos distintos:

|             | MCPipo                                                  | Pipo Public API                               |
| ----------- | ------------------------------------------------------- | --------------------------------------------- |
| Para quem   | Quem cuida dos benefícios no dia a dia                  | Times de tecnologia e parceiros de integração |
| Como se usa | Perguntas em linguagem natural, por um assistente de IA | Requisições HTTP, em código                   |
| O que faz   | Somente consulta                                        | Consulta e movimentação                       |

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

<CardGroup cols={2}>
  <Card title="Instalação" icon="plug" href="/mcp/instalacao">
    Como liberar o acesso e conectar o MCPipo ao Claude ou ao ChatGPT.
  </Card>

  <Card title="Ferramentas" icon="wrench" href="/mcp/tools/empresas/listar-empresas">
    A lista completa do que dá para consultar, com os parâmetros de cada ferramenta.
  </Card>

  <Card title="Pipo Public API" icon="code" href="/docs/comecar/introducao">
    Se o seu time precisa de integração programática em vez de consulta em linguagem natural.
  </Card>

  <Card title="Falar com a Pipo" icon="life-buoy" href="https://app.piposaude.com.br/">
    Em caso de dúvida no acesso, procure a sua gerente de contas.
  </Card>
</CardGroup>
