Insights
Um canal único para as fontes de informação que alimentam o trabalho, normalizadas para agents consumirem.
Fontes entram, viram itens com texto íntegro, resumo, entidades e vetor, e ficam disponíveis por MCP para Claude, Codex e qualquer outro agent — e por uma tela, para gente.
Conectar um agent
endereço do MCP
https://insights.evolc.co/api/mcpClaude Code
claude mcp add --transport http insights https://insights.evolc.co/api/mcpNo Claude Desktop, adicione o mesmo endereço como conector. Nos dois casos o agent abre esta aplicação no navegador: você entra, escolhe quais projects aquela credencial alcança, e pronto.
Não há chave de API para copiar nem segredo para colar em arquivo de configuração. Quem já está conectado aparece em Configurações › Conexões, com o alcance que autorizou e o rastro do que pediu.
O cliente se identifica por CIMD quando sabe, e por registro dinâmico (RFC 7591) quando não sabe — os dois caminhos estão abertos.
Clientes
Confirmados contra esta instalação, cada um conectado de ponta a ponta e listando as sete tools:
| Claude Code e Claude Desktop | registro dinâmico |
| ChatGPT | CIMD |
| Cursor | registro dinâmico |
| Grok | client_id pré-registrado |
| MCP Inspector | registro dinâmico |
Se o registro for recusado com esta mensagem, a causa tem nome:
recusa no registro dinâmico
web clients require https redirect URIs on non-loopback hostsUm cliente que roda como processo local — e portanto escuta em localhost ou 127.0.0.1 — precisa se registrar como application_type: native. É o que a RFC 8252 define para aplicação nativa, e é o único caso em que um endereço de retorno sem HTTPS faz sentido.
Um cliente que se declara web é um servidor, e servidor não escuta no computador de quem usa. Por isso, nesse caso, o endereço de retorno precisa ser HTTPS — sem exceção para loopback.
Quando o cliente se declara errado e você não controla isso, a saída é um client_id pré-registrado com o tipo e o endereço de retorno corretos. Ele é público, não tem segredo, e usa PKCE como qualquer outro. Peça o seu.
Escopo
Uma credencial pertence ao par (pessoa, cliente), não ao cliente sozinho. O Claude Code de duas pessoas são duas conexões, com alcances diferentes, porque o consentimento é de quem autorizou.
O que a credencial alcança é o conjunto de projects que essa pessoa marcou na tela de consentimento — e só aparecem lá projects dos quais ela é membro. Não é uma validação espalhada pelos endpoints: é a estrutura. O token de um cliente não consegue conter um project de outro porque esse project nunca esteve na lista que ele podia marcar.
O parâmetro project_id
- —Credencial com um project consentido:
project_idé opcional, fica implícito. - —Credencial com vários:
project_idé obrigatório em toda chamada.
Não há estado de sessão. Não existe “project atual” que uma chamada anterior tenha deixado ligado — em MCP, estado invisível é como se erra de project. Chame get_project_context para descobrir quais existem.
Revogar
Em Configurações › Conexões, revogar tira a credencial daquele project; os outros dela continuam. O token segue válido — o que muda é o conjunto que ele alcança, e sem nenhum project a próxima chamada leva 403.
As sete tools
Três de leitura, quatro de escrita — e a lista de escrita é fechada. Não existe create_item genérico, campo livre nem metadata JSON arbitrário. Um MCP que aceita escrita genérica vira o lugar onde o agent externo orquestra trabalho através da plataforma, e a complexidade passa a morar fora, onde ninguém a vê crescer.
Leitura
Uma tool de busca, não quatro: a diferença entre filtro e semântica é um parâmetro, não um verbo.
- query
- Assunto em linguagem natural. Com ele, ranqueia por similaridade; sem ele, ordena por data.
- category
- Nome exato de uma categoria do project.
- source_ids
- Restringe a estas fontes.
- entities
- Itens que mencionam qualquer uma destas entidades.
- from · to
- Janela de publicação, em ISO.
- limit
- 1 a 100. Padrão 20.
- collapse
- Padrão true: uma linha por história. false devolve todas as coberturas.
- exclude_irrelevant
- Padrão true.
Filtros são estritos e combináveis: cada um corta, nenhum “pesa”. Resultado que não passa no filtro não aparece mais abaixo — não aparece.
Devolve o resumo de cada item, com fonte, data, categoria, entidades e clusterSize — quantas fontes assinadas cobriram a mesma história, que é o melhor sinal de relevância que existe aqui.
Segundo passo do padrão: search_items acha pelo resumo, isto aprofunda no escolhido.
- item_id
- O id vindo de search_items.
Trazer texto íntegro já na busca queimaria o contexto do agent com itens que ele vai descartar.
Chame antes de montar filtros: nome de categoria precisa ser exato, e chutar devolve vazio sem dizer por quê.
Escrita
Devolve tier de conteúdo, itens por dia e custo mensal estimado ANTES de a assinatura valer.
- url
- URL do feed RSS ou Atom.
- propose_categories
- Propõe categorias novas a partir do feed.
Marca a correção como manual: nenhum job de reclassificação a atropela depois.
- item_id
- —
- category_id
- null remove a categoria.
Item irrelevante some das buscas do project por padrão. É filtro, não peso de ranking.
- item_id
- —
- feedback
- "util", "irrelevante" ou null.
Fecha o ciclo, e é metade do cálculo de ROI: custo do project ÷ itens que viraram material.
- item_id
- —
- note
- O que foi produzido a partir dele.
Erros
| 401 | Token ausente, inválido, expirado, ou de outro emissor. |
| 402 | Sem saldo: o acervo está congelado até haver crédito. |
| 403 | Token válido, mas nenhum project consentido. Reautorize a conexão. |
| erro de tool | project_id fora do escopo, ou ausente com mais de um project consentido. |
| item não encontrado | O item não existe, ou existe e não pertence a este project. |
A última linha é deliberada: um item de outro project responde igual a um item inexistente. Distinguir os dois confirmaria a existência de conteúdo fora do escopo da credencial.
O que fica registrado
Toda chamada é registrada — tool, argumentos, quantidade de resultados, duração e erro — e aparece para os membros do project em Configurações › Conexões. Os argumentos entram inteiros, porque é neles que está a pergunta que o agent fez.
Uma credencial que alcança o acervo sem deixar rastro é uma credencial em que não dá para confiar. E o registro nunca derruba a resposta: se o banco falhar na hora de gravar o log, o que se perde é o log, não a chamada.
Estado operacional público, sem nada de acervo: /api/health