Configuração do MCP

O Model Context Protocol (MCP) da Caramelo AI é um padrão aberto que permite conectar assistentes de Inteligência Artificial (como Claude Desktop, ChatGPT e Gemini) diretamente aos dados do seu projeto de forma segura e em tempo real.

Com essa integração, a IA de sua escolha ganha a capacidade de consultar e analisar métricas, leads, conversas e o desempenho de suas campanhas de forma autônoma e segura.

🚀 Como acessar o painel MCP

1. Acesse o Painel Administrativo da Caramelo AI.
2. Navegue até o seu projeto.
3. No menu lateral, acesse Integrações.
4. No card Model Context Protocol (MCP), clique em Gerenciar.

Nesta página, você encontrará a sua URL de Conexão exclusiva do projeto e a lista de conexões ativas.

⚙️ Instruções de Configuração por Cliente

A URL de conexão do seu projeto possui o seguinte formato padrão: https://api.carameloai.com/mcp/projects/<PROJECT_ID>

🟣 Claude Desktop (Conexão Local/stdio)

Para disponibilizar os dados do seu projeto Caramelo AI no seu Claude Desktop local, você pode usar a ponte npx fornecida pelo SDK oficial do MCP.

1. Abra ou crie o arquivo de configuração do Claude Desktop no seu sistema operacional:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Insira a seguinte estrutura sob a chave mcpServers (substituindo o identificador pelo ID obtido no seu Painel):

{
  "mcpServers": {
    "caramelo-vendedor": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/sdk",
        "connect",
        "https://api.carameloai.com/mcp/projects/SEU_PROJECT_ID"
      ]
    }
  }
}

3. Reinicie o Claude Desktop. Um ícone de tomada (plug) aparecerá no chat indicando que as ferramentas foram carregadas e estão prontas para uso.

🟢 ChatGPT (Custom GPTs / Connectors)

O ChatGPT suporta a integração remota com o fluxo de autorização automática (OAuth 2.1) e registro dinâmico.

1. No ChatGPT, acesse Explore GPTs -> Create GPT.
2. Na aba Configure, role até Actions e clique em Create new action.
3. Na seção de Autenticação, selecione OAuth e preencha as configurações utilizando a URL base de conexão obtida no painel. O ChatGPT fará o auto-registro (DCR) no nosso servidor.
4. Quando o usuário interagir com o Custom GPT pela primeira vez, ele será redirecionado para a tela de login e consentimento da Caramelo AI.
5. Após aprovar, a conexão será estabelecida e listada nas Conexões Ativas do seu painel administrativo.

🔵 Gemini CLI / Clientes compatíveis com SSE

Para ferramentas CLI ou clientes customizados que utilizam transporte via Server-Sent Events (SSE):

• Configure o cliente apontando para a URL de conexão HTTP do seu projeto.
• O cliente MCP receberá um desafio 401 Unauthorized com o cabeçalho WWW-Authenticate contendo as informações da tela de consentimento.
• Siga as instruções do cliente para concluir a autenticação no navegador.

📊 Ferramentas Disponíveis para a IA

Uma vez conectado, o assistente de IA poderá acionar as seguintes ferramentas (tools) quando você solicitar no chat:

🔒 Segurança e Controle

[!IMPORTANT] Isolamento de Dados: Cada conexão é estritamente vinculada ao projeto selecionado. O assistente não consegue visualizar dados de outros projetos sem uma nova autorização explícita.

[!TIP] Revogação Instantânea: Se você perder o acesso ao dispositivo ou quiser encerrar a conexão de um assistente de IA, vá para a seção Conexões Ativas na página do MCP no painel e clique em Revogar ao lado da conexão correspondente. O token será invalidado na mesma hora.

[!WARNING] Limites de Requisição (Rate Limiting): Para garantir a estabilidade da plataforma, cada projeto possui um limite de 30 requisições por minuto ao servidor MCP.

🙋 Perguntas Frequentes (FAQ)