Integração com o Claude (MCP)

Você pode conectar o Knewin AI ao Claude via MCP (Model Context Protocol), usando o Knewin AI como uma ferramenta dentro do Claude — tanto no Claude (Web/Desktop) quanto no Claude Code (CLI).

Para instalar, veja Integração com o Claude: configurar. Para o comportamento no dia a dia (conversas separadas, análises longas, cota), veja Integração com o Claude: no dia a dia.

Como funciona

O conector trabalha em três velocidades, e é isso que o torna barato de usar:

Leitura (instantânea, não consome cota) — sobre o que já foi medido:

• knewin_state — as conversas que existem, ou, informando uma delas, o que ela já tem medido: marcas, períodos, volumes e a régua de busca vigente. É por onde o Claude começa.
• knewin_list_articles — as matérias já coletadas (título, veículo, data, canal, tom), paginadas.
• knewin_aggregate — os números: volume total, por canal, por dia, por veículo, por tom.
• knewin_help — a documentação do próprio Knewin AI: como usar o app, e também o que os dados significam aqui (o que é um canal, o que a sua base do Monitoring cobre, o que uma métrica mede).

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, como o menu do cartão na biblioteca.
• knewin_assistant_upsert — criar ou editar um assistente da conta.
• knewin_artifact_publish — gera o link público de um dashboard, o mesmo do botão Copiar link público. Pede a sua confirmação antes, porque quem tem o link entra sem login.
• knewin_artifact_unpublish — encerra o link. Não pede confirmação: parar de compartilhar reduz exposição.
• knewin_artifact_versions — lista o histórico de versões de um entregável e restaura uma delas.

Nenhuma delas apaga um entregável: excluir continua sendo pelo aplicativo.

Estas são escritas diretas — instantâneas e sem cota, porque não há nada a gerar. Mudar o conteúdo (editar o painel, refazer o relatório) é outra coisa: isso é análise, e vai por knewin_ask.

Análise (leva de 1 a 3 minutos, consome cota) — quando falta medir:

• knewin_ask — você envia uma pergunta em linguagem natural e o agente completo responde (busca ao vivo, análise, dashboards e relatórios).
• knewin_get_run — acompanha uma análise em andamento (as etapas já cumpridas, com o que aconteceu em cada uma) ou busca o resultado de uma já terminada.
• knewin_cancel_run — interrompe uma análise, que deixa de consumir sua cota.

O nome antigo, knewinReputationAgent, continua funcionando: quem já configurou o conector não precisa mexer em nada.

Os menus do app, como listas que o Claude abre

No aplicativo você escolhe de um menu; no Claude, essas mesmas listas chegam como recursos — e digitar @ no Claude mostra todas elas:

• knewin://brands — as marcas da sua conta. Vale sempre: uma grafia diferente da configurada devolve vazio, que parece "não houve cobertura".
• knewin://assistants — os assistentes aplicáveis, com id, nome e quando usar cada um.
• knewin://artifacts — os entregáveis da conta, com o endereço de cada um.
• knewin://artifact/{id} — abre um deles. Dashboard vem como dados, não como página: os números que o painel mostra, para o Claude poder conferir e comentar.