Rumoro

npx add-mcp 'https://mcp.rumoro.dev/mcp'

Servidor MCP

Conecta Claude Code y otros clientes MCP a tus menciones. Inicia sesión con OAuth o usa una clave de API.

El servidor de Model Context Protocol de Rumoro está alojado, por lo que no hay nada que instalar. Una vez que tu cliente MCP esté conectado, tu agente puede buscar y clasificar menciones, gestionar palabras clave y el perfil de tu empresa, leer análisis y configurar alertas, personas y segmentos. Sigue las mismas reglas que el panel de control.

https://mcp.rumoro.dev/mcp

• Alojado, HTTP transmisible, sin sesión. No hay nada que instalar. Los clientes deben aceptar tanto respuestas application/json como text/event-stream.
• OAuth o una clave de API. Los clientes que admiten autorización MCP te inician sesión a través del navegador. Otros envían una clave como encabezado Bearer. Con acceso read el cliente solo ve las herramientas de lectura; con write ve todas.
• 55 herramientas que coinciden con la API REST. Están listadas en Herramientas.

Inicio rápido

### Añadir el servidor

En Claude Code, ejecuta

```bash
claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp
```

Luego escribe `/mcp`, elige `rumoro` y **Autenticar**. Inicia sesión y aprueba el acceso que el cliente solicita. Si perteneces a varios espacios de trabajo, también eliges uno. Otros clientes están en [Instalación](#installation).

Para CI, un servidor o un cliente sin OAuth, crea una clave en la página **Claves de API**, `read` para explorar o `write` para hacer cambios. Solo la ves una vez.

### Pregunta

Prueba "¿Qué menciones de esta semana fueron negativas y qué les molestaba a las personas?"

Autenticación

Cada llamada a una herramienta lleva una credencial Bearer. El servidor maneja ambos tipos de la misma manera.

Authorization: Bearer <OAuth access token>
Authorization: Bearer ref_...

OAuth 2.1

El inicio de sesión sigue la especificación de autorización MCP. Una llamada sin credencial recibe 401 con WWW-Authenticate: Bearer realm="rumoro-mcp", resource_metadata="https://mcp.rumoro.dev/.well-known/oauth-protected-resource". El cliente entonces se registra (registro dinámico con PKCE) y abre el navegador. Apruebas cada inicio de sesión en una página de consentimiento, y el token actúa como tú, dentro de tu rol en ese espacio de trabajo. Los tokens de acceso duran una hora. Con offline_access el cliente también recibe un token de actualización que dura 30 días y se reemplaza cada vez que se usa. Un inicio de sesión sin write funciona como read.

Claves de API

Crea claves en la página Claves de API o con POST /v1/api-keys. Ves cada clave una vez y pertenece a un espacio de trabajo. Cuando revocas una clave, el cliente deja de funcionar en su siguiente llamada.

Descubrimiento

Conectarse no requiere credencial. initialize, tools/list y los recursos responden sin una. Una credencial enviada siempre se verifica, y cada tools/call necesita una.

Añade `https://mcp.rumoro.dev/mcp` como conector personalizado e inicia sesión cuando se te pida.

Recursos

Recurso	URI	Qué contiene
openapi	https://api.rumoro.dev/v1/openapi.json	La API REST detrás de las herramientas, con todos los esquemas
agent-guide	https://mcp.rumoro.dev/mcp/guide	Cómo se conecta un agente, qué permite cada permiso y un flujo de revisión

Cada herramienta tiene readOnlyHint, destructiveHint y idempotentHint, para que un cliente sepa qué llamadas confirmar primero. Las siete herramientas destructivas están marcadas en Herramientas.

Los registros pueden leer la tarjeta del servidor.

Cómo se comportan las herramientas

• Cada herramienta ejecuta la misma operación que la API REST, con la misma validación, errores y límite de velocidad.
• search_mentions devuelve 10 menciones por defecto y hasMore, sin cursor. Cuando hay más, reduce los filtros o el rango de tiempo.
• No hay herramientas de exportación. Usa las exportaciones REST o la CLI para listas grandes.
• Las herramientas de escritura necesitan una clave write o inicio de sesión. Con read no aparecen en absoluto.
• El servidor no mantiene sesión entre solicitudes. Las respuestas vienen como JSON o como un breve flujo de eventos.

Datos de autores

list_people, get_person y las otras herramientas de personas devuelven los datos públicos que Rumoro guarda sobre los autores, como nombre, usuario, imagen, número de seguidores y detalles del perfil. Nunca devuelven una dirección de correo electrónico, por lo que profile.email siempre es null a través de MCP, incluso donde la API REST muestra una. Cómo funciona explica qué se almacena y cómo las personas pueden solicitar ser eliminadas.

Qué puedes preguntar

• "Resume lo que la gente dijo sobre nosotros en Hacker News y Reddit en los últimos 7 días."
• "Encuentra preguntas sobre nuestros precios que nadie ha respondido y redacta una respuesta para cada una."
• "¿Qué competidor recibió más menciones positivas este mes y por qué?"
• "Marca como hecha cada mención de nuestro propio equipo."
• "Nuestra palabra clave driftwood es ruidosa. Mira su informe de salud y aplica la mejor sugerencia."
• "Crea un resumen diario de menciones negativas para el canal de soporte a las 9:00 hora de Berlín."
• "¿Quiénes son las personas con más de 10,000 seguidores que nos mencionaron este mes?"

Servidor MCP de documentación

La documentación tiene su propio servidor MCP de solo lectura y no necesita clave.

https://docs.rumoro.dev/api/mcp

• Herramientas. search_docs busca en el texto completo, read_page devuelve una página como Markdown por su ruta, como /quickstart, y list_pages lista cada página con su título y descripción.
• Recursos. Cada página en su dirección .mdx, además de https://docs.rumoro.dev/llms.txt.
• Tarjeta. /.well-known/mcp.json.

Seguridad

• Da solo el acceso necesario. Usa read para explorar y write solo para un agente que deba cambiar cosas. Ninguna herramienta puede cambiar facturación o claves de API, aunque get_usage y list_ledger leen el saldo.
• Mismas reglas que la API. Las llamadas actúan como el espacio de trabajo de la clave o la persona que inició sesión, con las mismas comprobaciones y límite de velocidad.
• Mantén las claves fuera de los repositorios. OAuth no deja secretos en la configuración del cliente. Con una clave, usa configuraciones a nivel de usuario o una variable de entorno, y revócala si se filtra.

Instalación

Con OAuth, un cliente solo necesita la URL. Con una clave, añade el encabezado Authorization: Bearer ref_.... En la CLI, rumoro mcp:config imprime estas configuraciones con tu clave completada.

```bash claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp ```

Luego ejecuta `/mcp`, elige `rumoro` y **Autenticar**. Añade `--scope project` para guardar la URL en el `.mcp.json` del repositorio, o `--scope user` para usarla en cada proyecto. La [página de Claude Code](https://rumoro.dev/claude) lo explica con preguntas de ejemplo. Con una clave, ejecuta

```bash
claude mcp add --transport http rumoro https://mcp.rumoro.dev/mcp \
  --header "Authorization: Bearer ref_..."
```

Añade el servidor a `~/.cursor/mcp.json` para cada proyecto, o a `.cursor/mcp.json` para uno solo. La [página de Cursor](https://rumoro.dev/cursor) lo explica con preguntas de ejemplo.

```json title=".cursor/mcp.json"
{
  "mcpServers": {
    "rumoro": {
      "url": "https://mcp.rumoro.dev/mcp",
      "headers": { "Authorization": "Bearer ref_..." }
    }
  }
}
```

Omite `headers` para iniciar sesión con OAuth en su lugar. Algunas versiones de Cursor construyen el enlace de inicio de sesión sin abrirlo, por lo que cada herramienta responde `Unauthorized`; la clave siempre funciona.

Ejecuta **MCP: Add Server**, elige **HTTP**, ingresa `https://mcp.rumoro.dev/mcp` y nómbralo `rumoro`. Con una clave, usa

```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 ```

La [página de Codex](https://rumoro.dev/codex) lo explica con preguntas de ejemplo. Con una clave, léela desde una variable de entorno.

```bash
export RUMORO_API_KEY="ref_..."
codex mcp add rumoro --url https://mcp.rumoro.dev/mcp --bearer-token-env-var RUMORO_API_KEY
```

Abre [grok.com/connectors](https://grok.com/connectors), elige **New Connector**, luego **Custom**, e ingresa `https://mcp.rumoro.dev/mcp`. Grok ejecuta el inicio de sesión OAuth. En los planes Business y Enterprise, un administrador aprovisiona el conector primero. La [página de Grok](https://rumoro.dev/grok) lo explica con preguntas de ejemplo. Añade el servidor bajo `mcp_servers`, luego ejecuta `hermes mcp login rumoro`. Hermes se registra con Rumoro, por lo que no hay ID de cliente que crear.

```yaml title="~/.hermes/config.yaml"
mcp_servers:
  rumoro:
    url: "https://mcp.rumoro.dev/mcp"
    auth: oauth
```

Verifícalo con `hermes mcp test rumoro`, o ejecuta `/reload-mcp` en una sesión. La [página de Hermes](https://rumoro.dev/hermes) lo explica con preguntas de ejemplo. Con una clave, reemplaza `auth: oauth` con `headers: { Authorization: "Bearer ${RUMORO_API_KEY}" }` y pon `RUMORO_API_KEY` en `~/.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 ```

La [página de OpenClaw](https://rumoro.dev/openclaw) lo explica con preguntas de ejemplo. Para usar una clave de API en su lugar, instala la [habilidad Rumoro](/integrations/openclaw).

Usa la configuración de Cursor con el archivo y la clave de URL del propio cliente.

| Cliente | Archivo | Clave de URL |
| --- | --- | --- |
| Gemini CLI | `~/.gemini/settings.json` | `httpUrl` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `serverUrl` |
| Cualquier otro | La configuración MCP del cliente | `url`, más `"type": "http"` |

Ayuda a tu agente a orientarse

Dile al agente qué rastreas en AGENTS.md, CLAUDE.md o el archivo de reglas del 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

Solución de problemas

Problema	Qué hacer
401 "Faltan credenciales o son inválidas"	Inicia sesión de nuevo, o verifica el encabezado y que la clave no esté revocada
El cliente pide autenticación	Ejecuta su inicio de sesión, para Claude Code /mcp y Autenticar
No se listan herramientas	Recarga el cliente
"Herramienta desconocida" para una herramienta de escritura	La clave o el inicio de sesión solo tiene read
Una lista parece truncada	search_mentions devuelve 10 a la vez. Reduce los filtros o usa la API REST para paginar todo.
405	Usa HTTP transmisible (POST /mcp), no el transporte SSE más antiguo