Rumoro
oficialDescubra o que as pessoas dizem sobre seu produto no Reddit, X, Hacker News, GitHub e outros lugares, e deixe seu agente de IA pesquisar e agir sobre essas menções.
O que você pode fazer com Rumoro MCP?
- Pesquisar e triar menções — Peça ao seu assistente para encontrar e resumir menções em várias plataformas, filtrar por sentimento e identificar reclamações comuns.
- Gerenciar palavras-chave e perfil da empresa — Instrua seu assistente a atualizar palavras-chave rastreadas, ajustar seu perfil da empresa e aplicar sugestões do relatório de saúde para reduzir ruído.
- Ler análises e monitorar concorrentes — Faça seu assistente puxar métricas de engajamento, comparar o sentimento dos concorrentes e identificar os principais influenciadores que mencionam sua marca.
- Configurar alertas e segmentos — Peça ao seu assistente para criar resumos agendados de menções negativas ou construir segmentos de público com base em contagens de seguidores e engajamento.
- Triar e organizar menções — Direcione seu assistente para marcar menções internas da equipe como concluídas, atribuir menções a membros da equipe e adicionar notas para acompanhamento.
Servidor MCP hospedado
npx add-mcp 'https://mcp.rumoro.dev/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP
Conecte o Claude Code e outros clientes MCP às suas menções. Entre com OAuth ou use uma chave de API.
O servidor Model Context Protocol da Rumoro é hospedado, então não há nada para instalar. Uma vez que seu cliente MCP esteja conectado, seu agente pode pesquisar e triar menções, gerenciar palavras-chave e o perfil da sua empresa, ler análises e configurar alertas, pessoas e segmentos. Ele segue as mesmas regras do painel.
https://mcp.rumoro.dev/mcp
- Hospedado, HTTP com streaming, sem sessão. Não há nada para instalar. Os clientes devem aceitar respostas
application/jsonetext/event-stream. - OAuth ou chave de API. Clientes que suportam autorização MCP fazem você entrar pelo navegador. Outros enviam uma chave como cabeçalho Bearer. Com acesso
read, o cliente vê apenas as ferramentas de leitura; comwrite, vê todas. - 55 ferramentas que correspondem à API REST. Elas estão listadas em Ferramentas.
Início rápido
### Adicionar o servidorNo Claude Code, execute
```bash
claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp
```
Em seguida, digite `/mcp`, escolha `rumoro` e **Autenticar**. Entre e aprove o acesso que o cliente solicitar. Se você pertencer a vários espaços de trabalho, também escolha um. Outros clientes estão em [Instalação](#installation).
Para CI, um servidor ou um cliente sem OAuth, crie uma chave na página **Chaves de API**, `read` para explorar ou `write` para fazer alterações. Você só a vê uma vez.
### Perguntar
Tente "Quais menções desta semana foram negativas e com o que as pessoas não ficaram satisfeitas?"
Autenticação
Cada chamada de ferramenta carrega uma credencial Bearer. O servidor lida com os dois tipos da mesma forma.
Authorization: Bearer <OAuth access token>
Authorization: Bearer ref_...
OAuth 2.1
O login segue a especificação de autorização MCP. Uma chamada sem credencial recebe 401 com WWW-Authenticate: Bearer realm="rumoro-mcp", resource_metadata="https://mcp.rumoro.dev/.well-known/oauth-protected-resource". O cliente então se registra (registro dinâmico com PKCE) e abre o navegador. Você aprova cada login em uma página de consentimento, e o token age como você, dentro do seu papel naquele espaço de trabalho. Os tokens de acesso duram uma hora. Com offline_access, o cliente também recebe um token de atualização que dura 30 dias e é substituído a cada uso. Um login sem write funciona como read.
Chaves de API
Crie chaves na página Chaves de API ou com POST /v1/api-keys. Você vê cada chave uma vez, e ela pertence a um espaço de trabalho. Quando você revoga uma chave, o cliente para de funcionar na próxima chamada.
Descoberta
Conectar não exige credencial. initialize, tools/list e os recursos respondem sem uma. Uma credencial enviada é sempre verificada, e toda tools/call precisa de uma.
Recursos
| Recurso | URI | O que contém |
|---|---|---|
openapi | https://api.rumoro.dev/v1/openapi.json | A API REST por trás das ferramentas, com todos os esquemas |
agent-guide | https://mcp.rumoro.dev/mcp/guide | Como um agente se conecta, o que cada permissão permite e um fluxo de revisão |
Cada ferramenta tem readOnlyHint, destructiveHint e idempotentHint, para que um cliente saiba quais chamadas confirmar primeiro. As sete ferramentas destrutivas estão marcadas em Ferramentas.
Registros podem ler o cartão do servidor.
Como as ferramentas se comportam
- Cada ferramenta executa a mesma operação da API REST, com a mesma validação, erros e limite de taxa.
search_mentionsretorna 10 menções por padrão ehasMore, sem cursor. Quando houver mais, restrinja os filtros ou o intervalo de tempo.- Não há ferramentas de exportação. Use as exportações da REST ou a CLI para listas grandes.
- Ferramentas de escrita precisam de uma chave
writeou login. Comread, elas não aparecem. - O servidor não mantém sessão entre requisições. As respostas vêm como JSON ou como um pequeno fluxo de eventos.
Dados de autores
list_people, get_person e as outras ferramentas de pessoas retornam os fatos públicos que a Rumoro guarda sobre autores, como nome, identificador, foto, contagem de seguidores e detalhes do perfil. Elas nunca retornam um endereço de e-mail, então profile.email é sempre null via MCP, mesmo onde a API REST mostra um. Como funciona explica o que é armazenado e como as pessoas podem pedir para serem removidas.
O que você pode perguntar
- "Resuma o que as pessoas disseram sobre nós no Hacker News e no Reddit nos últimos 7 dias."
- "Encontre perguntas sobre nossos preços que ninguém respondeu e rascunhe uma resposta para cada uma."
- "Qual concorrente recebeu mais menções positivas este mês e por quê?"
- "Marque todas as menções da nossa própria equipe como concluídas."
- "Nossa palavra-chave
driftwoodestá ruidosa. Veja o relatório de saúde dela e aplique a melhor sugestão." - "Crie um resumo diário de menções negativas para o canal de suporte às 9:00, horário de Berlim."
- "Quem são as pessoas com mais de 10.000 seguidores que nos mencionaram este mês?"
Servidor MCP de documentação
A documentação tem seu próprio servidor MCP somente leitura, e ele não precisa de chave.
https://docs.rumoro.dev/api/mcp
- Ferramentas.
search_docspesquisa o texto completo,read_pageretorna uma página como Markdown pelo caminho, como/quickstart, elist_pageslista todas as páginas com título e descrição. - Recursos. Cada página no endereço
.mdx, além dehttps://docs.rumoro.dev/llms.txt. - Cartão.
/.well-known/mcp.json.
Segurança
- Dê apenas o acesso necessário. Use
readpara explorar ewriteapenas para um agente que deve alterar coisas. Nenhuma ferramenta pode alterar cobrança ou chaves de API, emboraget_usageelist_ledgerleiam o saldo. - Mesmas regras da API. As chamadas agem como o espaço de trabalho da chave ou a pessoa que entrou, com as mesmas verificações e limite de taxa.
- Mantenha chaves fora de repositórios. OAuth não deixa segredos nas configurações do cliente. Com uma chave, use configurações de nível de usuário ou uma variável de ambiente, e revogue-a se vazar.
Instalação
Com OAuth, um cliente só precisa da URL. Com uma chave, adicione o cabeçalho Authorization: Bearer ref_.... Na CLI, rumoro mcp:config imprime essas configurações com sua chave preenchida.
Em seguida, execute `/mcp`, escolha `rumoro` e **Autenticar**. Adicione `--scope project` para salvar a URL no `.mcp.json` do repositório, ou `--scope user` para usá-la em todos os projetos. A [página do Claude Code](https://rumoro.dev/claude) explica o processo com perguntas de exemplo. Com uma chave, execute
```bash
claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp \
--header "Authorization: Bearer ref_..."
```
Adicione o servidor ao `~/.cursor/mcp.json` para todos os projetos, ou ao `.cursor/mcp.json` para um. A [página do Cursor](https://rumoro.dev/cursor) explica o processo com perguntas de exemplo.
```json title=".cursor/mcp.json"
{
"mcpServers": {
"rumoro": {
"url": "https://mcp.rumoro.dev/mcp",
"headers": { "Authorization": "Bearer ref_..." }
}
}
}
```
Deixe `headers` de fora para entrar com OAuth. Algumas versões do Cursor criam o link de login sem abri-lo, então toda ferramenta responde `Unauthorized`; a chave sempre funciona.
Execute **MCP: Adicionar Servidor**, escolha **HTTP**, insira `https://mcp.rumoro.dev/mcp` e nomeie como `rumoro`. Com uma chave, use
```json title=".vscode/mcp.json"
{
"servers": {
"rumoro": {
"type": "http",
"url": "https://mcp.rumoro.dev/mcp",
"headers": { "Authorization": "Bearer ref_..." }
}
}
}
```
```bash
codex mcp add rumoro --url https://mcp.rumoro.dev/mcp
codex mcp login rumoro
```
A [página do Codex](https://rumoro.dev/codex) explica o processo com perguntas de exemplo. Com uma chave, leia-a de uma variável de ambiente.
```bash
export RUMORO_API_KEY="ref_..."
codex mcp add rumoro --url https://mcp.rumoro.dev/mcp --bearer-token-env-var RUMORO_API_KEY
```
Abra [grok.com/connectors](https://grok.com/connectors), escolha **Novo Conector**, depois **Personalizado**, e insira `https://mcp.rumoro.dev/mcp`. O Grok executa o login OAuth. Nos planos Business e Enterprise, um administrador provisiona o conector primeiro. A [página do Grok](https://rumoro.dev/grok) explica o processo com perguntas de exemplo.
Adicione o servidor em `mcp_servers`, depois execute `hermes mcp login rumoro`. O Hermes se registra com a Rumoro, então não há ID de cliente para criar.
```yaml title="~/.hermes/config.yaml"
mcp_servers:
rumoro:
url: "https://mcp.rumoro.dev/mcp"
auth: oauth
```
Verifique com `hermes mcp test rumoro`, ou execute `/reload-mcp` em uma sessão. A [página do Hermes](https://rumoro.dev/hermes) explica o processo com perguntas de exemplo. Com uma chave, substitua `auth: oauth` por `headers: { Authorization: "Bearer ${RUMORO_API_KEY}" }` e coloque `RUMORO_API_KEY` em `~/.hermes/.env`.
```bash
openclaw mcp add rumoro --url https://mcp.rumoro.dev/mcp --transport streamable-http --auth oauth
openclaw mcp login rumoro
openclaw mcp doctor rumoro --probe
```
A [página do OpenClaw](https://rumoro.dev/openclaw) explica o processo com perguntas de exemplo. Para usar uma chave de API, instale a [habilidade Rumoro](/integrations/openclaw).
Use as configurações do Cursor com o arquivo e a chave de URL do próprio cliente.
| Cliente | Arquivo | Chave de URL |
| --- | --- | --- |
| Gemini CLI | `~/.gemini/settings.json` | `httpUrl` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `serverUrl` |
| Qualquer outro | Configurações MCP do cliente | `url`, além de `"type": "http"` |
Ajude seu agente a se orientar
Diga ao agente o que você acompanha em AGENTS.md, CLAUDE.md ou no arquivo de regras do cliente.
## Rumoro
- Workspace: Driftwood (connected through the `rumoro` MCP server)
- Brand keyword `driftwood`, competitors `flagpole` and `switchboard`, topic `feature flags`
- "Relevant" means the classifier scored it 40 or more; matched counts include noise
- Start with `search_mentions` and a time range; use `get_analytics_*` for numbers over a period
- Only change keywords or alerts when asked; triage (status, assignee, notes) is fine
Solução de problemas
| Problema | O que fazer |
|---|---|
401 "Credenciais ausentes ou inválidas" | Entre novamente, ou verifique o cabeçalho e se a chave não foi revogada |
| O cliente pede autenticação | Execute o login dele, para o Claude Code /mcp e Autenticar |
| Nenhuma ferramenta listada | Recarregue o cliente |
| "Ferramenta desconhecida" para uma ferramenta de escrita | A chave ou o login tem apenas read |
| Uma lista parece truncada | search_mentions retorna 10 por vez. Restrinja os filtros, ou use a API REST para paginar tudo. |
405 | Use HTTP com streaming (POST /mcp), não o transporte SSE mais antigo |