mcpField
M
MnogoReels

MnogoReels

リモート
github.comメディア・デザイン01 週間前に更新
リポジトリ公式サイト

MnogoReels について

MnogoReelsは、長尺動画から縦型ショート動画、文字起こし、記事を作成するMCPサーバーです。クリエイターはMCPクライアントから対応する動画リンクを渡し、自分のMnogoReelsアカウントで処理できます。

主な機能

  1. 01長尺動画から9:16の縦型クリップを作成
  2. 02見どころを選びフックタイトルを追加
  3. 03クリップに字幕を焼き込み
  4. 04文字起こしと記事を生成
  5. 05複数プラットフォームの動画リンクに対応

活用シーン

  1. 01長時間の録画から短尺動画を作成
  2. 02動画から文字起こしと記事を作成
  3. 03オンライン動画から字幕付きReelsやShortsを作成

MCP 対応

MCPクライアントにMnogoReelsの動画処理機能を提供します。ホスト型Streamable HTTPサーバーまたはローカルstdioサーバーとして接続でき、読み取り専用のホスト型エンドポイントにはジョブ作成ツールがありません。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://mcp.mnogo-reels.ru/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

すべてのエンドポイント
Streamable HTTPhttps://mcp.mnogo-reels.ru/mcp認証が必要
Streamable HTTPhttps://mcp.mnogo-reels.ru/mcp/readonly認証が必要
パッケージ
npmmnogoreels-mcp1.0.0
ocighcr.io/realsatanyan/mnogoreels-mcp:1.0.0
mcpbmnogoreels-mcp-1.0.0.mcpb1.0.0

ツール

19

このツールにパラメーターはありません。

詳細

English | Русский

MnogoReels MCP サーバー

MnogoReels MCP サーバー:あらゆる MCP クライアントから、長尺動画を字幕付きの縦型ショート動画/リール、文字起こし、記事に変換できます。YouTube、VK Video、RuTube、Dzen、Twitch、Yandex Disk、Google Drive、または動画への直接リンクを AI アシスタントに渡すと、最適な場面を選び、9:16 にリフレームし、字幕とフックとなるタイトルを焼き込み、完成したクリップへのリンクを返します。処理には、ご自身の MnogoReels アカウントを使用します。

npm version npm downloads CI License: MIT MCP 2026-07-28 MCP Registry Glama score Smithery Docker image

ワンクリックインストール

クライアントホスト型サーバー(インストール不要)ローカルサーバー(Node.js 22+、npx)
CursorInstall in CursorInstall in Cursor
VS CodeInstall in VS CodeInstall in VS Code
VS Code InsidersInstall in VS Code InsidersInstall in VS Code Insiders
KiroAdd to KiroAdd to Kiro
Claude DesktopAPI キーでは利用できません(下記を参照)Download for Claude Desktop
SmitherySmithery
Cursor と Kiro のボタンでは、環境変数に MNOGOREELS_API_KEY が設定されている必要があります。設定してエディターを再起動するか、エディターで開く設定ファイル内の ${env:…} をキーに置き換えてください。VS Code のボタンではキーの入力を求められます。
アプリへの直接リンク(ボタンでエディターが開かない場合)

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 キーを取得する

  1. mnogo-reels.ru でサインインするか、登録します。
  2. Developers → API keys を開いてキーを作成します。キーは mrfrt_usr_ で始まります。
  3. 以下の説明に従って、クライアントの設定にキーを追加します(ローカルサーバーでは 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_accountAPI キーと設定を確認はいいいえ設定済みの 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_brollBロールライブラリを検索はいいいえBロールの動画と画像を検索します。
get_broll_assetBロール素材を取得はいいいえasset_id で指定されたBロール素材を、新しいリンクとともに返します。
list_packs公開パックを一覧表示はいいいえユーザーの公開パックを新しい順に一覧表示します。
get_pack公開パックを取得はいいいえ1つの公開パックを返します。内容は、提案タイトル、説明、カバーテキストとハッシュタグ、サムネイル画像、ティーザー動画、記事 ID、クリップジョブ ID です。
create_youtube_thumbnailsYouTube サムネイルを作成いいえいいえ動画のフレームとオプションのタイトルおよびアートディレクションを使って、AI による YouTube サムネイル画像を1~4枚生成します(1280×720 JPEG)。
get_youtube_thumbnailsYouTube サムネイルを取得はいいいえ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_video1つのリンクからクリップを見積もり、確認し、作成して、完了を待ちます(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_KEYnoneAPIキー(mrfrt_usr_…)です。サーバーの起動やツールの一覧表示には必要ありません。HTTPモードでは無視されます。このモードでは、各呼び出し元がそれぞれのキーを送信します。
MNOGOREELS_API_URLhttps://api.mnogo-reels.ruAPIのベースURLです。デフォルトのままにしてください。
MNOGOREELS_PROFILEdefaultdefault、readonly、または directory(プロファイルを参照)です。
MNOGOREELS_TOOLSETSallclips、transcripts、articles、library、thumbnails(または all)をカンマ区切りで指定します。account は常に有効です。
MNOGOREELS_READ_ONLYfalsetrue にすると、ジョブの作成やクレジットの消費を伴うすべてのツールが非表示になります。
MNOGOREELS_MAX_CREDITS_PER_CALLunset有料呼び出しごとのクレジット上限です。モデルから変更することはできません。
MNOGOREELS_MAX_WINDOW_SEC1800有料ジョブごとの最長範囲を秒単位で指定します。MnogoReelsの処理仕様に合うデフォルト値のままにしてください。
MNOGOREELS_MEDIA_URLSdirectboth にすると、MnogoReelsウェブサイトのプロキシ経由の stream_url リンクも返します。MnogoReelsがAPI利用向けのプロキシを発表するまでは direct のままにしてください。
MNOGOREELS_DEBUGfalseローカルサーバーのみ:完全なエラーメッセージをstderrに記録します。
MNOGOREELS_TRANSPORTstdiohttp にすると、Streamable HTTPサーバーを起動します(--http と同じです)。
MNOGOREELS_HOST / MNOGOREELS_PORT127.0.0.1 / 8080HTTPのバインドアドレスです。
MNOGOREELS_PUBLIC_URLhttps://mcp.mnogo-reels.ru/mcpサーバーカードに表示される公開URLです。
MNOGOREELS_ALLOWED_HOSTSlocalhost,127.0.0.1,[::1]許可する Host ヘッダーです(DNSリバインディング対策)。
MNOGOREELS_ALLOWED_ORIGINSlocalhost,127.0.0.1,[::1]許可するブラウザーの Origin ホスト名です。公開ベアラートークンでデプロイする場合は * を指定します。
MNOGOREELS_TRUSTED_PROXIESemptyX-Forwarded-For を信頼するリバースプロキシのCIDRです。

ブール値には 1/true/yes/on と 0/false/no/off を指定できます。無効な値を指定すると、該当する変数名を示すメッセージとともにサーバーが停止します(終了コード2)。コマンドライン:mnogoreels-mcp [--http] [--help] [--version]

ホステッドサーバー:パスとヘッダー
パスプロファイル
/mcpdefault
/mcp/readonlyreadonly
/mcp/directorydirectory
ヘッダー効果
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 が返されます。

プロファイル
プロファイルツール変更点
default19すべて利用できます。
readonly13ジョブの作成やクレジットの消費を行うツールはありません。読み取り、チェック、見積もりは引き続き利用できます。
directory17YouTube のサムネイルツール、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_arguments1 つのジョブで処理できるのは最大 30 分です。start_sec/end_sec を使って動画を分割し、複数のジョブを実行してください。
source_not_downloadable動画が非公開、削除済み、地域制限付き、音声のみ、または 17 GB を超えています。料金は発生していません。別のリンクをお試しください。
rate_limited、rate_limited_localリクエストが多すぎます。メッセージに記載された秒数だけ待ってください。
upstream_timeoutMnogoReels から時間内に応答がありませんでした。もう一度お試しください。ソースを確認する場合は、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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。