> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://hoopdecor.crisp.help/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 o HoopCRM ao Claude via MCP

A integração do HoopCRM com o Claude via MCP (Model Context Protocol) permite que você utilize a inteligência artificial do Claude com acesso direto aos dados da sua loja no Hoop. Com isso, é possível fazer perguntas, analisar informações e executar ações dentro do sistema diretamente pelo Claude Desktop, sem precisar alternar entre plataformas. Este guia detalha o passo a passo para configurar essa conexão.

Neste artigo, você verá:
* [Gerando o Token de Integração no HoopCRM](#3-gerando-o-token-de-integracao-no-hoopcrm)
* [Criando a Chave de API no Claude](#3-criando-a-chave-de-api-no-claude)
* [Conectando o HoopCRM ao Claude Desktop](#3-conectando-o-hoopcrm-ao-claude-desktop)
* [Configurando as Permissões do Conector](#3-configurando-as-permissoes-do-conector)
* [Utilizando o Conector nas Conversas](#3-utilizando-o-conector-nas-conversas)

### Gerando o Token de Integração no HoopCRM
1. No menu principal do HoopCRM, acesse o menu **Loja** passando o mouse sobre o ícone de perfil.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot6_1qx08gq.png =273xauto)

2. Dentro de Loja, clique em **"Tokens e Integrações"**.
3. Clique em **"Novo Token"** e defina um nome para identificá-lo (ex: *Claude MCP*).

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_ltqhbw.gif =969xauto)

### Criando a Chave de API no Claude
1. Acesse a [plataforma de chaves do Claude](https://platform.claude.com/settings/keys) e faça login.
2. Navegue até a página de **Chaves de API** e clique em **"Criar nova chave"**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot7_5f8hpx.png =1004xauto)
3. Dê o nome que preferir, clique em **Adicionar** e copie a chave gerada.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek2_1vk1ml0.gif =964xauto)

4. Copie a chave gerada, volte ao HoopCRM, cole no campo correspondente e clique em **"Criar"**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot8_j3bmvz.png =510xauto)

Após criar, o sistema exibirá a **URL do conector MCP**. Copie essa URL — ela será utilizada na próxima etapa.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot9_1eekraq.png =789xauto)


### Conectando o HoopCRM ao Claude Desktop

1. Abra o **Claude** e acesse **Personalizar** clicando 
2. Vá em **"Conectores"** e clique em **"Adicionar Conector Personalizado"**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_418ni3.gif =973xauto)

3. Preencha os campos:
* **Nome**: Ex: Hoop (ou o nome que preferir para identificar o conector)
* **URL:** cole a URL do conector MCP copiada anteriormente
4. Clique em **"Adicionar"**. O conector Hoop aparecerá na lista com seu ícone, indicando que foi configurado com sucesso.

### Configurando as Permissões do Conector
1. Clique no conector **Hoop** recém-adicionado para acessar as **Permissões de Ferramenta**.
2. Para evitar ter que aprovar manualmente cada ação durante as conversas, altere a permissão para **"Sempre Permitir"** em todas as opções disponíveis.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/screenshot10_1qaw7m9.png =866xauto)
> Você também pode revisar nessa tela quais ferramentas e dados do HoopCRM o conector tem acesso.

### Utilizando o Conector nas Conversas
Com a configuração concluída, abra uma **nova conversa** no Claude. O conector Hoop estará ativo e visível na conversa.
Você pode perguntar livremente, por exemplo:
*"O que eu consigo fazer com o MCP do Hoop?"*
O Claude irá analisar os dados disponíveis e apresentar as possibilidades de uso.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/7/a/377a4172135ea400/peek1_12jsmye.gif =528xauto)
Caso queira que o Claude não acesse os dados do Hoop em uma conversa específica, basta **desligar o conector** diretamente na janela da conversa. Isso não remove a integração — apenas desativa o acesso para aquela sessão.
||| IMPORTANTE: Para gerar os dashboards no Claude, é necessário possuir créditos: https://platform.claude.com/settings/billing

|| Com o HoopCRM conectado ao Claude via MCP, sua equipe passa a contar com um assistente de IA com acesso em tempo real aos dados da loja, agilizando consultas, análises e operações do dia a dia sem sair do fluxo de trabalho.