Model Context Protocol
Os seus dados de visibilidade, dentro do assistente que já usa
Um servidor MCP só de leitura que deixa o Claude, o ChatGPT ou qualquer cliente compatível consultar as suas marcas, a sua presença por motor, os seus concorrentes e as respostas guardadas. Sem exportar nada, sem copiar e colar, e sem que o modelo consiga escrever uma única linha.
- Seis ferramentas de leitura: marcas, presença, concorrentes, respostas, páginas citadas e menções excluídas
- A credencial é uma chave de API sua, revogável num clique e com rasto na auditoria
- Cada percentagem viaja com o seu denominador, para que o modelo não invente certezas
O problema
- Tem os dados no painel e a pergunta no chat, e entre os dois há um copiar e colar que envelhece assim que o cola.
- Quando dá a um modelo uma captura ou um CSV, ele perde o contexto: não sabe quantas respostas estão por trás daqueles 31 %, e trata aquilo como facto.
- E dar-lhe acesso à sua conta com uma credencial que também escreve é uma decisão que não se desfaz se correr mal.
Um número que o modelo não pode verificar é uma opinião com formato de cifra.
Como funciona
O protocolo é JSON-RPC sobre HTTP, versão 2025-06-18. Liga-se com duas linhas de configuração e funciona igual no Claude Desktop, no Claude Code e em qualquer cliente que fale MCP.
- 1
Cria uma chave só de leitura
Nas Definições, na secção de API. A chave nasce com permissão de leitura e não pode ter outra: quem o impede é uma restrição da base de dados, não uma verificação do código. Essa diferença importa, porque uma verificação esquece-se e uma restrição não.
- 2
Cola-a no seu cliente MCP
O URL é https://citenza.app/api/mcp e a credencial vai no cabeçalho Authorization. O cumprimento inicial não pede credencial, o protocolo exige assim, mas qualquer ferramenta sem chave válida devolve 401 e não revela sequer que marcas existem.
- 3
Pergunta pelas suas palavras
«Em que perguntas o ChatGPT me nomeia e o Gemini não?» O modelo chama as ferramentas de que precisa, recebe os dados com os seus denominadores e responde citando os números reais. Peça-lhe algo que exigisse escrever: não há ferramenta que o faça.
O que recebe
O que o modelo pode ler, e mais nada:
- As suas marcas e a presença por motor, sempre com a contagem de respostas atrás de cada percentagem.
- Os concorrentes detetados, as páginas que os motores citam e as menções excluídas com o motivo.
- As respostas originais guardadas, que são a prova de onde sai tudo o resto.
Meça antes de pagar seja o que for
O scanner lança 10 respostas reais em cerca de 60 segundos. Sem registo e sem cartão. Se o número não lhe disser nada, não compre.
Medir a minha marcaPara quem é
- Quem vive dentro do Claude ou do ChatGPT e quer perguntar pelos seus dados sem mudar de separador.
- Equipas que montam os seus próprios agentes e precisam de uma fonte de dados que não possa estragar nada.
- Agências que preparam relatórios e querem que o rascunho saia dos números reais, não da memória de alguém.
Não é para si se...
Não serve para automatizar alterações: aqui não se cria um prompt, não se lança um varrimento e não se toca numa marca. Se o que quer é escrever, o que precisa é da API da plataforma com a sua própria credencial.
Comparação honesta
| À mão | Com Citenza | |
|---|---|---|
| O que custa | Exportar um CSV e colá-lo no chat de cada vez. | O modelo consulta o número do momento, sem intermediários. |
| O método | O modelo vê uma percentagem solta e afirma-a como se fosse um censo. | Cada rácio chega com o seu denominador e uma nota que diz ao modelo o que pode afirmar. |
| Repetir no mês seguinte | Revogar o acesso obriga a lembrar-se do que colou e onde. | Revogar é apagar uma chave, e fica registado quem e quando. |
Disponibilidade por plano
Incluído em todos os escalões pagos, sem custo adicional e sem limite de clientes ligados. As consultas do MCP não gastam quota de respostas: a quota mede o que se pergunta aos motores, e isto só lê o que já foi medido.
Perguntas honestas
- O modelo pode mudar alguma coisa na minha conta?
- Não, e isso não depende de o servidor estar bem escrito. A credencial é uma chave de API cujo âmbito só pode ser de leitura, e quem o impõe é uma restrição da base de dados sobre a coluna de permissões. Mesmo que alguém adicionasse amanhã uma ferramenta de escrita por engano, a chave não serviria para a usar.
- O que acontece se revogar a chave enquanto o modelo a está a usar?
- A chamada seguinte devolve 401 e o cliente MCP di-lo. Nenhuma sessão sobrevive à revogação e não há cache de permissões: cada chamada verifica a chave na base de dados, por isso o corte é imediato e não há uma janela de minutos em que continue a funcionar.
- O modelo vê dados de outras organizações?
- Não. A chave pertence a uma organização e todas as consultas passam pelo mesmo isolamento por linha que o painel usa, aplicado no PostgreSQL e não no código. Uma falha do servidor não o consegue contornar, porque não é o servidor que o aplica.
- Porque é que cada número vem com o seu denominador?
- Porque um modelo que lê «31 %» sem saber que saem de 13 respostas vai repeti-lo como facto, e com 13 respostas o intervalo de confiança é enorme. Cada ferramenta devolve a contagem ao lado da percentagem e uma nota que diz explicitamente o que se pode afirmar com essa amostra. É a mesma regra que o painel segue.
Ligue o seu assistente em dois minutos
Crie uma chave de leitura nas Definições, cole-a no seu cliente MCP e pergunte. Se algo não encaixar, revogar é um clique.