Pular para o conteúdo

Integração com o Claude (MCP)

Documentação do Knewin AI · atualizada em

Você pode usar o Knewin AI como ferramenta dentro do ClaudeWeb/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.