Passar para o conteúdo principal

Solomon IA e MCP: o que fazem e como conectar

O que a Solomon IA e o Conectar minha IA (MCP) fazem com os dados da sua loja, o que eles não mexem, como conectar no Claude, ChatGPT e outros apps, como usar com várias lojas e o que fazer quando algo não funciona.

Escrito por Nathan Lacerda

Em resumo: a IA conectada à Solomon só lê os dados da sua loja. Ela consulta vendas, pedidos, campanhas, criativos, funil e custos. Não muda nada na loja, nas contas de anúncio nem nos números da Solomon.

Existem dois jeitos de usar IA com os dados da sua loja:

Solomon IA

Conectar minha IA (MCP)

Onde fica

No menu lateral da Solomon e numa aba do app de celular

No app de IA que você já usa: Claude, ChatGPT, Claude Code, Codex, Cursor e outros compatíveis com MCP

Para que serve

Conversar com os dados, agendar rotinas, gerar relatórios e painéis, organizar tarefas no Kanban

Perguntar sobre a loja na mesma conversa em que você já trabalha

Uso

Tem uma verba de IA que depende do plano

Não usa a verba da Solomon IA

Para conhecer os recursos da Solomon IA (Context Hub, Habilidades, Kanban, Artefatos), veja Solomon IA: Como utilizar.


O que a IA faz e o que ela não mexe

O conector só lê

Pelo Conectar minha IA, a IA consulta pedidos, vendas, campanhas, criativos, funil, estoque, custos e métricas.

Ela não cria, edita nem apaga dados da loja ou das contas de anúncio:

  • não muda custo;

  • não pausa nem ativa campanha;

  • não muda orçamento;

  • não sobe anúncio;

  • não mexe nos pedidos nem nos produtos da loja.

O que ela consegue criar são coisas dela mesma dentro da Solomon: painéis e relatórios (em Artefatos) e cards no Kanban da Solomon IA.

Na Solomon IA, a loja também é só consulta

A Solomon IA consulta os mesmos dados. Se você conectar ferramentas externas, como Gmail, Google Sheets ou Slack, ela pode agir nelas quando você pedir: criar uma planilha ou mandar um e-mail, por exemplo.

Dado pessoal de cliente (nome, e-mail, telefone) só vai para uma ferramenta externa quando você pede ou confirma na conversa. Numa rotina agendada, só se as instruções da rotina pedirem.

Mexer pela tela é diferente

Na tela de Tracking, pausar, ativar ou mudar o orçamento de uma campanha muda direto na conta de anúncios, como no Gerenciador.

Para alguém da equipe ver tudo sem poder mexer:

  1. Clique no nome da loja no topo da tela.

  2. Abra Gestão de Equipe e clique em Criar novo grupo.

  3. Marque o Tracking como Somente leitura.

A IA respeita as permissões de cada usuário. Para conversar com a IA sobre os dados de tracking, a pessoa precisa ter acesso de leitura ao Tracking.

Para mudar custos, use a plataforma

  • Custo de produto: em Produtos › Custos, um a um ou pelo botão Importar planilha.

  • Custo fixo por pedido: em Integrações, no card Custo por Pedido.

  • Gastos e custos da operação: em Valores Adicionais › Gastos.


Como conectar no Claude, ChatGPT e outros apps

O caminho mais curto é a tela Conectar minha IA, no menu lateral da Solomon. Escolha o app e siga os passos: a URL vem pronta para copiar.

A URL do servidor é esta:

https://mcp-solomon-685646918301.us-east1.run.app/mcp

O login é o mesmo da Solomon: e-mail e senha, ou o botão do Google, se você entra com o Google.

Claude (navegador e app de desktop)

  1. No Claude, clique no + do campo de mensagem, depois em Conectores e em Gerenciar conectores.

  2. Clique em Adicionar conector personalizado. Preencha o nome Solomon e a URL acima, e clique em Adicionar.

  3. Clique em Vincular e entre com o seu login da Solomon.

  4. Pergunte, por exemplo: "Qual foi meu faturamento este mês?"

O passo a passo com imagens está em Como integrar com o MCP da Solomon.

ChatGPT

Disponível nos planos pagos do ChatGPT.

  1. No ChatGPT, abra Configurações › Apps › Configurações avançadas e ligue o Modo desenvolvedor.

  2. Clique em Criar app. Preencha o nome Solomon e a URL acima, escolha OAuth como autenticação e clique em Criar.

  3. Entre com o seu login da Solomon.

  4. Numa conversa nova, ative a Solomon pelo botão +.

Claude Code, Codex, Cursor e outros apps

  • Claude Code: rode claude mcp add --transport http solomon https://mcp-solomon-685646918301.us-east1.run.app/mcp. Depois, no Claude Code, digite /mcp, escolha solomon e clique em Authenticate.

  • Codex: rode codex mcp add solomon --url https://mcp-solomon-685646918301.us-east1.run.app/mcp. Se o navegador não abrir sozinho, rode codex mcp login solomon.

  • Cursor: use o botão Adicionar ao Cursor da tela Conectar minha IA. Depois, em Cursor Settings, na seção de MCP, conecte a Solomon.

  • Outro app: adicione um servidor MCP remoto (HTTP Streamable) com a URL acima.


Tenho mais de uma loja

No conector:

  • A conexão traz todas as lojas do seu login e começa pela primeira. Pergunte "quais empresas da Solomon eu tenho?" e depois peça "troque para a empresa [nome]".

  • A conversa trabalha com uma loja por vez. Para comparar duas, peça os números de uma, troque e peça os da outra.

  • Se a loja não aparece na lista, o seu login não tem acesso a ela. Peça o acesso a quem administra a conta.

Na Solomon IA: ela responde sobre a loja selecionada no topo da tela. Se a resposta parecer de outra loja, confira qual está selecionada e comece uma conversa nova.


Agendamentos (rotinas)

  • Onde criar e onde ver: a rotina se cria em Solomon IA › Agendamentos. O resultado aparece em Execuções.

  • Roda sozinha: a rotina roda no horário marcado, mesmo com a plataforma fechada.

  • Receber por e-mail: conecte o Gmail ou o Outlook em Solomon IA › Integrações e escreva nas instruções da rotina para quem enviar o resultado.

  • Pausa automática: se ninguém abre os resultados de uma rotina por 7 dias, ela mostra um aviso. Com 10 dias, ela é pausada. Abrir qualquer resultado em Execuções zera a contagem. Se a rotina foi pausada, é só religar em Agendamentos.

  • Compartilhar com o time:

    • Rotina: cada uma é de quem a criou. Para o time ver, compartilhe em Agendamentos.

    • Conversa: use o botão de compartilhar, no canto superior direito.

    • Relatório ou painel: mande o link de compartilhamento do artefato. O endereço da barra do navegador não abre para quem não tem acesso à loja.


Ferramentas externas: Google, Instagram, Clarity e outras

Em Solomon IA › Integrações (pelo computador), você conecta ferramentas como Gmail, Outlook, Google Sheets, Google Drive, Google Docs, Google Agenda, Slack, Notion, HubSpot, Klaviyo, Instagram, YouTube, Google Search Console e Microsoft Clarity.

  • A senha não passa pela Solomon. A conexão é feita no login da própria ferramenta.

  • Privada ou compartilhada: ao conectar, escolha se a conexão fica só para você ou para toda a empresa.

  • Google Workspace: não é uma integração separada. Conecte Google Sheets, Drive, Docs ou Agenda aqui. Se o Workspace da empresa bloqueia apps de terceiros, o administrador pode precisar liberar.

  • Instagram: na tela de autorização do Instagram aparece o nome Composio-IG. É o parceiro que a Solomon usa para ligar a Solomon IA ao Instagram.

  • Microsoft Clarity: conecta por token, não por login.

    1. No Clarity, abra Settings › Data Export › Generate new API token. Só quem é administrador do projeto consegue gerar o token.

    2. Na Solomon IA, em Integrações › Microsoft Clarity, cole o token em Clarity API Token.

    3. Para trocar o token, desconecte e conecte de novo. Se a conexão for compartilhada, só quem conectou consegue desconectar.

    O card pode continuar como "Ativo" mesmo com o token vencido. A API do Clarity devolve só os últimos 1 a 3 dias e não tem mapa de calor: o mapa de calor se vê no próprio Clarity.


Sistema próprio (n8n, Python, BI): use a API de leitura

O MCP foi feito para conversa. Numa automação com muitas chamadas seguidas, ele pode perder a sessão ou bater no limite. Para um sistema próprio, use a API de leitura:

  1. Clique no nome da loja no topo da tela e abra Chaves de API.

  2. Crie uma chave com a permissão data.read.

  3. Copie o token na hora: ele só aparece uma vez.

A documentação está em read-api.solomon.com.br/docs. Cada chave vale para uma loja só, então crie uma chave em cada loja que o sistema for usar. O limite é de 60 requisições por minuto, com até 366 dias por consulta.


Quando algo não funciona

O conector dá erro ou para de responder

Por exemplo: "Session terminated", "Server not initialized", erro 403, ou o conector aparece vinculado e não responde.

  1. No Claude, abra Configurações › Conectores, desconecte a Solomon e conecte de novo. Ele vai pedir o login da Solomon.

  2. Abra uma conversa nova e pergunte de novo.

  3. Se o erro continuar, fale com o suporte e mande o print do erro com o horário.

A Solomon IA ou um recurso novo não aparece no menu

A Solomon IA é liberada por loja. Quando um recurso é liberado para a sua conta, saia da Solomon e entre de novo para ele aparecer. Se ainda não aparecer, fale com o suporte.

"Sua verba de IA acabou"

A Solomon IA tem uma verba de uso que depende do plano. Quando ela acaba, o campo de mensagem mostra o aviso, com a data em que a verba renova, e o botão Ver planos, onde você pode contratar mais. O Conectar minha IA não usa essa verba.

A resposta parece errada

  • Confira se a pergunta usou o período e a loja certos. Peça à IA para dizer qual período usou e de onde tirou o número.

  • Se o número não bate com a tela da Solomon, mande ao suporte o print da pergunta e da resposta.

Respondeu à sua pergunta?