Riveter

Riveter MCP サーバー

ClaudeやCursorなどのAIアシスタントをRiveter APIに接続するMCP（Model Context Protocol）サーバーです。エンリッチメントの実行、データセットの構築、ウェブページのスクレイピング、モニターの管理などを、アシスタントから直接行えます。

ツールはRiveterのOpenAPI仕様から動的に生成されるため、自動的に最新の状態に保たれます。

接続方法は2つあります。

• ホステッド — https://mcp.riveterhq.com/mcp。インストールは不要です。claude.ai、Claude Desktop、Cowork、Claudeモバイル、ChatGPT、Claude Code、Cursorから利用できます。
• ローカル（npx） — このnpmパッケージをお使いのマシン上でstdio経由で実行します。クライアントからリモートサーバーに接続できない場合に使用します。

セットアップ

1a. ホステッドサーバー（事前にAPIキーを用意する必要はありません）

https://mcp.riveterhq.com/mcpをカスタムコネクターとして追加し、Connectをクリックします。Riveterのブラウザーウィンドウが開くので、サインインしてAllowをクリックしてください。Riveterがその接続用のAPIキーを作成します。キーはSettings → API keysに表示され、取り消すとクライアントの接続が解除されます。

Claude Code:

claude mcp add --transport http riveter https://mcp.riveterhq.com/mcp

次に/mcpを実行し、Authenticateを選択します。

Cursor:

{
  "mcpServers": {
    "riveter": {
      "url": "https://mcp.riveterhq.com/mcp"
    }
  }
}

クライアントからブラウザーを開けない場合は、代わりにヘッダーとしてキーを渡します。Authorization: Bearer sk_riv_your_key_here（Claude Codeでは--header "Authorization: Bearer sk_riv_..."、Cursorでは"headers": { "Authorization": "Bearer sk_riv_..." }）。

1b. ローカルサーバー（npx）

Riveter APIキーを取得します。

Claude Desktop — 設定ファイルを開きます。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Riveterサーバーを追加します。

{
  "mcpServers": {
    "riveter": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "riveter-mcp-server@latest"],
      "env": {
        "RIVETER_API_KEY": "sk_riv_your_key_here"
      }
    }
  }
}

Cursor / Windsurf — 同じriveterエントリーをMCP設定に追加します（例：~/.cursor/mcp.json）。

Claude Code:

claude mcp add riveter --env RIVETER_API_KEY=sk_riv_your_key_here -- npx -y riveter-mcp-server

Codex:

codex mcp add riveter --env RIVETER_API_KEY=sk_riv_your_key_here -- npx -y riveter-mcp-server

ツールを最新の状態に保つには： ローカルサーバーは、クライアントの起動時にAPI定義を一度読み込み、そのプロセスを実行し続けます。RiveterがAPIを変更した後は、AIクライアント（または設定ページからMCPサーバー）を再起動して、新しいツールを読み込んでください。--prefer-online riveter-mcp-server@latestを使うと、再起動時にサーバーの新しいバージョンも取得されます。ホステッドサーバーは再起動不要で、10分ごとにAPI定義を再読み込みします。

環境変数

ローカル（stdio）サーバー — dist/index.js：

変数	必須	デフォルト	説明
RIVETER_API_KEY	はい	—	Riveter API キー
RIVETER_API_BASE_URL	いいえ	https://api.riveterhq.com/v1	API ベース URL
RIVETER_OPENAPI_URL	いいえ	https://docs.riveterhq.com/openapi.yaml	OpenAPI 仕様の URL。https://docs.riveterhq.com/openapi.legacy.yaml では、代わりにレガシー世代（動詞エンドポイント、レガシーのエンリッチメント、廃止済みのリスト作成操作）が提供されます

ホスト型（Streamable HTTP）サーバー — dist/http.js、Riveter によるデプロイ：

変数	デフォルト	説明
PORT	8080	リッスンポート
MCP_PUBLIC_URL	https://mcp.riveterhq.com/mcp	公開 URL。ユーザーが入力する URL と完全に一致します（RFC 9728 の resource）
OAUTH_ISSUER_URL	https://app.riveterhq.com	保護されたリソースのメタデータで通知される認可サーバー
SPEC_REFRESH_INTERVAL_MS	600000	仕様を再取得する間隔。0 にすると無効になります
RIVETER_API_BASE_URL、RIVETER_OPENAPI_URL	上記のとおり

ホスト型サーバーは API キーを保持しません。呼び出しのたびに呼び出し元の Authorization: Bearer ... ヘッダーを API に転送し、ヘッダーがない場合は WWW-Authenticate チャレンジとともに 401 を返します。

仕組み

起動時に、サーバーは次の処理を行います。

1. docs.riveterhq.com/openapi.yaml から OpenAPI 仕様を取得します
2. 各エンドポイントを、型付きパラメーターと注釈を備えた MCP ツールに解析します（GET から readOnlyHint、DELETE または仕様の x-mcp-destructive から destructiveHint、仕様の x-mcp-open-world から openWorldHint を設定します）
3. 仕様の info.x-mcp-instructions をサーバーレベルの短い instructions として使用します（API の詳細な概要はドキュメントサイトに残ります）。操作の x-mcp-description が設定されている場合、その操作のツールでは description の代わりに使用します
4. トピック（列設定、形式、ツール、run_when、例、クレジット、制限、エラーなど）が仕様の info.x-mcp-help に由来する help ツールを1つ追加します。詳しいガイダンスは、アシスタントからリクエストされた場合にのみ読み込まれます
5. stdio（ローカル）または Streamable HTTP（ホスト型）経由でツールを提供します

API ドキュメントが更新されると、ローカルサーバーは次回アシスタントを起動したときに変更を取り込み、ホスト型サーバーは10分ごとに仕様を再取得します。再ビルドや再公開は不要です。

開発

ソース：github.com/riveterhq/riveter-mcp。問題の報告もこちらで受け付けています。

npm install
npm test          # build + unit + stdio e2e + http e2e
npm run dev:http  # hosted server on :8080 (set MCP_PUBLIC_URL=http://localhost:8080/mcp)

このリポジトリは、開発が行われている Riveter の非公開モノレポにある mcp-server/ ディレクトリの読み取り専用ミラーです。仕様コントラクトのテストにはモノレポの openapi.yaml が必要なため、ここではスキップされます。リリースについては PUBLISHING.md に記載されています。

サポート

ご質問や問題がある場合は、Riveter API ドキュメントをご覧いただくか、[email protected] までお問い合わせください。

ライセンス

MIT