Rumoro

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

MCP 서버

Claude Code 및 기타 MCP 클라이언트를 멘션에 연결하세요. OAuth로 로그인하거나 API 키를 사용하세요.

Rumoro의 Model Context Protocol 서버는 호스팅되어 있으므로 설치할 것이 없습니다. MCP 클라이언트가 연결되면 에이전트가 멘션을 검색하고 분류하며, 키워드와 회사 프로필을 관리하고, 분석을 읽고, 알림, 사용자 및 세그먼트를 설정할 수 있습니다. 대시보드와 동일한 규칙을 따릅니다.

https://mcp.rumoro.dev/mcp

• 호스팅, 스트리밍 HTTP, 세션 없음. 설치할 것이 없습니다. 클라이언트는 application/json 및 text/event-stream 응답을 모두 수락해야 합니다.
• OAuth 또는 API 키. MCP 인증을 지원하는 클라이언트는 브라우저를 통해 로그인합니다. 다른 클라이언트는 Bearer 헤더로 키를 전송합니다. read 액세스 권한이 있으면 클라이언트는 읽기 도구만 볼 수 있고, write 권한이 있으면 모든 도구를 볼 수 있습니다.
• REST API와 일치하는 55개 도구. 도구 아래에 나열되어 있습니다.

빠른 시작

### 서버 추가

Claude Code에서 다음을 실행하세요.

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

그런 다음 `/mcp`를 입력하고 `rumoro`을 선택한 후 **인증**을 클릭하세요. 로그인하고 클라이언트가 요청하는 액세스를 승인하세요. 여러 워크스페이스에 속한 경우 하나를 선택하세요. 다른 클라이언트는 [설치](#installation) 아래에 있습니다.

CI, 서버 또는 OAuth가 없는 클라이언트의 경우 **API 키** 페이지에서 키를 생성하세요. `read`은 둘러보기용이고 `write`는 변경용입니다. 키는 한 번만 볼 수 있습니다.

### 질문하기

"이번 주 부정적인 멘션은 무엇이었고, 사람들이 무엇에 불만이 있었나요?"라고 시도해 보세요.

인증

각 도구 호출은 Bearer 자격 증명을 전달합니다. 서버는 두 종류를 동일하게 처리합니다.

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

OAuth 2.1

로그인은 MCP 인증 사양을 따릅니다. 자격 증명 없이 호출하면 401 및 WWW-Authenticate: Bearer realm="rumoro-mcp", resource_metadata="https://mcp.rumoro.dev/.well-known/oauth-protected-resource"가 반환됩니다. 그러면 클라이언트가 자체 등록(PKCE 사용)하고 브라우저를 엽니다. 동의 페이지에서 각 로그인을 승인하며, 토큰은 해당 워크스페이스의 역할 내에서 사용자로 작동합니다. 액세스 토큰은 1시간 동안 유효합니다. offline_access 권한이 있으면 클라이언트는 30일 동안 유효하고 사용할 때마다 교체되는 리프레시 토큰도 받습니다. write 없이 로그인하면 read으로 작동합니다.

API 키

API 키 페이지 또는 POST /v1/api-keys에서 키를 생성하세요. 각 키는 한 번만 볼 수 있으며 하나의 워크스페이스에 속합니다. 키를 취소하면 클라이언트는 다음 호출에서 작동을 중지합니다.

검색

연결에는 자격 증명이 필요하지 않습니다. initialize, tools/list 및 리소스는 자격 증명 없이 응답합니다. 전송된 자격 증명은 항상 확인되며 모든 tools/call에는 자격 증명이 필요합니다.

`https://mcp.rumoro.dev/mcp`를 사용자 지정 커넥터로 추가하고 요청 시 로그인하세요.

리소스

리소스	URI	내용
openapi	https://api.rumoro.dev/v1/openapi.json	모든 스키마가 포함된 도구 뒤의 REST API
agent-guide	https://mcp.rumoro.dev/mcp/guide	에이전트 연결 방법, 각 권한이 허용하는 작업, 검토 워크플로

각 도구에는 readOnlyHint, destructiveHint 및 idempotentHint가 있으므로 클라이언트는 어떤 호출을 먼저 확인해야 하는지 알 수 있습니다. 7개의 파괴적 도구는 도구 아래에 표시되어 있습니다.

레지스트리는 서버 카드를 읽을 수 있습니다.

도구 동작 방식

• 각 도구는 REST API와 동일한 작업을 동일한 검증, 오류 및 속도 제한으로 실행합니다.
• search_mentions은 기본적으로 10개의 멘션을 반환하고 hasMore은 커서 없이 반환합니다. 더 많은 결과가 있으면 필터나 시간 범위를 좁히세요.
• 내보내기 도구는 없습니다. 대규모 목록에는 REST 내보내기 또는 CLI를 사용하세요.
• 쓰기 도구에는 write 키 또는 로그인이 필요합니다. read 권한이 있으면 쓰기 도구가 전혀 표시되지 않습니다.
• 서버는 요청 간 세션을 유지하지 않습니다. 응답은 JSON 또는 짧은 이벤트 스트림으로 제공됩니다.

작성자 데이터

list_people, get_person 및 기타 사용자 도구는 Rumoro가 작성자에 대해 보관하는 공개 정보(이름, 핸들, 사진, 팔로워 수, 프로필 세부 정보 등)를 반환합니다. 이메일 주소는 절대 반환하지 않으므로 profile.email은 REST API에 표시되더라도 MCP에서는 항상 null입니다. 작동 방식은 저장되는 내용과 사용자가 삭제를 요청할 수 있는 방법을 설명합니다.

질문할 수 있는 내용

• "지난 7일 동안 Hacker News와 Reddit에서 사람들이 우리에 대해 말한 내용을 요약해 주세요."
• "아무도 답변하지 않은 가격 관련 질문을 찾아 각각에 대한 답변 초안을 작성해 주세요."
• "이번 달에 가장 긍정적인 멘션을 받은 경쟁사는 어디이며, 그 이유는 무엇인가요?"
• "우리 팀의 모든 멘션을 완료로 표시하세요."
• "우리 키워드 driftwood이 시끄럽습니다. 상태 보고서를 확인하고 가장 좋은 제안을 적용하세요."
• "베를린 시간 오전 9시에 지원 채널용 부정적 멘션 일일 요약을 만드세요."
• "이번 달에 우리를 언급한 팔로워 10,000명 이상의 사용자는 누구인가요?"

문서 MCP 서버

문서에는 자체 읽기 전용 MCP 서버가 있으며 키가 필요하지 않습니다.

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

• 도구. search_docs는 전체 텍스트를 검색하고, read_page은 경로(예: /quickstart)로 페이지를 Markdown으로 반환하며, list_pages는 제목과 설명과 함께 모든 페이지를 나열합니다.
• 리소스. .mdx 주소의 모든 페이지와 https://docs.rumoro.dev/llms.txt.
• 카드. /.well-known/mcp.json.

보안

• 필요한 액세스만 부여하세요. 탐색에는 read을 사용하고, 변경해야 하는 에이전트에만 write을 사용하세요. get_usage 및 list_ledger가 잔액을 읽더라도 어떤 도구도 청구 또는 API 키를 변경할 수 없습니다.
• API와 동일한 규칙. 호출은 키의 워크스페이스 또는 로그인한 사용자로 작동하며 동일한 검사 및 속도 제한이 적용됩니다.
• 키를 저장소에 보관하지 마세요. OAuth는 클라이언트 설정에 비밀을 남기지 않습니다. 키를 사용하는 경우 사용자 수준 설정이나 환경 변수를 사용하고 유출되면 취소하세요.

설치

OAuth를 사용하면 클라이언트는 URL만 필요합니다. 키를 사용하면 Authorization: Bearer ref_... 헤더를 추가하세요. CLI에서 rumoro mcp:config은 키가 채워진 설정을 출력합니다.

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

그런 다음 `/mcp`를 실행하고 `rumoro`을 선택한 후 **인증**을 클릭하세요. `--scope project`를 추가하여 저장소의 `.mcp.json`에 URL을 저장하거나 `--scope user`을 사용하여 모든 프로젝트에서 사용하세요. [Claude Code 페이지](https://rumoro.dev/claude)에서 예제 질문과 함께 자세히 설명합니다. 키를 사용하는 경우 다음을 실행하세요.

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

모든 프로젝트에 대해 `~/.cursor/mcp.json`에 서버를 추가하거나 단일 프로젝트에 `.cursor/mcp.json`에 추가하세요. [Cursor 페이지](https://rumoro.dev/cursor)에서 예제 질문과 함께 자세히 설명합니다.

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

`headers`를 생략하면 OAuth로 로그인합니다. 일부 Cursor 버전은 로그인 링크를 열지 않고 빌드하므로 모든 도구가 `Unauthorized`으로 응답합니다. 키는 항상 작동합니다.

**MCP: 서버 추가**를 실행하고 **HTTP**를 선택한 후 `https://mcp.rumoro.dev/mcp`을 입력하고 `rumoro`로 이름을 지정하세요. 키를 사용하는 경우:

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

[Codex 페이지](https://rumoro.dev/codex)에서 예제 질문과 함께 자세히 설명합니다. 키를 사용하는 경우 환경 변수에서 읽으세요.

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

[grok.com/connectors](https://grok.com/connectors)를 열고 **새 커넥터**, **사용자 지정**을 선택한 후 `https://mcp.rumoro.dev/mcp`을 입력하세요. Grok은 OAuth 로그인을 실행합니다. Business 및 Enterprise 요금제에서는 관리자가 먼저 커넥터를 프로비저닝합니다. [Grok 페이지](https://rumoro.dev/grok)에서 예제 질문과 함께 자세히 설명합니다. `mcp_servers` 아래에 서버를 추가한 후 `hermes mcp login rumoro`를 실행하세요. Hermes는 Rumoro에 자체 등록하므로 생성할 클라이언트 ID가 없습니다.

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

`hermes mcp test rumoro`으로 확인하거나 세션에서 `/reload-mcp`을 실행하세요. [Hermes 페이지](https://rumoro.dev/hermes)에서 예제 질문과 함께 자세히 설명합니다. 키를 사용하는 경우 `auth: oauth`을 `headers: { Authorization: "Bearer ${RUMORO_API_KEY}" }`로 바꾸고 `RUMORO_API_KEY`을 `~/.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 ```

[OpenClaw 페이지](https://rumoro.dev/openclaw)에서 예제 질문과 함께 자세히 설명합니다. API 키를 사용하려면 [Rumoro 스킬](/integrations/openclaw)을 설치하세요.

클라이언트 자체 파일 및 URL 키와 함께 Cursor 설정을 사용하세요.

| 클라이언트 | 파일 | URL 키 |
| --- | --- | --- |
| Gemini CLI | `~/.gemini/settings.json` | `httpUrl` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `serverUrl` |
| 기타 | 클라이언트의 MCP 설정 | `url`, `"type": "http"` 포함 |

에이전트가 길을 찾도록 도와주세요

AGENTS.md, CLAUDE.md 또는 클라이언트의 규칙 파일에서 추적하는 내용을 에이전트에게 알려주세요.

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

문제 해결

문제	해결 방법
401 "자격 증명이 없거나 잘못되었습니다"	다시 로그인하거나 헤더와 키가 취소되지 않았는지 확인하세요
클라이언트가 인증을 요청함	로그인을 실행하세요. Claude Code의 경우 /mcp 및 인증
도구가 나열되지 않음	클라이언트를 새로고침하세요
쓰기 도구에 대해 "알 수 없는 도구"	키 또는 로그인에 read 권한만 있습니다
목록이 짧게 잘린 것 같음	search_mentions은 한 번에 10개를 반환합니다. 필터를 좁히거나 REST API를 사용하여 모든 항목을 페이지로 탐색하세요.
405	이전 SSE 전송이 아닌 스트리밍 HTTP(POST /mcp)를 사용하세요