Pular para o conteúdo principal

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.

​
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ê pode integrar assistentes de IA como Claude, Cursor, Windsurf e outros clientes compatíveis diretamente ao seu workspace.
O MCP Server da LiderHub está em fase beta, mas já está disponível para uso em qualquer workspace. Para começar, basta gerar uma chave de API em Configurações → Credenciais API dentro da plataforma.

​
Por que usar o MCP?

Automação inteligente

Permita que agentes de IA consultem conversas, enviem mensagens e gerenciem contatos automaticamente.

Integração nativa

Conecte ferramentas como Claude Desktop, Cursor e outros clientes MCP diretamente ao seu workspace.

Contexto em tempo real

Seus agentes de IA têm acesso aos dados mais recentes do seu workspace, sem necessidade de exportações manuais.

Segurança

Cada workspace possui sua própria chave de autenticação, garantindo isolamento e controle de acesso.

​
Pré-requisito: chave de API

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

Acesse a plataforma

Entre em chat.liderhub.ai com a conta do workspace que vai usar o MCP.
2

Abra a aba Credenciais API

No menu lateral, vá em Configurações → Credenciais API.
3

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

Guarde com segurança

A chave só é exibida uma vez. Guarde em um gerenciador de senhas — se perder, gere outra e atualize seus clientes.
A mesma chave é compartilhada entre o MCP Server e a API REST da LiderHub — você pode reaproveitar credenciais existentes.

​
Configuração

Para conectar um cliente MCP à LiderHub, adicione a seguinte configuração: 
{
  "mcpServers": {
    "liderhub": {
      "url": "https://mcp.liderhub.com.br/mcp",
      "headers": {
        "x-company-key": "SUA_CHAVE_AQUI"
      }
    }
  }
}
Substitua SUA_CHAVE_AQUI pela chave de API do seu workspace. Nunca compartilhe sua chave com terceiros.

​
Onde configurar

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
Acesse Settings → MCP e adicione a configuração do servidor LiderHub.
Consulte a documentação do seu cliente MCP para saber onde adicionar a configuração de servidores.

​
Ferramentas disponíveis

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

​
Conexões

FerramentaDescrição
list_connectionsLista todas as conexões WhatsApp do workspace
get_connectionBusca os detalhes de uma conexão específica

​
Conversas

FerramentaDescrição
query_contactsBusca contatos/conversas com filtros avançados (número, data, status, departamento, tags, etc.)
get_contactBusca os detalhes de um contato/conversa específico
mark_contact_readMarca um contato/conversa como lida

​
Mensagens

FerramentaDescrição
list_messagesLista mensagens de uma conversa com paginação
get_messageBusca os detalhes de uma mensagem específica
send_messageEnvia mensagem de texto, imagem, vídeo, áudio ou documento

​
Configurações do workspace

FerramentaDescrição
list_statusLista os status configurados no workspace
list_sourcesLista as origens configuradas no workspace
list_tagsLista as tags configuradas no workspace
list_departmentsLista os departamentos configurados no workspace

​
Usuários e agentes

FerramentaDescrição
list_usersLista os usuários do workspace
list_agentsLista os agentes de IA configurados

​
Exemplos de uso

Uma vez configurado, você pode conversar naturalmente com seu agente de IA:
Liste as últimas 10 conversas abertas do meu workspace
O agente usará query_contacts com os filtros apropriados.
Encontre a conversa com o número 11999998888
O agente usará query_contacts filtrando pelo número.
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.
Quais conversas têm mensagens não lidas?
O agente usará query_contacts com o filtro hasUnread: true.
Quais agentes de IA estão configurados no meu workspace?
O agente usará list_agents para retornar a lista.

​
Deixe uma sugestão

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.
Last modified on May 28, 2026