Riverside MCP

Riverside + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。Riverside API 向けの、コミュニティが開発した Claude Code スキルおよび MCP サーバーです。RiversideFM, Inc. とは提携しておらず、同社による承認や支援も受けていません。

_{スキルの全ページ - インストール、できること、安全性モデル。}

Riverside API の機能を MCP ツールとして利用できます。すでにお使いの AI で動作します。ChatGPT（Plus/Pro+。このコネクターが再公開されるまで一時停止中です。詳しくは mcp-install.md をご覧ください）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート経由でMicrosoft 365 Copilot / Copilot StudioやGoogle Geminiでも利用できます。無料、オープンソースで、ノート PC 上で動作します。MSP オーナー向けに構築されており、コードは不要です。

お使いのエージェントで動作します

セキュリティに関する注意（このコネクターが再公開されるまで）。 このコネクターを supergateway ブリッジや、その他の stdio から HTTP へのブリッジの背後に置かないでください。localhost 上でも同様です。このブリッジにはパスワードが設定されないため、そのポートにアクセスできる人なら誰でも、あなたの認証情報を使って MCP ツールを利用できます。デフォルトの stdio トランスポートを使用してください。リモートエージェント向けにブリッジやトンネルを設定している場合は、停止してください。修正を準備中です。

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスで、今すぐ利用できます）：

お使いの AI エージェント	Riverside スキルのインストール方法
Claude Desktop	インストーラーを実行し、設定 > Extensionsから riverside-fm-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	このコネクターが再公開されるまで一時停止中です。ChatGPT には HTTPS サーバーが必要ですが、この stdio 専用ビルドでは、パスワードを追加しない stdio から HTTP へのブリッジが必要になります。mcp-install.md のセキュリティに関する注意をご覧ください。
Codex CLI	下記のインストールプロンプトを貼り付けます。
Claude Code	下記のインストールプロンプトを貼り付けます。
Claude Cowork	下記のインストールプロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に riverside-fm-mcp を追加してから、Agent モードを選択します。

ChatGPT にはリモートの HTTPS サーバーが必要です。このコネクターは stdio のみで通信するため、パスワードを追加しない stdio から HTTP へのブリッジが必要になります。この方法は、コネクターが再公開されるまで一時停止中です。mcp-install.md のセキュリティに関する注意をご覧ください。

Microsoft と Google の環境にも対応

利用者は多いものの、正確にお伝えしておくと、これらはリモート／エンタープライズ向けの方法であり、インストールしたローカルバイナリを使う方法ではありません。

エージェント	必要なもの
Microsoft 365 Copilot / Copilot Studio	このコネクターが再公開されるまで一時停止中です。Copilot Studio には HTTPS サーバーが必要ですが、この stdio 専用ビルドでは、パスワードを追加しない stdio から HTTP へのブリッジが必要になります。mcp-install.md のセキュリティに関する注意をご覧ください。
Google Gemini	Gemini CLIはローカルで動作し、Claude Code と同じです。Gemini アプリはリモートで動作するため、ChatGPT と同じく一時停止中のリモート向けの方法が必要です。mcp-install.md をご覧ください。

スキルにネイティブ対応するエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み込み、MCP にも対応しています。詳しくは以下のインストール手順をご覧ください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed でも動作します。ツールごとの接続手順については、**docs/which-agent.md**をご覧ください。

複数のエージェントを使っていますか？ 1 つのコマンドで、対応する 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md をご覧ください。

60 秒でインストール

Claude Desktop に最速でインストール — ワンクリックの .mcpb

Riverside MCP（.mcpb）をダウンロード — 次に Claude Desktop > 設定 > 拡張機能 を開き、ファイルを選択します。ワンクリックで完了し、JSON もシェルも不要です。（すべての Riverside リリースはリリースページで確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールします。ディレクトリ一覧は不要で、すぐに動作します。

/plugin marketplace add Servosity/msp-skills
/plugin install riverside-fm@msp-skills

方法 A — AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーします。

このエージェントのワークスペースに、Servosity/msp-skills から Riverside Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex を実行してください。その後、README に従って認証し、riverside-fm-cli --help を実行して使い方を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

方法 B — インストーラーを自分で実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh)

インストーラーは、riverside-fm-cli（CLI）と riverside-fm-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を介して Skill を検出します。

確認：

riverside-fm-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得します。アップグレードするには、再実行してください。

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの先頭）をダウンロードし、設定 > 拡張機能 で再度選択してください。Claude Code プラグインのユーザー：/plugin update riverside-fm@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、またはその他の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続設定については mcp-install.md と docs/which-agent.md を参照してください。GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio の設定方法など、エージェントごとにセクションがあります。Claude Desktop では「設定 > 拡張機能」パネルを使うのが最も簡単です。JSON の編集を希望するユーザー向けの MCP 設定ブロックは mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/riverside-fm --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/riverside-fm --force

Hermes はネイティブで MCP に対応しているため、riverside-fm-mcp サーバーを直接使用することもできます。インストール方法も環境変数も同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使えます）。

https://github.com/servosity/msp-skills/tree/main/skills/riverside-fm から riverside-fm skill をインストールしてください。この skill では、必須 CLI（riverside-fm-cli）を openclaw: フロントマターのブロックを使ってインストールする方法を定義しています。

OpenClaw はまだ一般公開されていません。フロントマターの設定は事前に用意されており、OpenClaw のリリースと同時に有効になります。

認証する

riverside-fm-cli に必要な認証情報については、mcp-install.md を参照してください。

このスキルでできること

よくある質問	コマンド
スタジオ内のすべてをディスクにバックアップするには？	riverside-fm-cli bulk export --studio my-studio --out ./archive
録音1件の最も役立つ素材を一度に取得するには？	riverside-fm-cli grab <session-id> --out ./dl
トランスクリプトのアーカイブ全体から引用を検索するには？	riverside-fm-cli search "network effects" --json
トランスクリプトをウェブプレーヤー用の字幕に変換するには？	riverside-fm-cli transcripts convert <session-id> --format srt --out ep.srt
このエピソードで最も多く話したのは誰ですか？	riverside-fm-cli transcripts talktime <session-id> --json
スタジオ内で編集する準備が完全に整っているテイクはどれですか？	riverside-fm-cli ready --studio my-studio
プロジェクトの Magic Clip をすべて、新しい URL で取得するには？	riverside-fm-cli clips harvest --project 69fcda9fba030a19ae93a526 --download --out ./clips
期限切れになる前に、期限のある CloudFront メディアリンクを更新するには？	riverside-fm-cli media refresh --project 69fcda9fba030a19ae93a526 --prefetch --out ./media

すべてのコマンドのリファレンスは、guide.md をご覧ください。AI エージェントの運用規約（--agent、--dry-run、変更を加える前に確認すべき場合）については、AGENTS.md をご覧ください。

このスキルの特長

Riverside の統合や MCP サーバーの多くは、質問のたびにライブ API を呼び出します。1件のレコードなら問題ありません。しかし、「週刊番組の2年分から、あの顧客事例に触れたエピソードを探す」や「プランを解約する前に、このスタジオのテイクをすべてアーカイブする」といった、大規模な処理では機能しません。

このスキルは、Riverside のデータを全文検索機能付きのローカル SQLite ミラーに同期します。集計に関する質問はローカルクエリ1回で処理されるため、瞬時に、オフラインで実行でき、AI には生データではなく回答が渡されます。bulk export、clips harvest、search などの複合コマンドは、スタジオ、プロジェクト、テイク、トランスクリプト、クリップ素材を横断して処理します。ステートレスな API ラッパーでは対応できない作業です。

解消する課題

Riverside ではスタジオ品質のポッドキャストや動画を録音できますが、自分のコンテンツを取り出すのは手間のかかる作業です。一括エクスポート機能がないため、トランスクリプト、音声トラック、動画ファイルは、スタジオからプロジェクト、テイクへと進み、テイクごとに一つずつクリックして取り出す必要があります。50エピソードの番組をバックアップするには、何百回もクリックしなければなりません。この手間は深刻で、Podcasting のサブレディットやポッドキャストホストの Facebook グループなどのコミュニティでは、シリーズをアーカイブしたりストレージを空けたりするために「Riverside の録音を一括ダウンロードする方法」が繰り返し質問されています。これを解決できる公式 API は、個別価格の Business プランでしか利用できません。そのため Pro、Live、Webinar アカウントでは、自分の録音をバックアップ、検索、再フォーマットするためのサポートされた方法がありません。

このスキルは、そのギャップを埋めます。

• bulk export - スタジオ全体（または期間を指定した範囲）を、再開可能な形でディスクにアーカイブします。
• grab - 録音に最も役立つ素材（トランスクリプト、音声、動画の順）をダウンロードするコマンドです。
• search - ローカルミラー内のすべてのトランスクリプトを全文検索します。
• transcripts convert - Riverside の UI では提供されない WebVTT／SRT／Markdown 形式の字幕に、トランスクリプトを変換します。
• clips harvest - 更新済みのダウンロード URL を使って、プロジェクトの Magic Clip をすべて取得します。

詳しい説明は pain-point.md をご覧ください。

よくある質問

ChatGPT で使えますか？

このビルドでは使えません。ChatGPT（Plus、Pro、Team、Business、Enterprise、Education プラン。Free では現時点で Developer Mode を利用できません）は、HTTPS 経由のリモート MCP サーバーにのみ接続できます。Riverside MCP サーバーは stdio のみで通信するため、接続するには stdio から HTTP へのブリッジを前段に置く必要がありますが、そのブリッジにパスワードが追加されるわけではありません。コネクターが再発行されるまでは、ブリッジを設定したり、トンネルの背後に置いたりしないでください。その理由については、mcp-install.md のセキュリティに関する注意をご覧ください。それまでは、Claude Desktop、Claude Code、または Codex をお使いください。

これは Codex、Cursor、Windsurf、Cline、Copilot、Gemini で動作しますか？

はい。どれも MCP に対応しています。各ツールへのインストールコマンドは上の表に、詳しい説明はdocs/which-agent.mdにあります。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude Code または Codex に1文を貼り付けることです。エージェントが SKILL.md を読み取ってインストールします。代替方法として、OS ごとに1行のインストーラー（bash または PowerShell）を用意しています。どちらの方法でも、コードを書く必要はありません。Riverside の認証情報を一度入力するだけです。

Riverside のデータは安全ですか？

データはお使いのマシンに保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント内のディレクトリに保存されます。AI エージェントに表示されるのは CLI が返す内容だけです。通常はクエリ結果であり、生の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。このリポジトリに含められたり、MSP Skills によってどこかへ送信されたりすることはありません。

Riverside Business プランまたは API キーは必要ですか？

いいえ。公式の Riverside API を利用するには、個別に価格設定された Business プランが必要です。この CLI は、すでにログイン済みのブラウザーからセッション Cookie を再利用して、Riverside ウェブアプリが使用するのと同じ内部 API にアクセスします。そのため、API キーを発行できないPro、Live、Webinarアカウントでも動作します。riverside-fm-cli auth login --chrome を一度実行してください。

他人の録画をダウンロードできますか？

いいえ。ご自身のブラウザーセッションを使ってお客様本人として認証し、お客様のアカウントがすでにアクセスできるスタジオとテイクにのみアクセスします。他人のコンテンツをスクレイピングするのではなく、ご自身のコンテンツをエクスポートする用途に限定されています。

これは Riverside アカウントに何か変更を加えますか？

エクスポート、検索、変換に使用するコマンドはすべて読み取り専用です。データをダウンロードして変換するだけです。CLI には汎用の import コマンドも含まれており、API の作成／アップサート経由でローカルファイルのレコードを POST できます。このスキルのワークフローでは使用しないものであり、エージェントはレビューが必要な書き込み操作として扱う必要があります。この CLI には削除や公開を行う機能はありません。

費用はいくらですか？

無料です。Apache-2.0 ライセンスです。費用がかかるのは、使用する AI エージェント（Claude、ChatGPT、Codex など）の料金のみで、請求元は当方ではなく、お使いの AI プロバイダーです。

安全性モデル

このスキルの Riverside データコマンドは読み取り専用です。エクスポート、検索、ダウンロード、文字起こしの各コマンドは、アカウントに対して GET のみを実行します。唯一の変更系コマンドは汎用の import で、ローカルの JSONL ファイルにあるレコードを POST します。このコマンドは、ここに記載するエクスポートのワークフローでは使用しません。

ティア	例	推奨されるエージェントポリシー
読み取り	bulk export、grab、search、transcripts convert、transcripts talktime、clips harvest、media refresh、ready、wait、sync	許可
書き込み（通常）	import（API の作成／アップサート経由で、ローカルの JSONL ファイルからレコードを POST）；エンドポイントミラー機能で安全性スキャナーが動詞名に基づいて警告する機能（ai can-create-event、takes get-assets、clips get-patches）自体は読み取り専用の GET です	--dry-run でプレビューしてから、レビュー済みの書き込みを実行
破壊的操作／設定	なし。この CLI には削除、公開、アカウント設定を行うコマンドはありません	必ず人間が介在

最も強力な制御手段は、Riverside の認証情報に付与する権限の範囲です。CLI が実行できるのは、その認証情報で許可されている操作だけです。制限方法を含む詳細はgovernance.mdをご覧ください。

ステータス

ベータ版です。Riverside API の仕様に照らして検証済みで、毎週開催している Build Sessions では、MSP が本番テナントで実際に実行しながら検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills 仕様（Anthropic、2025 年 12 月公開、40 以上のエージェントに対応）に準拠しています。MCP と互換性があり、Hermes を含む、MCP 対応のあらゆるエージェントで動作します。OpenClaw にも対応しています（フロントマターの設定は済んでおり、OpenClaw のリリース待ちです）。

Servosity がメンテナンスしています。Apache-2.0 ライセンスです。CLI Printing Press を使用して構築されています。最終更新日：2026-06-30。