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

# MCP Server

> Conecte agentes de IA diretamente à LiderHub usando o protocolo MCP

<Warning>
  **MCP Server descontinuado temporariamente.** O MCP Server da LiderHub foi descontinuado e não está mais disponível para uso no momento. Estamos trabalhando em uma nova versão e pretendemos relançá-lo no futuro. As informações abaixo são mantidas apenas para referência histórica.
</Warning>

## O que é o MCP?

O **Model Context Protocol (MCP)** é um protocolo aberto que permite que agentes de IA se conectem diretamente a ferramentas e dados externos. Com o MCP Server da LiderHub, você podia integrar assistentes de IA como **Claude**, **Cursor**, **Windsurf** e outros clientes compatíveis diretamente ao seu workspace.

## Por que usar o MCP?

<CardGroup cols={2}>
  <Card title="Automação inteligente" icon="robot">
    Permita que agentes de IA consultem conversas, enviem mensagens e gerenciem contatos automaticamente.
  </Card>

  <Card title="Integração nativa" icon="link">
    Conecte ferramentas como Claude Desktop, Cursor e outros clientes MCP diretamente ao seu workspace.
  </Card>

  <Card title="Contexto em tempo real" icon="clock">
    Seus agentes de IA têm acesso aos dados mais recentes do seu workspace, sem necessidade de exportações manuais.
  </Card>

  <Card title="Segurança" icon="shield-check">
    Cada workspace possui sua própria chave de autenticação, garantindo isolamento e controle de acesso.
  </Card>
</CardGroup>

## Pré-requisito: chave de API

O MCP Server usa a mesma autenticação da API REST da LiderHub. Para gerar a sua chave:

<Steps>
  <Step title="Acesse a plataforma">
    Entre em [chat.liderhub.ai](https://chat.liderhub.ai) com a conta do workspace que vai usar o MCP.
  </Step>

  <Step title="Abra a aba Credenciais API">
    No menu lateral, vá em **Configurações → Credenciais API**.
  </Step>

  <Step title="Gere uma nova chave">
    Clique em **Gerar nova chave**, dê um nome para identificar o uso (por exemplo, `Claude Desktop` ou `Cursor`) e copie o valor exibido.
  </Step>

  <Step title="Guarde com segurança">
    A chave só é exibida uma vez. Guarde em um gerenciador de senhas — se perder, gere outra e atualize seus clientes.
  </Step>
</Steps>

<Tip>
  A mesma chave é compartilhada entre o MCP Server e a [API REST](/api/visao-geral) da LiderHub — você pode reaproveitar credenciais existentes.
</Tip>

## Configuração

Para conectar um cliente MCP à LiderHub, adicione a seguinte configuração:

```json theme={null}
{
  "mcpServers": {
    "liderhub": {
      "url": "https://mcp.liderhub.com.br/mcp",
      "headers": {
        "x-company-key": "SUA_CHAVE_AQUI"
      }
    }
  }
}
```

<Warning>
  Substitua `SUA_CHAVE_AQUI` pela chave de API do seu workspace. Nunca compartilhe sua chave com terceiros.
</Warning>

### Onde configurar

<AccordionGroup>
  <Accordion title="Claude Desktop" icon="message">
    Edite o arquivo de configuração do Claude Desktop:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  </Accordion>

  <Accordion title="Cursor" icon="code">
    Acesse **Settings → MCP** e adicione a configuração do servidor LiderHub.
  </Accordion>

  <Accordion title="Outros clientes" icon="plug">
    Consulte a documentação do seu cliente MCP para saber onde adicionar a configuração de servidores.
  </Accordion>
</AccordionGroup>

## Ferramentas disponíveis

O MCP Server da LiderHub disponibiliza 14 ferramentas para interagir com seu workspace:

### Conexões

| Ferramenta         | Descrição                                     |
| ------------------ | --------------------------------------------- |
| `list_connections` | Lista todas as conexões WhatsApp do workspace |
| `get_connection`   | Busca os detalhes de uma conexão específica   |

### Conversas

| Ferramenta          | Descrição                                                                                       |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| `query_contacts`    | Busca contatos/conversas com filtros avançados (número, data, status, departamento, tags, etc.) |
| `get_contact`       | Busca os detalhes de um contato/conversa específico                                             |
| `mark_contact_read` | Marca um contato/conversa como lida                                                             |

### Mensagens

| Ferramenta      | Descrição                                                  |
| --------------- | ---------------------------------------------------------- |
| `list_messages` | Lista mensagens de uma conversa com paginação              |
| `get_message`   | Busca os detalhes de uma mensagem específica               |
| `send_message`  | Envia mensagem de texto, imagem, vídeo, áudio ou documento |

### Configurações do workspace

| Ferramenta         | Descrição                                        |
| ------------------ | ------------------------------------------------ |
| `list_status`      | Lista os status configurados no workspace        |
| `list_sources`     | Lista as origens configuradas no workspace       |
| `list_tags`        | Lista as tags configuradas no workspace          |
| `list_departments` | Lista os departamentos configurados no workspace |

### Usuários e agentes

| Ferramenta    | Descrição                           |
| ------------- | ----------------------------------- |
| `list_users`  | Lista os usuários do workspace      |
| `list_agents` | Lista os agentes de IA configurados |

## Exemplos de uso

Uma vez configurado, você pode conversar naturalmente com seu agente de IA:

<AccordionGroup>
  <Accordion title="Consultar conversas recentes" icon="messages">
    > Liste as últimas 10 conversas abertas do meu workspace

    O agente usará `query_contacts` com os filtros apropriados.
  </Accordion>

  <Accordion title="Buscar conversa por número" icon="phone">
    > Encontre a conversa com o número 11999998888

    O agente usará `query_contacts` filtrando pelo número.
  </Accordion>

  <Accordion title="Enviar mensagem" icon="paper-plane">
    > Envie uma mensagem para o contato João Silva dizendo "Olá, tudo bem?"

    O agente usará `query_contacts` para encontrar o contato e `send_message` para enviar.
  </Accordion>

  <Accordion title="Verificar mensagens não lidas" icon="envelope">
    > Quais conversas têm mensagens não lidas?

    O agente usará `query_contacts` com o filtro `hasUnread: true`.
  </Accordion>

  <Accordion title="Listar agentes de IA" icon="robot">
    > Quais agentes de IA estão configurados no meu workspace?

    O agente usará `list_agents` para retornar a lista.
  </Accordion>
</AccordionGroup>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre MCP Server">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=MCP%20Server&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>