MnogoReels について
MnogoReelsは、長尺動画から縦型ショート動画、文字起こし、記事を作成するMCPサーバーです。クリエイターはMCPクライアントから対応する動画リンクを渡し、自分のMnogoReelsアカウントで処理できます。
主な機能
- 01長尺動画から9:16の縦型クリップを作成
- 02見どころを選びフックタイトルを追加
- 03クリップに字幕を焼き込み
- 04文字起こしと記事を生成
- 05複数プラットフォームの動画リンクに対応
活用シーン
- 01長時間の録画から短尺動画を作成
- 02動画から文字起こしと記事を作成
- 03オンライン動画から字幕付きReelsやShortsを作成
MCP 対応
MCPクライアントにMnogoReelsの動画処理機能を提供します。ホスト型Streamable HTTPサーバーまたはローカルstdioサーバーとして接続でき、読み取り専用のホスト型エンドポイントにはジョブ作成ツールがありません。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.mnogo-reels.ru/mcpclaude mcp add --transport http ru-mnogo-reels-mnogoreels https://mcp.mnogo-reels.ru/mcp{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}Cursor で開く{"servers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}VS Code で開く{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"type":"http","url":"https://mcp.mnogo-reels.ru/mcp"}}}{"mcpServers":{"ru-mnogo-reels-mnogoreels":{"serverUrl":"https://mcp.mnogo-reels.ru/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.mnogo-reels.ru/mcp認証が必要https://mcp.mnogo-reels.ru/mcp/readonly認証が必要ツール
19このツールにパラメーターはありません。
詳細
English | Русский
MnogoReels MCP サーバー
MnogoReels MCP サーバー:あらゆる MCP クライアントから、長尺動画を字幕付きの縦型ショート動画/リール、文字起こし、記事に変換できます。YouTube、VK Video、RuTube、Dzen、Twitch、Yandex Disk、Google Drive、または動画への直接リンクを AI アシスタントに渡すと、最適な場面を選び、9:16 にリフレームし、字幕とフックとなるタイトルを焼き込み、完成したクリップへのリンクを返します。処理には、ご自身の MnogoReels アカウントを使用します。
ワンクリックインストール
アプリへの直接リンク(ボタンでエディターが開かない場合)
GitHub では cursor:// と vscode: のリンクはクリック可能なリンクとして表示されないため、ブラウザーのアドレスバーにコピーしてください。
Cursor、ホスト型:
cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJ1cmwiOiJodHRwczovL21jcC5tbm9nby1yZWVscy5ydS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D
Cursor、ローカル:
cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1ub2dvcmVlbHMtbWNwQGxhdGVzdCJdLCJlbnYiOnsiTU5PR09SRUVMU19BUElfS0VZIjoiJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D
VS Code、ホスト型(キーの入力を求められます):
vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D
VS Code、ローカル(キーの入力を求められます):
vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mnogoreels-mcp%40latest%22%5D%2C%22env%22%3A%7B%22MNOGOREELS_API_KEY%22%3A%22%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D
Claude Desktop のバンドル(.mcpb)を開くと、キーと任意の読み取り専用切り替えの入力を求めるインストールダイアログが表示されます。Goose のリンクとその他すべてのクライアントは、クイックスタートに記載されています。
API キーを取得する
- mnogo-reels.ru でサインインするか、登録します。
- Developers → API keys を開いてキーを作成します。キーは
mrfrt_usr_で始まります。 - 以下の説明に従って、クライアントの設定にキーを追加します(ローカルサーバーでは
MNOGOREELS_API_KEY、ホスト型サーバーではAuthorization: Bearerヘッダーを使用します)。
キーを使うとクレジットが消費される場合があります。 クライアントやマシンごとに個別のキーを使用し、チャット、イシュー、URL に貼り付けないでください。不要になったら、同じページでキーを取り消してください。
ツールの一覧表示はキーなしで利用できます。また、新しいリンクに対する get_account、get_options_guide、check_video_source、quote_clip_job もキーなしで利用できます。ジョブを読み取る操作や新しいジョブを作成する操作には、すべてキーが必要です。
クイックスタート
ホスト型サーバー(推奨)
URL:https://mcp.mnogo-reels.ru/mcp(Streamable HTTP)。キーをヘッダーで送信します。
{
"mcpServers": {
"mnogoreels": {
"type": "http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
}
}
}
- クライアントで
Authorizationを設定できない場合は、代わりにX-API-Key: mrfrt_usr_YOUR_KEYを送信してください。 https://mcp.mnogo-reels.ru/mcp/readonlyは、ジョブを作成したりクレジットを消費したりするツールを除いた同じサーバーです。- キーを URL に含めないでください。そのようなリクエストはサーバーによって拒否されます。
ローカルサーバー(stdio)
Node.js 22 以降が必要です。サーバーは、お使いのマシンから https://api.mnogo-reels.ru に直接接続します。
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
"type": "http" は Claude Code、VS Code、Cursor で使用される表記です。Cline では "streamableHttp"、Windsurf では serverUrl、Gemini CLI では httpUrl が必要です。クライアントごとの正確な設定形式は、以下のブロックを参照してください。すぐに使えるファイルは examples/ にあり、クライアントごとの詳しい説明は docs/clients.md に記載されています。
Claude Code
ホスト型:
claude mcp add --transport http mnogoreels https://mcp.mnogo-reels.ru/mcp --header "Authorization: Bearer mrfrt_usr_YOUR_KEY"
ローカル:
claude mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest
プラグイン(ホスト型サーバーと make-shorts スキルを含みます。有効にするときにキーの入力を求められます):
/plugin marketplace add RealSatanyan/mnogoreels-mcp
/plugin install mnogoreels@mnogoreels
Claude Desktop
mnogoreels-mcp.mcpb をダウンロードしてダブルクリックするか、設定 → 拡張機能にドラッグします。Claude Desktop で API キーの入力を求められ、組み込みの Node.js を使ってサーバーが実行されます。
または、ローカルサーバーを claude_desktop_config.json に追加します(設定 → 開発者 → 設定を編集):
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
固定の API キーヘッダーを使用するカスタムリモートコネクターは、個人の Claude Desktop ユーザーには利用できません。そのため、バンドルまたはローカルサーバーを使用してください。
Cursor
上のボタンを使用するか、~/.cursor/mcp.json(すべてのプロジェクト)または .cursor/mcp.json(単一のプロジェクト)に追加します:
{
"mcpServers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
}
}
}
ローカル版:上記のローカルサーバーの設定ブロックを使用します。キーを環境変数に保存する場合は、"MNOGOREELS_API_KEY": "${env:MNOGOREELS_API_KEY}" を追加してください。
VS Code(GitHub Copilot)
上のボタンを使用するか、.vscode/mcp.json を作成します。VS Code ではキーの入力を一度求められ、安全に保存されます:
{
"inputs": [
{
"type": "promptString",
"id": "mnogoreels_api_key",
"description": "MnogoReels API key (mrfrt_usr_...)",
"password": true
}
],
"servers": {
"mnogoreels": {
"type": "http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${input:mnogoreels_api_key}" }
}
}
}
ワークスペースの .mcp.json では、ホスト型サーバーの mcpServers 形式を使用します。キーが含まれるファイルはコミットしないでください。
OpenAI Codex
`~/.codex/config.toml`。ホスト型の場合は、Codex を起動するシェルで `MNOGOREELS_API_KEY` をエクスポートします。[mcp_servers.mnogoreels]
url = "https://mcp.mnogo-reels.ru/mcp"
bearer_token_env_var = "MNOGOREELS_API_KEY"
tool_timeout_sec = 120
ローカル:
[mcp_servers.mnogoreels]
command = "npx"
args = ["-y", "mnogoreels-mcp@latest"]
env_vars = ["MNOGOREELS_API_KEY"]
startup_timeout_sec = 60
tool_timeout_sec = 120
または、コマンドラインから設定します。
codex mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest
デフォルトの起動タイムアウトは10秒ですが、初回の npx のダウンロードには短すぎることが多いため、startup_timeout_sec = 60 を設定します。
Gemini CLI
拡張機能をインストールします(キーの入力を求められ、システムのキーチェーンに保存されます)。
gemini extensions install https://github.com/RealSatanyan/mnogoreels-mcp
または、ホスト型サーバーを ~/.gemini/settings.json に追加します。
{
"mcpServers": {
"mnogoreels": {
"httpUrl": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer $MNOGOREELS_API_KEY" }
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"mnogoreels": {
"serverUrl": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
}
}
}
Zed
settings.json のホスト型設定:
{
"context_servers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
}
}
}
ローカル:
{
"context_servers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
Cline
これらのブロックのいずれか1つだけを cline_mcp_settings.json に追加します。ローカル:
{
"mcpServers": {
"mnogoreels": {
"command": "npx",
"args": ["-y", "mnogoreels-mcp@latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" },
"disabled": false,
"autoApprove": []
}
}
}
ホスト型:
{
"mcpServers": {
"mnogoreels": {
"type": "streamableHttp",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" },
"disabled": false,
"autoApprove": []
}
}
}
リモートエントリの type は必ず指定してください。指定しない場合、Cline はそのエントリをレガシー SSE として扱いますが、このサーバーは SSE を提供していません。Cline では llms-install.md を使って、サーバーを自動で設定することもできます。
Goose
次のリンクのいずれかをブラウザーのアドレスバーに貼り付けます(GitHub では goose:// リンクはクリック可能なリンクとして表示されません)。ローカルの場合、Goose がキーの入力を求めます。
goose://extension?name=MnogoReels&cmd=npx&arg=-y&arg=mnogoreels-mcp%40latest&env=MNOGOREELS_API_KEY%3DMnogoReels%20API%20key%20(mrfrt_usr_...)&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles
ホスト型の場合は、開く前に mrfrt_usr_YOUR_KEY を置き換えます。
goose://extension?name=MnogoReels&url=https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp&header=Authorization%3DBearer%20mrfrt_usr_YOUR_KEY&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles
または、goose configure → Add Extension → Command-line Extension の順に選択し、コマンド npx -y mnogoreels-mcp@latest と変数 MNOGOREELS_API_KEY を指定します。config.yaml の例は examples/goose-config.yaml にあります。
Kiro
上のボタンを使うか、~/.kiro/settings/mcp.json(またはプロジェクト内の .kiro/settings/mcp.json)に追加します。
{
"mcpServers": {
"mnogoreels": {
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": { "Authorization": "Bearer ${MNOGOREELS_API_KEY}" }
}
}
}
JetBrains AI Assistant, Warp, Amazon Q, LM Studio
これらのクライアントは汎用の mcpServers JSON に対応しています。MCP 設定にホスト型またはローカルのブロックを貼り付けます(JetBrains:Settings → Tools → AI Assistant → Model Context Protocol、Warp:Settings → AI → MCP servers、Amazon Q:~/.aws/amazonq/mcp.json、LM Studio:mcp.json)。クライアントがヘッダー付きのリモートサーバーに対応していない場合は、ローカルのブロックを使用してください。
Continue
.continue/mcpServers/mnogoreels.yaml として保存し、Continue でシークレット MNOGOREELS_API_KEY を追加します。
name: MnogoReels
version: 1.0.0
schema: v1
mcpServers:
- name: MnogoReels
type: streamable-http
url: https://mcp.mnogo-reels.ru/mcp
requestOptions:
headers:
Authorization: 'Bearer ${{ secrets.MNOGOREELS_API_KEY }}'
n8n
AI Agent に MCP Client Tool ノードを追加します。
- Server Transport:HTTP Streamable
- Endpoint:
https://mcp.mnogo-reels.ru/mcp - Authentication:名前を
Authorization、値をBearer mrfrt_usr_YOUR_KEYとする Header Auth
詳細は examples/n8n.md を参照してください。
Yandex AI Studio (MCP Hub)
AI Studio → MCP Hub → «Внешний MCP-сервер»(外部 MCP サーバー):
- Name:
mnogoreels - URL:
https://mcp.mnogo-reels.ru/mcp - Transport:Streamable HTTP
- Header:
Authorization: Bearer mrfrt_usr_YOUR_KEY
詳細は examples/yandex-ai-studio.md を参照してください。
Cloud.ru Evolution AI Agents
AI Agents → MCP servers → URL でサーバーを追加し、https://mcp.mnogo-reels.ru/mcp を指定します。ヘッダーには Authorization: Bearer mrfrt_usr_YOUR_KEY を設定します。
GigaChain / LangChain (Python)
langchain-mcp-adapters を使用します。
import os
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient(
{
"mnogoreels": {
"transport": "streamable_http",
"url": "https://mcp.mnogo-reels.ru/mcp",
"headers": {"Authorization": "Bearer " + os.environ["MNOGOREELS_API_KEY"]},
}
}
)
tools = await client.get_tools()
tools を GigaChat エージェントに渡します。実行可能なスクリプトは examples/gigachain.py にあります。
Docker
イメージはデフォルトでローカル(stdio)サーバーを実行します。
docker run -i --rm -e MNOGOREELS_API_KEY ghcr.io/realsatanyan/mnogoreels-mcp:latest
MCP クライアントのエントリとして使用する場合:
{
"mcpServers": {
"mnogoreels": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "MNOGOREELS_API_KEY", "ghcr.io/realsatanyan/mnogoreels-mcp:latest"],
"env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
}
}
}
たとえば、アシスタントに自然な言葉で次のように依頼できます。
- 「https://www.youtube.com/watch?v=… から、ロシア語の字幕付きで hormozi スタイルのショート動画を作成してください。まず料金を教えてください。」
- 「このポッドキャストの最初の30分を切り抜くには、クレジットがいくつ必要ですか? 2時間の動画です。」
- 「この RuTube 動画を書き起こして、SRT 字幕を作成してください。」
- 「前回のクリップ作成ジョブをもとに、チャプター付きのブログ記事を書いてください。」
- 「最近のクリップ作成ジョブと、それぞれの評価スコアおよびリンク付きで、最も優れたクリップを3つ表示してください。」
ツール
| ツール | タイトル | 読み取り専用 | クレジットを消費 | 説明 |
|---|---|---|---|---|
get_account | API キーと設定を確認 | はい | いいえ | 設定済みの MnogoReels API キーが機能するか確認し、このサーバーの設定を表示します。 |
get_options_guide | クリップのオプションを説明 | はい | いいえ | create_clip_job と recut_clip_job で指定できるオプション値(動画モード、クリップの長さ、字幕スタイル、フックスタイル、ストーリー展開のスタイル、アウトロ、フレーミングと言語)に加え、料金ルールとジョブごとの30分の上限について説明します。 |
check_video_source | 動画ソースを確認 | はい | いいえ | MnogoReels が動画リンクをダウンロードできるか確認し、タイトル、長さ、プラットフォームを返します。 |
quote_clip_job | クリップジョブの費用を見積もり | はい | いいえ | クレジットを消費せずに create_clip_job または recut_clip_job の費用を計算し、MnogoReels が動画をダウンロードできるか確認します。 |
create_clip_job | クリップジョブを作成(クレジットを消費) | いいえ | はい | 長尺動画から、字幕とフックタイトルを焼き込んだ縦型9:16のショートクリップをAIで作成します。オプションでコールドオープンのフック、音楽、Bロールも追加できます。 |
get_clip_job | クリップジョブのステータスとクリップを取得 | はい | いいえ | create_clip_job、recut_clip_job、または MnogoReels のウェブサイトで作成されたクリップジョブのステータス、進捗状況、結果を返します。 |
list_clip_jobs | クリップジョブを一覧表示 | はい | いいえ | ユーザーのクリップジョブを新しい順に一覧表示します。MnogoReels のウェブサイトで開始されたジョブも含みます。 |
recut_clip_job | クリップジョブを再編集(クレジットを消費) | いいえ | はい | 既存のジョブと同じソース動画から、字幕スタイル、フックスタイル、クリップの長さ、言語、フレーミング、音楽、Bロール、プロンプトなどの設定を変えて、新しいクリップジョブを作成します。 |
retry_clip_job | 失敗したクリップジョブを再試行(無料) | いいえ | いいえ | 同じ設定を使って失敗したクリップジョブを無料で再実行し、同じ job_id を維持します。 |
create_transcription | 動画または音声を文字起こし | いいえ | いいえ | 動画または音声のリンクから、タイムスタンプ付きの音声文字起こしを開始します。 |
get_transcription | 文字起こしを取得 | はい | いいえ | create_transcription で開始した文字起こしのステータスとテキストを返します。 |
create_article | クリップジョブから記事を作成 | いいえ | いいえ | 完了したクリップジョブのソース動画から、長文記事を作成します。記事にはタイトル、SEO タイトルと説明、要約、セクション、主なポイント、タイムスタンプ付きチャプター、動画からの最大4枚のフレーム画像、タイムスタンプ付きの全文文字起こしが含まれます。 |
get_article | 記事を取得 | はい | いいえ | create_article で作成された記事を、ステータスとともに Markdown 形式で返します。 |
search_broll | Bロールライブラリを検索 | はい | いいえ | Bロールの動画と画像を検索します。 |
get_broll_asset | Bロール素材を取得 | はい | いいえ | asset_id で指定されたBロール素材を、新しいリンクとともに返します。 |
list_packs | 公開パックを一覧表示 | はい | いいえ | ユーザーの公開パックを新しい順に一覧表示します。 |
get_pack | 公開パックを取得 | はい | いいえ | 1つの公開パックを返します。内容は、提案タイトル、説明、カバーテキストとハッシュタグ、サムネイル画像、ティーザー動画、記事 ID、クリップジョブ ID です。 |
create_youtube_thumbnails | YouTube サムネイルを作成 | いいえ | いいえ | 動画のフレームとオプションのタイトルおよびアートディレクションを使って、AI による YouTube サムネイル画像を1~4枚生成します(1280×720 JPEG)。 |
get_youtube_thumbnails | YouTube サムネイルを取得 | はい | いいえ | create_youtube_thumbnails で開始したサムネイルジョブのステータスと画像を返します。 |
各ツールは、タイトル、4つすべての MCP アノテーション(readOnlyHint、destructiveHint、idempotentHint、openWorldHint)、出力スキーマを宣言します。クレジットを消費する2つのツールには destructiveHint: true が設定されているため、リスクのある操作の前に確認を求めるクライアント(Claude や Codex など)は、呼び出しのたびに確認を促します。
ツールの選び方
| したいこと… | ツール |
|---|---|
| リンクが有効かどうか、動画の長さを確認する | check_video_source |
| クリップを作成する前に料金を確認する | quote_clip_job |
| クリップを作成する | create_clip_job(見積もり後、承認を得てから) |
| 進捗を確認してクリップを取得する | get_clip_job |
| 以前のジョブ(ウェブサイトで作成したものも含む)を検索する | list_clip_jobs |
| 完了したジョブから、別の見せ方や別の場面のクリップを作成する | recut_clip_job(有料、新しいジョブ) |
| 失敗したジョブを再実行する | retry_clip_job(無料) |
| 文字起こしやSRT字幕を取得する | create_transcription → get_transcription |
| ブログ記事、番組のショーノート、チャプターを取得する | create_article → get_article(完了済みのクリップジョブが必要です) |
| Bロール映像を検索する | search_broll → get_broll_asset |
| ウェブサイトで作成した公開用パックを読む | list_packs → get_pack |
| YouTubeのサムネイルを作成する | create_youtube_thumbnails → get_youtube_thumbnails |
| APIキーとサーバー設定を確認する | get_account |
| 字幕のスタイル、モード、その他のオプションを確認する | get_options_guide |
ジョブはバックグラウンドで実行されます
各 create_* ツールは、すぐにIDを返します。対応する get_* ツールは、最大 wait_sec 秒(デフォルトは30秒、最大50秒)まで呼び出し内で待機し、その間、進捗通知を送信します。そのため、アシスタントはステータスが completed または failed になるまで、同じツールを再度呼び出すだけです。短い動画は数分で完了しますが、30分全体の範囲では数十分かかることがあります。クリップジョブの処理中、get_clip_job が返すのは準備できたクリップの数のみです(早めにクリップを確認するには include_partial_clips=true を設定してください)。
支出に関するルール
- 料金: 処理対象範囲の開始分ごとに1クレジット(
end_sec − start_sec)、最低1クレジットです。ジョブの作成時に課金されます。例:45秒 → 1クレジット、10分 → 10クレジット、29分30秒 → 30クレジット。API経由では、字幕、フック、Bロール、音楽、エージェントモードによって料金は変わりません。 - 無料: チェック、見積もり、文字起こし、記事、YouTubeサムネイル、失敗したジョブの再試行、結果の取得。
- まず見積もりを取得:
quote_clip_jobは無料で、バックエンドと同じ計算式を使用します。アシスタントは料金を提示し、承認を待つ必要があります。 max_creditsはcreate_clip_jobとrecut_clip_jobで必須です。 料金が上限を超える場合、課金せずに呼び出しを拒否します。オペレーターはMNOGOREELS_MAX_CREDITS_PER_CALLまたはX-MnogoReels-Max-Credits-Per-Callヘッダーを使って上限を設定することもできます。この上限をモデルが引き上げることはできません。- 1ジョブあたり最大30分です。 MnogoReelsは1ジョブあたり最大30分まで処理するため、それより長い範囲は課金前に拒否されます。長い動画は
start_sec/end_sec(0–1800、1800–3600、…)を使って分割してください。 - 重複防止: 10分以内に同じキーで同一のリクエストを送ると、再度課金する代わりに、すでに作成されたジョブが返されます(
allow_duplicate: trueを設定すると無効になります)。重複防止機能は単一のサーバープロセス内で動作し、別々のプロセス間では共有されません。 - キャンセル不可、返金の自動処理なし。 ジョブの作成時にクレジットが課金され、ジョブをキャンセルすることはできません。処理に失敗しても、クレジットは自動的には返金されません。
retry_clip_jobで失敗したジョブを無料で再実行するか、job_idを添えて [email protected] までお問い合わせください。 - 確認ダイアログ。 クライアントがMCPフォームによる入力をサポートしている場合、課金前にサーバーが正確な金額の確認も求めます。
| サーバーの実行場所 | 支出前の確認ダイアログ |
|---|---|
ローカルサーバー(stdio、npx、.mcpb、Docker)、フォームによる入力に対応する任意のクライアント | あり |
| ホステッドサーバー、フォームによる入力に対応するMCP 2026-07-28のクライアント | あり |
| ホステッドサーバー、2025年頃のクライアント(現在の大半のクライアント) | なし:max_credits、オペレーターによる上限、30分の制限、重複防止機能、クライアント独自の承認プロンプトが制限として機能します |
| 入力支援に対応していないクライアント | なし:上記と同じ制限が適用されます |
プロンプトとリソース
プロンプト(クライアントに表示されるスラッシュコマンド):
| プロンプト | 機能 |
|---|---|
clip_video | 1つのリンクからクリップを見積もり、確認し、作成して、完了を待ちます(url、任意で language、caption_style、clip_length) |
podcast_to_shorts | 長いポッドキャストを30分ごとのパートに分割し、それぞれを見積もり、Shortsシリーズを作成して、投稿順を提案します(url、任意で language) |
video_to_blog_post | 完了したクリップジョブを、記事とチャプター一覧に変換します(clip_job_id) |
transcribe_video | リンクをテキストまたはSRTとして文字起こしします(url、任意で language、format) |
review_recent_clips | 最新のジョブを確認し、費用をかけずに再編集の設定を提案します(任意で count) |
リソース:
| URI | 内容 |
|---|---|
mnogoreels://guide/options | すべてのオプション値とその説明 |
mnogoreels://guide/pricing | 料金、30分の制限、無料で利用できる操作の一覧 |
mnogoreels://guide/workflow | ツールの使い方(サーバーの指示と同じ内容) |
mnogoreels://clip-jobs/{job_id} | 1つのジョブのステータスとクリップ(JSON。最新の20件のジョブを一覧表示) |
mnogoreels://transcriptions/{transcription_id} | 文字起こしの最初のページ |
mnogoreels://articles/{article_id} | 記事の最初のページ(Markdown形式) |
プロンプトとジョブリソースは、それらが使用するツールが有効な場合にのみ表示されます(たとえば、/mcp/readonly で利用できるのは review_recent_clips のみです)。多くのクライアントではリソースが表示されないため、すべての機能はツールからも利用できます。
設定
環境変数(ローカルサーバーおよびセルフホスト)
| 変数 | デフォルト値 | 説明 |
|---|---|---|
MNOGOREELS_API_KEY | none | APIキー(mrfrt_usr_…)です。サーバーの起動やツールの一覧表示には必要ありません。HTTPモードでは無視されます。このモードでは、各呼び出し元がそれぞれのキーを送信します。 |
MNOGOREELS_API_URL | https://api.mnogo-reels.ru | APIのベースURLです。デフォルトのままにしてください。 |
MNOGOREELS_PROFILE | default | default、readonly、または directory(プロファイルを参照)です。 |
MNOGOREELS_TOOLSETS | all | clips、transcripts、articles、library、thumbnails(または all)をカンマ区切りで指定します。account は常に有効です。 |
MNOGOREELS_READ_ONLY | false | true にすると、ジョブの作成やクレジットの消費を伴うすべてのツールが非表示になります。 |
MNOGOREELS_MAX_CREDITS_PER_CALL | unset | 有料呼び出しごとのクレジット上限です。モデルから変更することはできません。 |
MNOGOREELS_MAX_WINDOW_SEC | 1800 | 有料ジョブごとの最長範囲を秒単位で指定します。MnogoReelsの処理仕様に合うデフォルト値のままにしてください。 |
MNOGOREELS_MEDIA_URLS | direct | both にすると、MnogoReelsウェブサイトのプロキシ経由の stream_url リンクも返します。MnogoReelsがAPI利用向けのプロキシを発表するまでは direct のままにしてください。 |
MNOGOREELS_DEBUG | false | ローカルサーバーのみ:完全なエラーメッセージをstderrに記録します。 |
MNOGOREELS_TRANSPORT | stdio | http にすると、Streamable HTTPサーバーを起動します(--http と同じです)。 |
MNOGOREELS_HOST / MNOGOREELS_PORT | 127.0.0.1 / 8080 | HTTPのバインドアドレスです。 |
MNOGOREELS_PUBLIC_URL | https://mcp.mnogo-reels.ru/mcp | サーバーカードに表示される公開URLです。 |
MNOGOREELS_ALLOWED_HOSTS | localhost,127.0.0.1,[::1] | 許可する Host ヘッダーです(DNSリバインディング対策)。 |
MNOGOREELS_ALLOWED_ORIGINS | localhost,127.0.0.1,[::1] | 許可するブラウザーの Origin ホスト名です。公開ベアラートークンでデプロイする場合は * を指定します。 |
MNOGOREELS_TRUSTED_PROXIES | empty | X-Forwarded-For を信頼するリバースプロキシのCIDRです。 |
ブール値には 1/true/yes/on と 0/false/no/off を指定できます。無効な値を指定すると、該当する変数名を示すメッセージとともにサーバーが停止します(終了コード2)。コマンドライン:mnogoreels-mcp [--http] [--help] [--version]
ホステッドサーバー:パスとヘッダー
| パス | プロファイル |
|---|---|
/mcp | default |
/mcp/readonly | readonly |
/mcp/directory | directory |
| ヘッダー | 効果 |
|---|---|
Authorization: Bearer <key> | API キーです(推奨)。 |
X-API-Key: <key> | Authorization を利用できない場合の API キーです。 |
X-MnogoReels-Toolsets: clips,transcripts | これらのツールセットのみを表示します(account は常に含まれます)。 |
X-MnogoReels-Read-Only: true | ジョブの作成やクレジットの消費を行うツールを非表示にします。false を指定しても、読み取り専用パスの制限は緩和されません。 |
X-MnogoReels-Max-Credits-Per-Call: 30 | 有料呼び出しごとのクレジット上限です。 |
ヘッダーによって、パスで許可されている範囲をさらに狭めることはできますが、広げることはできません。キーがなくても、検出と一覧表示は利用できます。キーが必要なツールをキーなしで呼び出すと、HTTP 401 が返されます。
プロファイル
| プロファイル | ツール | 変更点 |
|---|---|---|
default | 19 | すべて利用できます。 |
readonly | 13 | ジョブの作成やクレジットの消費を行うツールはありません。読み取り、チェック、見積もりは引き続き利用できます。 |
directory | 17 | YouTube のサムネイルツール、AI 画像またはモーショングラフィックスの B-roll オプション、「クレジットを購入」リンクはありません。公開ディレクトリの掲載に使用されます。 |
HTTP サーバーのセルフホスト
npx -y mnogoreels-mcp@latest --http または docker run -p 8080:8080 -e MNOGOREELS_TRANSPORT=http ghcr.io/realsatanyan/mnogoreels-mcp:latest を実行すると、mcp.mnogo-reels.ru で稼働しているサーバーと同じサーバーが起動します(ヘルスチェック:GET /healthz、サーバーカード:GET /.well-known/mcp/server-card.json)。MNOGOREELS_ALLOWED_HOSTS にドメインを設定してください。本番環境のセットアップについては、docs/deploy-coolify.md を参照してください。
セキュリティ
- 信頼できないコンテンツ。 動画に由来するタイトル、文字起こし、記事などのテキストは
<untrusted_source_text>タグで囲まれます。また、サーバーの指示により、モデルはこれを指示ではなくデータとして扱います。 - キーの管理。 キーは
AuthorizationまたはX-API-Keyヘッダーでのみ送信されます(ホステッドサーバーは URL 内のキーを拒否します)。キーがログに記録されることはなく、get_accountに表示されるのは末尾の 4 文字のみです。クライアントごとに専用キーを使用し、使わなくなったキーは取り消してください。サービスキー(mrfrt_svc_…)は拒否されます。 - 読み取り専用モード。
MNOGOREELS_READ_ONLY=true、/mcp/readonlyパス、または Claude Desktop バンドルの読み取り専用スイッチを使用すると、ジョブの作成やクレジットの消費が可能なすべてのツールが削除されます。 - 公式ソースのみ。 サーバーは npm パッケージ
mnogoreels-mcp、イメージghcr.io/realsatanyan/mnogoreels-mcp、ホステッドエンドポイントhttps://mcp.mnogo-reels.ru、およびこのリポジトリでのみ公開されています。類似品にはキーを渡さないでください。 - バージョンの固定。
mnogoreels-mcp@latestは自動的に更新されます。自動更新を避けるには、たとえばnpx -y [email protected]のようにバージョンを固定してください。
脆弱性は非公開で報告してください。SECURITY.md を参照してください。
プライバシー
ローカルサーバーは、ツールの引数とキーを api.mnogo-reels.ru にのみ送信します。ホステッドサーバーはそれらを mcp.mnogo-reels.ru で受信し、同じ API に転送します。キーはリクエストの処理中のみメモリに保持され、キー、ツールの引数、結果がログに記録されることはありません(ユーザーを区別するため、キーの短いハッシュプレフィックスのみ記録されます)。テレメトリは収集されません。詳細は、PRIVACY.md、MnogoReels のプライバシーポリシー、および利用規約を参照してください。
トラブルシューティング
ツールのエラーは Error [<code>]: で始まり、その後に対処方法が表示されます。特によくあるものは次のとおりです。
| コード | 対処方法 |
|---|---|
missing_api_key、invalid_api_key_format、invalid_api_key(ホスト型サーバーで HTTP 401) | Developers → API keys でキーを作成し、クライアント設定を更新します。キーは mrfrt_usr_ で始まります。get_account を実行して確認してください。 |
insufficient_credits(402) | mnogo-reels.ru でクレジットをチャージするか、プランを購入してください。 |
duration_unknown | プラットフォームから動画の長さが報告されていません(直接ファイルへのリンクでよく発生します)。end_sec(長さを秒数で指定するか、処理する部分の終了位置)を渡してください。 |
30 分に言及する invalid_arguments | 1 つのジョブで処理できるのは最大 30 分です。start_sec/end_sec を使って動画を分割し、複数のジョブを実行してください。 |
source_not_downloadable | 動画が非公開、削除済み、地域制限付き、音声のみ、または 17 GB を超えています。料金は発生していません。別のリンクをお試しください。 |
rate_limited、rate_limited_local | リクエストが多すぎます。メッセージに記載された秒数だけ待ってください。 |
upstream_timeout | MnogoReels から時間内に応答がありませんでした。もう一度お試しください。ソースを確認する場合は、start_sec/end_sec を手動で渡すこともできます。 |
outcome_unknown、billing_uncertain | サーバーで有料ジョブが作成されたかどうかを確認できませんでした。再試行する前に list_clip_jobs を確認してください。ジョブがないのにクレジットが差し引かれていた場合は、[email protected] までお問い合わせください。10 分以内に同じ内容を再試行すると、何も送信せず同じ応答が返されます。 |
| Codex:ツールがタイムアウトする、またはサーバーが起動しない | config.toml で startup_timeout_sec = 60 と tool_timeout_sec = 120 を設定してください。 |
| ロシアでダウンロードが遅い、または失敗する | ロシアの一部の家庭用回線では、API とメディアのホストへの接続が制限されています。家庭用回線ではホスト型サーバーを優先してください。MNOGOREELS_MEDIA_URLS=both を設定すると、MnogoReels が API 用プロキシを有効にした後、プロキシ経由の stream_url リンクが追加されます。 |
解決しない場合は、issue を作成する(先にログと設定ファイルからキーを削除してください)か、[email protected] までご連絡ください。
制限事項(v1)
- ローカルファイルには対応していません。動画は公開リンクからアクセスできる必要があります(先に公開されている場所へアップロードしてください)。
- クレジット残高は確認できません。API では公開されていないため、mnogo-reels.ru で確認してください。
- ソーシャルネットワークへの公開や予約投稿には対応していません。
- ジョブのキャンセルには対応していません。
- 公開用パックは読み取れますが、作成できません。記事画像の生成に失敗した場合、再試行できません。
開発
必要条件:Node.js 22 以降。コードは TypeScript(strict)で記述され、tsc でビルドし、Vitest と Stryker でテストします。テストファーストで開発されています。
npm ci --ignore-scripts
npm run typecheck && npm run lint && npm test
npm run build
npm run test:integration
npm run smoke # MCP Inspector CLI smoke test
npm run version:check # manifests in sync with package.json
npm run metadata:check # README tool tables, MCPB tools, Docker tools.json up to date
ワークフローについては CONTRIBUTING.md、リリースについては docs/release.md を参照してください。変更内容は CHANGELOG.md に記載されています。参加者全員に Code of Conduct の遵守をお願いしています。
ライセンス
MIT © 2026 MnogoReels
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。