> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://ajuda.elephan.ai/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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 Acesse o menu **Configurações** e clique em **Integrações.** ![](https://storage.crisp.chat/users/helpdesk/website/-/b/d/4/c/bd4c134420dbe000/image_1gqdjcz.png =335x335) Localize API / Webhooks / **MCP** e clique em MCP para abrir as configurações da integração. [![](https://storage.crisp.chat/users/helpdesk/website/-/a/b/1/8/ab1841b00d2fb000/6fda9ba3-ebc9-4a24-8142-027188_12uhmjm.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2590515092/ede4b54303a6d599ba2cf98d47a2/image+-42-.png?expires=1791376200\&signature=61e8776295bc0a6f08cefb0cd9e569471c22010f5c50174276c06021994f6433\&req=diUuFsx%2FmIFWW%2FMW1HO4zUEx%2FS8dvKiRyDYGMINSJLOW5x2lXHQp%2BdKoSPZb%0ATQjOFkI234WyTkanjL0%3D%0A) ## 2. Copie o endereço do servidor MCP Ao abrir o painel lateral, será exibido o endereço do servidor MCP da Elephan. [![](https://storage.crisp.chat/users/helpdesk/website/-/f/6/3/9/f639db56d9ac000/d81c3e75-86e5-41ad-8707-1cacc6_ave9e8.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2590522863/b491c99abd793275a62923ef73f1/image.png?expires=1791376200\&signature=648088adfb6608800dc25a38c80bb2b477029c3a34c6866641c0114e5aec9b5b\&req=diUuFsx8n4lZWvMW1HO4zaRV4gZsup0X4eSdR%2FPmrOb0tb7HCiqnAIOrXCeG%0AQblrewPK4mYQx4XysCg%3D%0A) ## 3. Gere sua chave de API 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**. Localize o card **API**. [![](https://storage.crisp.chat/users/helpdesk/website/-/3/6/c/d/36cd5f58ae72d200/de02465b-7df2-441f-a038-c355eb_u7acrv.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674718338/ccfff18c772a19a2101fca1aedc7/image.png?expires=1791376200\&signature=abf2c39372377ab8c66cbc952e87d93f12d4e9a0641bdaefd4454792dcbeabed\&req=diYgEs5%2FlYJcUfMW1HO4zZF2%2FfTsb%2FaNAnJDi5ecLGkQ7R4V%2FZbEZfoS2XBX%0A6TvN%0A) Escolha o tipo de chave que deseja gerar. [![](https://storage.crisp.chat/users/helpdesk/website/-/e/c/b/4/ecb41c3c5e45d800/fd26276a-fab0-4000-82ad-c2c191_1704h6j.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674718639/492843096ef39ffdca816c567537/image.png?expires=1791376200\&signature=c041e342b64eaa7e53be4dd4683252c9a88ab15e4998994a12352cbc9781dc14\&req=diYgEs5%2FlYdcUPMW1HO4zVmTzqDIaoKg7tNaUuUqaT5MRMtLydohXRx%2FhHIe%0AyxJb%0A) 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. [![](https://storage.crisp.chat/users/helpdesk/website/-/e/5/b/1/e5b1939233b89000/de7f3a24-183d-4194-9e8d-a647c0_5t5ofr.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2590829452/b7b725e80ccb8e7d80688125aad1/image+-46-.png?expires=1791376200\&signature=ab4f5cbab11631b32a63a7c7a8f7367e6232f03478782886c917cf178def2f05\&req=diUuFsF8lIVaW%2FMW1HO4zToesYGoc9nQ3k59xmz9WySwjuclMRHIrw7O%2Bmk4%0ABTAFcNsvmc4zuqL6ncI%3D%0A) 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_...`). [![](https://storage.crisp.chat/users/helpdesk/website/-/7/0/e/d/70ed53283883380/6e348923-a8f4-45a3-b716-f6bc5c_10wbyxa.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2590831768/25fa71233d857b97805a4aa595c7/image+-44-.png?expires=1791376200\&signature=7079a5964779b3f35e989b0da199958add511af5f1d1ed9224f0404d126af0a2\&req=diUuFsF9nIZZUfMW1HO4zZtmNp7%2FRxmzMV4GM%2FbmU1nReNx1ju9zlJBYTtRC%0AErRnA5Y3vIVO67Ml3FA%3D%0A) 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