Passar para o conteúdo principal

Como conectar uma ferramenta de IA com Elephan via MCP

A integração via MCP (Model Context Protocol) permite conectar assistentes de IA como ChatGPT, Claude e Gemini diretamente aos dados da Elephan.

Com essa conexão, você pode consultar reuniões, scorecards, conversas de WhatsApp, insights e informações do seu time utilizando linguagem natural, sem precisar exportar relatórios ou acessar múltiplas telas da plataforma.

O que é o MCP?

O MCP (Model Context Protocol) é um padrão utilizado por ferramentas de IA para se conectar a sistemas externos de forma segura.

Ao conectar a Elephan via MCP, sua ferramenta de IA passa a consultar os dados da sua conta diretamente na plataforma, respeitando as permissões do seu time.

1. Acesse a área de Integrações

No menu lateral esquerdo, acesse:

Integrações → API / Webhooks / MCP

Localize o card MCP e clique sobre ele para abrir as configurações da integração.

2. Copie o endereço do servidor MCP

Ao abrir o painel lateral, será exibido o endereço do servidor MCP da Elephan.

A autenticação do MCP utiliza a mesma chave de API (elk_...) da sua equipe.

A plataforma disponibiliza dois tipos de chave:

  • API do time: vinculada ao time e utilizada para acessar os dados disponíveis para esse time.

  • API individual: vinculada ao usuário que gerou a chave e utiliza as permissões de acesso desse usuário.

Para obter sua chave:

  1. Retorne para Integrações → API / Webhooks / MCP.

  2. Localize o card API.

  3. Escolha o tipo de chave que deseja gerar.

  4. Gere uma nova chave.

  5. Copie e armazene a chave em um local seguro.

Importante: a chave de API é exibida somente uma vez, no momento da criação. Salve a chave em um local seguro antes de fechar a tela.

Caso a chave seja perdida, ela não poderá ser visualizada novamente. Nesse caso, será necessário revogar a chave anterior e gerar uma nova para realizar a conexão novamente.

Somente Super Adms conseguem administrar a API do Time

4. Nas configurações da ferramenta de IA:

Nas configurações da ferramenta de IA:

  1. Adicione um novo conector personalizado.

  2. Informe um nome para a conexão, como Elephan MCP.

  3. Informe o endereço do servidor MCP da Elephan:

https://mcp.elephan.dev/mcp

4. Caso a ferramenta solicite campos como OAuth Client ID ou OAuth Client Secret, eles podem ser deixados em branco.

5. Clique em Add para criar o conector.

6. Após a criação, será exibida uma tela solicitando sua chave de API da Elephan (elk_...).

6. Cole sua chave de API e clique em Authorize.

Importante: sua chave é utilizada apenas para autenticar a conexão e não fica armazenada nas conversas da ferramenta de IA.

5. Conexão realizada

Após concluir a autenticação, sua ferramenta de IA poderá consultar os dados disponíveis na Elephan.

Nenhuma configuração adicional é necessária.

O que a integração permite?

1. Consultar reuniões e transcrições

A ferramenta de IA poderá acessar informações como:

  • Reuniões transcritas

  • Transcrições completas

  • Respostas dos scorecards

  • Palavras-chave identificadas

  • Tipos de reunião configurados

2. Consultar usuários da equipe

Também é possível consultar:

  • Usuários ativos e inativos

  • Últimos acessos

  • Perfis e permissões

  • Informações cadastrais disponíveis

3. Consultar conversas de WhatsApp

Quando a integração de WhatsApp estiver configurada, a IA poderá consultar:

  • Conversas

  • Mensagens

  • Quantidade de interações

  • Análises geradas pela Elephan

4. Consultar scorecards

A IA pode gerar análises utilizando:

  • Desempenho por vendedor

  • Desempenho por pergunta

  • Notas por reunião

  • Médias e tendências

5. Consultar insights

Também ficam disponíveis:

  • Insights extraídos automaticamente

  • Agrupamentos de insights

  • Categorias identificadas

  • Tendências encontradas nas reuniões e conversas

Segurança e permissões

Acesso restrito ao seu time

Cada chave de API possui acesso apenas aos dados da equipe à qual ela pertence.

A ferramenta de IA não consegue visualizar informações de outros times.

Acesso somente leitura

O MCP permite apenas consultas.

Nenhuma informação pode ser criada, alterada ou removida através da integração.

Limites de uso

A integração utiliza os mesmos limites da API da Elephan definidos para o plano contratado.

Importante

  • O MCP utiliza a mesma chave de API já disponível na plataforma.

  • A chave de API nunca aparece nas conversas da ferramenta de IA após a autenticação.

  • O acesso é restrito aos dados do time proprietário da chave.

  • A integração possui acesso somente leitura.

  • Caso a chave seja revogada ou rotacionada, será necessário realizar uma nova autenticação.

  • O endereço do servidor pode variar entre ambientes de produção e homologação.

  • O MCP não altera informações dentro da Elephan; ele apenas consulta os dados disponíveis.

Se surgir qualquer dúvida, não hesite em nos contatar pela plataforma ou através do e-mail ajuda@elephan.ai

Respondeu à sua pergunta?