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

# Instalação

> Como liberar o acesso e conectar o MCPipo ao Claude e ao ChatGPT

O MCPipo é um servidor remoto: você não instala nada na máquina, apenas adiciona a URL abaixo como conector no seu assistente.

|                 |                                       |
| --------------- | ------------------------------------- |
| URL do servidor | `https://mcpipo.piposaude.com.br/mcp` |
| Transporte      | HTTP, com OAuth 2.1                   |

## Claude

Vale tanto para o aplicativo de desktop do Claude quanto para o [claude.ai](https://claude.ai) no navegador.

<Steps>
  <Step title="Abra os conectores">
    Nas configurações do Claude, vá em `Personalizar > Conectores`.
  </Step>

  <Step title="Adicione um conector personalizado">
    No canto superior direito, clique em `Adicionar` e depois em `Adicionar conector personalizado`.
  </Step>

  <Step title="Preencha o formulário">
    Nome: `MCPipo`. URL do servidor MCP remoto: `https://mcpipo.piposaude.com.br/mcp`.

    Deixe os campos em `Configurações avançadas` vazios e finalize clicando em `Adicionar`.
  </Step>

  <Step title="Vincule">
    O MCPipo aparecerá na listagem de conectores. Clique em `Vincular` (ou `Connect`) na linha dele e siga o [fluxo de autenticação](#autenticação).
  </Step>
</Steps>

<Accordion title="O botão 'Adicionar conector personalizado' não aparece">
  Nesse caso, configure o MCPipo pelo arquivo de configurações global do Claude.

  Abra `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows) e adicione:

  ```json claude_desktop_config.json theme={null}
  {
    "mcpServers": {
      "MCPipo": {
        "type": "http",
        "url": "https://mcpipo.piposaude.com.br/mcp"
      }
    }
  }
  ```

  Reinicie o Claude Desktop em seguida.
</Accordion>

## Claude Code

No terminal, registre o servidor:

```bash theme={null}
claude mcp add --transport http mcpipo https://mcpipo.piposaude.com.br/mcp
```

Depois, dentro de uma sessão do Claude, rode `/mcp`, selecione `mcpipo` e escolha `Authenticate`.

## ChatGPT

No ChatGPT, servidores MCP personalizados ficam atrás do **modo desenvolvedor**, disponível apenas na versão web e nos planos **Plus, Pro, Business, Enterprise e Edu**. O plano gratuito não suporta.

<Steps>
  <Step title="Ative o modo desenvolvedor">
    Em `Configurações`, vá em `Segurança e login` (`Security and login`) e ative `Modo desenvolvedor` (`Developer mode`).
  </Step>

  <Step title="Crie o app">
    Abra `Plugins` (a seção antes chamada de `Conectores`) e clique no botão de adicionar.
  </Step>

  <Step title="Aponte para o MCPipo">
    Informe o nome `MCPipo` e a URL do servidor `https://mcpipo.piposaude.com.br/mcp`, com autenticação **OAuth**.
  </Step>

  <Step title="Autentique">
    Siga o [fluxo de autenticação](#autenticação) como nos demais clientes.
  </Step>
</Steps>

<Note>
  Ao criar o app, o ChatGPT gera uma URL de callback própria para ele. Se ela for solicitada em algum passo, copie o valor **exatamente** como aparece na configuração do app: um caractere a mais ou a menos faz a autenticação ser recusada.

  Em contas Business e Enterprise, pode ser necessário que um administrador libere o uso de servidores MCP personalizados no workspace antes que a opção apareça para você.
</Note>

<Warning>
  O modo desenvolvedor do ChatGPT é um recurso em beta, e a própria OpenAI o classifica como de risco elevado, por dar ao assistente acesso amplo às ferramentas conectadas. No caso do MCPipo isso é atenuado: todas as ferramentas são [somente leitura](/mcp/introducao) e nenhuma altera seus dados.
</Warning>

## Autenticação

Na primeira vez que você usar o MCPipo, o próprio assistente vai pedir para autenticar. Abrirá uma aba no navegador com a [Plataforma do RH](https://app.piposaude.com.br/), onde basta entrar com o **mesmo e-mail e senha de sempre**. Feito isso, o assistente já consegue consultar seus dados.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Ferramentas disponíveis" icon="wrench" href="/mcp/tools/empresas/listar-empresas">
    O que dá para consultar sobre empresas, membros e movimentações.
  </Card>

  <Card title="Introdução ao MCPipo" icon="sparkles" href="/mcp/introducao">
    O que é o MCPipo e exemplos de perguntas.
  </Card>
</CardGroup>