Integração com o Claude (MCP)
Documentação do Knewin AI · atualizada em
Você pode usar o Knewin AI como ferramenta dentro do Claude — Web/Desktop e Claude Code (CLI) — via MCP (Model Context Protocol).
Para instalar, veja Integração com o Claude: configurar. Para o dia a dia (conversas separadas, análises longas, cota), veja Integração com o Claude: no dia a dia.
Como funciona
São quinze ferramentas, em três velocidades — e é isso que o torna barato:
Leitura (instantânea, não consome cota) — sobre o que já foi medido:
knewin_state— as conversas que existem (as da integração e as do aplicativo, em listas separadas) ou o que uma delas já mediu: marcas, períodos, volumes, sondagens de IA e a régua vigente. É por onde o Claude começa.knewin_list_articles— as matérias já coletadas (título, veículo, data, canal, tom).knewin_aggregate— os números: volume total, por canal, por dia, por veículo, por tom.knewin_list_ai_responses— o que cada IA respondeu numa sondagem já feita: modelo, pergunta, se citou a marca, tom e sites. Reler não paga a medição de novo.knewin_help— a documentação do próprio Knewin AI: como usar o app e o que os dados significam aqui. Funciona numa janela recém-aberta, sem análise antes.
Organizar e publicar (instantâneo, não consome cota) — mexer no que já existe:
knewin_artifact_update— renomear, etiquetar, favoritar ou arquivar um entregável.knewin_assistant_upsert— criar ou editar um assistente da conta.knewin_artifact_publish— gera o link público de um dashboard. Pede confirmação: quem tem o link entra sem login.knewin_artifact_unpublish— encerra o link. Não pede: parar de compartilhar reduz exposição.knewin_artifact_versions— lista o histórico de versões de um entregável e restaura uma delas.knewin_artifact_render— devolve o painel desenhado, para os clientes que saibam exibi-lo. Para conferir um número, abra o entregável como dado.
Nenhuma apaga um entregável — no aplicativo também não se apaga, existe arquivar. Um entregável só some se você apagar a conversa que o gerou. Mudar o conteúdo é análise, e vai por knewin_ask.
Análise (leva de 1 a 3 minutos, consome cota) — quando falta medir:
knewin_ask— uma pergunta em linguagem natural, respondida pelo agente completo (busca ao vivo, análise, entregáveis).knewin_get_run— acompanha uma análise em andamento (as etapas já cumpridas) ou busca o resultado de uma terminada.knewin_cancel_run— interrompe uma análise, que deixa de consumir sua cota.
O nome antigo, knewinReputationAgent, continua funcionando.
Os menus do app, como listas que o Claude abre
No aplicativo você escolhe de um menu; no Claude, as mesmas listas chegam como recursos, e digitar @ mostra todas:
knewin://brands— as marcas da conta. Grafia diferente da configurada devolve vazio, que parece "sem cobertura".knewin://assistants— os assistentes aplicáveis, com quando usar cada um.knewin://artifacts— os entregáveis da conta, com o endereço de cada um.knewin://artifact/{id}— abre um deles como conteúdo: o painel vem como os números que mostra, o relatório com os elementos dele e a planilha com as linhas (as duas últimas com o corte declarado). Apresentação entra como relatório.
E o painel, aparece dentro da conversa?
Ainda não. O painel chega como texto mais o endereço para abrir no aplicativo, e os dados vêm pelo recurso acima. Desenhá-lo dentro da conversa está em desenvolvimento, assim como o acompanhamento por tarefas — por ora, use knewin_get_run.
Abrir um painel pelo Claude não o publica: o link público continua sendo um ato seu.
Não é só o Claude
Qualquer aplicativo de IA que fale MCP se conecta — nos que fazem OAuth, sem copiar token. Veja Integração com o Claude: configurar.
Os três caminhos de conexão, lado a lado, e o que muda em cada um estão em Knewin AI no Claude.