Rumoro

oficial

Descubra 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/json e text/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; com write, vê todas.
  • 55 ferramentas que correspondem à API REST. Elas estão listadas em Ferramentas.

Início rápido

### Adicionar o servidor
No 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.

Adicione `https://mcp.rumoro.dev/mcp` como um conector personalizado e entre quando solicitado.

Recursos

RecursoURIO que contém
openapihttps://api.rumoro.dev/v1/openapi.jsonA API REST por trás das ferramentas, com todos os esquemas
agent-guidehttps://mcp.rumoro.dev/mcp/guideComo 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_mentions retorna 10 menções por padrão e hasMore, 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 write ou login. Com read, 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 driftwood está 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_docs pesquisa o texto completo, read_page retorna uma página como Markdown pelo caminho, como /quickstart, e list_pages lista todas as páginas com título e descrição.
  • Recursos. Cada página no endereço .mdx, além de https://docs.rumoro.dev/llms.txt.
  • Cartão. /.well-known/mcp.json.

Segurança

  • Dê apenas o acesso necessário. Use read para explorar e write apenas para um agente que deve alterar coisas. Nenhuma ferramenta pode alterar cobrança ou chaves de API, embora get_usage e list_ledger leiam 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.

```bash claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp ```
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

ProblemaO 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çãoExecute o login dele, para o Claude Code /mcp e Autenticar
Nenhuma ferramenta listadaRecarregue o cliente
"Ferramenta desconhecida" para uma ferramenta de escritaA chave ou o login tem apenas read
Uma lista parece truncadasearch_mentions retorna 10 por vez. Restrinja os filtros, ou use a API REST para paginar tudo.
405Use HTTP com streaming (POST /mcp), não o transporte SSE mais antigo