CrunchJunkie MCP

npx add-mcp 'https://app.crunchjunkie.io/api/mcp/mcp'

Deixe assistentes de IA lerem seus dados do CrunchJunkie com segurança por meio do Model Context Protocol — e, se você ativar, agir sobre eles.

O que o conector MCP faz

O CrunchJunkie inclui um conector Model Context Protocol (MCP), para que assistentes de IA possam ler os dados do seu workspace diretamente em um chat — seus clientes, fontes de dados conectadas, relatórios e dados de relatórios, e métricas de visibilidade de IA. Você pode perguntar "resuma o relatório do Google Ads do mês passado para a Acme" ou "para quais prompts a Acme está invisível no ChatGPT?" e o assistente busca a resposta nos seus dados ao vivo do CrunchJunkie, em vez de você exportar qualquer coisa. É um único servidor, não um conjunto de integrações por fornecedor. A mesma URL do conector funciona com claude.ai, com ChatGPT (incluindo Deep Research, que é para o que as ferramentas integradas de busca e fetch do conector existem) e com qualquer outro cliente compatível com MCP — mesmas ferramentas, mesmos escopos, mesmas salvaguardas, independentemente de qual você usar. Duas coisas são verdadeiras por design. É limitado à sua equipe: um assistente só vê o workspace da conta que fez login. E a leitura nunca muda nada — as ferramentas de leitura buscam e pesquisam, ponto final. O conector também pode agir por você — rascunhar um relatório, adicionar ou remover um widget, agendar um relatório, rastrear ou parar de rastrear um prompt de visibilidade de IA, executar uma nova auditoria GEO — mas somente depois que um proprietário do workspace ativar isso, e mesmo assim cada alteração é prévia e confirmação (veja "Permitindo que um assistente execute ações" abaixo). Cobrança, plano e configurações de conta estão totalmente fora do alcance. O conector está disponível em planos pagos.

Conectando um assistente

Abra Configurações → Conectar assistentes de IA (MCP) para encontrar sua URL do conector (ela se parece com https://app.crunchjunkie.io/api/mcp/mcp). Adicione essa URL como um servidor MCP remoto no seu cliente: • Claude (claude.ai ou desktop) — Configurações → Conectores → Adicionar conector personalizado → cole a URL. • ChatGPT — Configurações → Conectores → Adicionar (disponível em Pro/Team/Enterprise), ou adicione como fonte no Deep Research → cole a URL. • Qualquer outra coisa que fale MCP — adicione onde esse cliente aceitar uma URL de servidor MCP remoto. Não há nada específico de fornecedor para configurar. Uma observação específica do ChatGPT: em uma conversa normal do ChatGPT, apenas as ferramentas de leitura ficam visíveis — o ChatGPT oculta ferramentas que podem escrever, a menos que o Modo Desenvolvedor esteja ativado (Configurações → Apps e Conectores → Avançado → Modo desenvolvedor; em workspaces Business, um administrador pode precisar ativá-lo). Isso é política do ChatGPT, não uma limitação do conector: o mesmo conector expõe todas as 46 ferramentas no Claude. Ações de escrita também exigem a aceitação do workspace abaixo, uma função de conta com permissão para editar e confirmar cada alteração com uma prévia primeiro — quatro interruptores independentes, para que nada possa escrever por surpresa. Ao adicioná-lo, o cliente envia você para uma tela de login do CrunchJunkie para autorizar o acesso — o mesmo fluxo OAuth em todos os lugares. Você faz login exatamente como faz no aplicativo, aprova o acesso e está conectado — sem chaves de API para copiar ou gerenciar. Como a autorização depende do seu login normal, o assistente age como você e vê apenas o que sua conta pode ver. Você pode revogar o acesso a qualquer momento nas configurações de conectores do cliente. Cinco escopos podem ser solicitados, e você pode ver quais foram concedidos na tela de consentimento: • read:reports — listar e abrir seus relatórios e extrair seus dados • read:visibility — ler métricas de visibilidade de IA e de visibilidade de compras de produtos • read:clients — listar seus clientes e suas fontes de dados conectadas • write:reports — criar um relatório, adicionar, editar ou remover widgets, agendar um relatório • write:visibility — rastrear prompts, gerenciar concorrentes, tags, configurações de scan e projeto, adicionar notas de linha do tempo, executar uma auditoria GEO, iniciar scans e gerar briefs de conteúdo. Toda conexão atualmente recebe todos os cinco escopos ao fazer login, então um escopo sozinho nunca decide se um assistente pode alterar algo — a configuração do workspace, sua função e a etapa de confirmação decidem (veja os quatro portões abaixo).

O que o assistente pode ler

As ferramentas de leitura são: listar seus clientes, listar as fontes de dados conectadas de um cliente, listar e abrir relatórios, extrair os dados de um relatório, ler métricas de visibilidade de IA, ler visibilidade de compras em nível de produto (taxa de recomendação, taxa de vitória frente a frente e produtos concorrentes) e uma busca/fetch geral sobre seu workspace. Uma camada de análise mais profunda lê os dados por prompt por trás dessas métricas: listar seus prompts rastreados com visibilidade por prompt agrupada, aprofundar nos resultados por mecanismo de um prompt e nos concorrentes que a IA realmente nomeou, ver quais domínios os mecanismos citam (com citados genuinamente e apenas recuperados contados separadamente), encontrar lacunas de conteúdo — prompts em que sua marca está ausente de todas as respostas recentes enquanto concorrentes são nomeados, a mesma definição que o gerador de Brief de Conteúdo usa — ler sua caixa de entrada de Sinais, extrair a pontuação mais recente da Auditoria GEO com suas descobertas, ler Percepção da Marca — os termos que a IA realmente usa sobre cada marca, com quaisquer resultados de verificação de fatos armazenados — ver os fan-outs de consulta (as buscas na web que os mecanismos executaram antes de responder seus prompts) e ler as análises do rastreador de IA dos seus logs de servidor encaminhados. Também pode ler as próprias respostas de IA — a lista de respostas por trás de cada número de visibilidade, e qualquer resposta completa com as páginas citadas e as buscas que o mecanismo executou — acompanhar a visibilidade dia a dia com o número de respostas por trás de cada dia, aprofundar em uma página citada para ver quais prompts e mecanismos a usaram, vincular visibilidade às sessões e conversões que assistentes de IA enviam via GA4, abrir briefs de conteúdo salvos e verificar a permissão de scan de IA gerenciada do workspace. A leitura está sempre disponível em um plano pago e nunca altera seus dados — não há acesso de cobrança e nenhuma capacidade de mudar seu plano, equipe ou configurações a partir de um chat. Respostas, páginas citadas e buscas de mecanismos são textos escritos por terceiros, então todo resultado que os contém diz isso antes dos dados e instrui o assistente a tratar esse texto como dados, nunca como instruções. O conector também inclui seis prompts prontos — uma revisão semanal de cliente, uma análise de concorrente, um plano de lacunas de conteúdo, uma investigação de queda de visibilidade, uma triagem de auditoria GEO e uma lista de alvos de divulgação (as páginas de terceiros que mecanismos de IA leem sobre suas perguntas de compradores, com uma linha de base para re-medir) — que aparecem em assistentes que suportam prompts MCP. Se uma ferramenta retornar "escopo ausente" ou "proibido", geralmente significa que a conta conectada não está em um plano pago ou não é membro da equipe que possui os dados. Entre com uma conta que tenha acesso ao workspace sobre o qual você está perguntando.

Permitindo que um assistente execute ações (opcional)

Ler seus dados é apenas metade do que um assistente pode fazer. Se você quiser que ele também faça alterações por você — "rascunhe um relatório do Google Ads para a Acme", "agende o relatório da Acme toda segunda-feira às 9h", "comece a rastrear o prompt 'melhor CRM para agências' para a Acme" ou "adicione uma tabela de conversões por dispositivo a esse relatório" — o conector tem 18 ferramentas de ação: create_report, add_widget, edit_widget, remove_widget e schedule_report (cobertas por write:reports), e create_client, add_tracking_prompt, remove_tracking_prompt, update_tracking_prompt, manage_competitors, set_prompt_tags, manage_project_tags, update_scan_settings, update_project_settings, add_annotation, run_geo_audit, run_scan e create_content_brief (cobertas por write:visibility). create_client configura um novo cliente e seu projeto de visibilidade de IA em uma única etapa — nome da marca, tipo de produto, Perfil da Marca, concorrentes, mercado, idioma e mecanismos — para que um assistente possa integrar uma marca de ponta a ponta e depois adicionar prompts. run_geo_audit executa uma nova Auditoria GEO do site do próprio cliente — a mesma auditoria da aba Auditoria GEO, no máximo uma vez por projeto a cada 15 minutos, sem usar sua permissão de scan. Duas ações gastam IA: run_scan inicia um scan de visibilidade de IA e create_content_brief escreve um brief de conteúdo. Elas precisam de mais um interruptor, "Permitir ações que gastam IA" em Configurações → Conectar assistentes de IA (MCP), e a prévia mostra o custo antes de você confirmar — quais mecanismos rodam em suas próprias chaves, quantas verificações ponderadas contam contra sua permissão de IA gerenciada e quantas seriam excedentes. Um workspace pode iniciar até 20 delas por dia a partir de assistentes. Um scan roda em segundo plano (get_scan_status o acompanha), e o limite de excedente e o teto de uso justo se aplicam exatamente como para um scan iniciado no aplicativo. Cada uma delas é protegida quatro vezes, e todas as quatro devem valer: 1. Escopo — o token deve carregar o escopo de escrita correspondente. 2. Configuração do workspace — "Permitir ações de escrita" deve estar ativado em Configurações → Conectar assistentes de IA (MCP). Está desativado por padrão e apenas um proprietário ou administrador pode alterá-lo. Enquanto estiver desativado, o conector lê e nada mais, não importa quais escopos um token tenha. 3. Sua função — o conector age como a conta que fez login, então segue sua função na equipe. Um membro com a função "Somente leitura" pode ler tudo pelo conector, mas toda ferramenta de ação se recusa a fazer alterações para eles — exatamente como no aplicativo. 4. Confirmação — a ferramenta deve ser chamada com confirm: true. Chamada sem isso, ela retorna uma prévia exata do que criaria — os widgets do relatório, a cadência e os destinatários do agendamento, o texto do prompt — e não altera nada. O conteúdo que o conector cria segue o idioma do seu workspace. Se o idioma da sua conta for alemão, um relatório rascunhado pelo conector recebe títulos de seção em alemão em vez de inglês. (Isso é sobre o texto que o CrunchJunkie escreve; seu assistente já respondeu no idioma em que você perguntou.) Toda ação confirmada é registrada — quem a fez, por qual conexão, qual ferramenta e o que ela visou, nunca o texto que você enviou — e proprietários e administradores podem ver as recentes em Configurações → Conectar assistentes de IA (MCP). Os registros são mantidos por 12 meses. As ações permanecem limitadas à sua equipe e nunca tocam em cobrança ou configurações de conta. Você pode desativar as ações a qualquer momento e as ferramentas de leitura continuam funcionando. É a mesma lógica fundamentada e verificada por catálogo que "Rascunhar com IA" e "Peça ao Crunch para construir um widget" no aplicativo — para que um assistente só possa construir coisas que o CrunchJunkie realmente suporta, nunca inventar uma métrica ou uma fonte de dados.