VlogMe / 開発者向け
AIエージェント向けVlogMe MCPサーバー
Claude Code、Cursor、VS Code、Gemini CLI、Codex、n8nから、VlogMeのアカウントで動画、話す写真、アバター、音声、編集を作成できます。エージェントはアプリと同じツールと料金を使い、クレジットを使う前に見積もり額をあなたに示します。
このページの内容
エージェントにできること
https://vlogme.ai/mcpのMCPサーバーは、VlogMeアプリと同じ作業を、あなたのアカウント、クレジット残高、LabのままAIエージェントに任せられるようにします。
- アイデアから完成した動画。 Directorがシーンを計画し、セリフを書き、画像、音声、音楽を準備して、字幕付きの動画を書き出します。
- 単体のクリップと画像。 テキストから動画、画像から動画のモデル、話す写真、アバター、リップシンク、高画質化、画像生成。カタログには各モデルの制限と料金が載っています。
- 音声とサウンド。 ナレーション、声の変換、音楽、効果音、文字起こしと字幕、他言語への吹き替え。
- 自分の映像の編集(Aisma)と、選んだ記事からのニュース動画。
- ファイル。 手元のファイルのアップロード、公開リンクからのインポート、Labのファイルの一覧と名前の変更、結果のダウンロードリンク。
結果はすべてLabに保存され、アプリで開けます。ツールは全部で59あり、REST APIリファレンスに、それぞれが必要とするキーの権限と一緒に載っています。
クレジットがかかるもの、かからないもの
クレジットがかかるのは、開始したジョブ(レンダリングやその他の生成)だけです。
料金がかからないもの:接続、ツールの一覧、ジョブのカタログ、見積もり、ファイルとジョブの閲覧、Directorの計画、チャット、無料の準備。計画と準備は、アプリでアカウントに付いている無料枠を共有します。一時的に使い切ると、エージェントへの応答にlimited: trueが入ります。
クレジット:書き出し(レンダリング)です。アプリと同じです。エージェントは、サイトで支払う額とまったく同じ額を、同じ残高から支払います。
- エージェントが見積もりを取ります。料金はかかりません。
- クレジット額をあなたに示し、了承を待ちます。
- その見積もりでジョブを開始します。別の料金で実行されることはありません。料金や入力が変わっていれば開始は拒否され、料金はかかりません。
失敗したジョブには料金がかかりません。クレジットはサイトのAccountで購入します。キーでは購入できません。残高が足りないときは、その旨とクレジットを追加するページへのリンクを含む拒否がエージェントに返ります。パックとプランは料金をご覧ください。
MCPクライアントの接続
キーなしでサインイン。 MCPのサインインに対応したクライアント(Claude Code、claude.aiとChatGPTのコネクタ、Cursor、VS Code)では、URL https://vlogme.ai/mcp だけで接続できます。クライアントがブラウザでVlogMeを開くので、サインインし、エージェントに許可する操作を選んでAllowを押します。アプリはAccount → API & MCP → Connected appsに表示され、いつでも接続を解除できます。
または、APIキーを使います(スクリプト、n8n、サインイン非対応のクライアント)。
- Account → API & MCPでキーを作成します(管理画面は現在英語のみです)。キーは一度だけ表示されるので、すぐにコピーしてください。
vma_で始まります。 - 共有するファイルに入らないよう、環境変数に保存します。
export VLOGME_API_KEY="vma_…"
- 次の値でクライアントにサーバーを追加します。
| 設定 | 値 |
|---|---|
| URL | https://vlogme.ai/mcp |
| トランスポート | Streamable HTTP |
| ヘッダー | Authorization: Bearer vma_… |
クライアントごとの手順は以下のとおりです。59のツールをすべて個別の項目として読み込むには、URLに?tools=allを付けます(https://vlogme.ai/mcp?tools=all)。
ジョブのカタログ(https://vlogme.ai/api/catalog)とOpenAPIの定義(https://vlogme.ai/api/openapi.json)はキーなしで誰でも読めるため、接続する前からエージェントが作業を計画できます。
Claude Code
サインインの場合: claude mcp add --transport http vlogme https://vlogme.ai/mcp を実行し、Claude Codeで /mcp と入力して vlogme を選び、Authenticateを選択します。ブラウザでVlogMeが開いたらAllowを押します。
キーの場合: VLOGME_API_KEYを設定したターミナルで、一度だけ実行します。
claude mcp add --transport http vlogme https://vlogme.ai/mcp --header "Authorization: Bearer $VLOGME_API_KEY"
claude mcp listで確認したら、「VlogMeで、池に浮かぶ紙の船の5秒のクリップを作って。先に見積もりを見せて」と頼んでみてください。Claude Codeは、許可していないツールを呼び出す前に毎回確認します。
Cursor
~/.cursor/mcp.json(プロジェクトでは.cursor/mcp.json)にサーバーを追加します。Cursorはキーを環境変数から読みます。
{
"mcpServers": {
"vlogme": {
"url": "https://vlogme.ai/mcp",
"headers": { "Authorization": "Bearer ${env:VLOGME_API_KEY}" }
}
}
}
Cursor Settings → MCPで、サーバーとツールを確認できます。ツールが表示されない場合は、変数を設定したターミナルからCursorを起動してください。
VS Code
ワークスペースに.vscode/mcp.jsonを追加します。VS Codeは初回にキーを尋ね、安全な保存領域に保管します。
{
"inputs": [
{ "type": "promptString", "id": "vlogme-key", "description": "VlogMe API key", "password": true }
],
"servers": {
"vlogme": {
"type": "http",
"url": "https://vlogme.ai/mcp",
"headers": { "Authorization": "Bearer ${input:vlogme-key}" }
}
}
}
このファイルかMCPビューからサーバーを起動し、Chatのエージェントモードでツールを使います。
Gemini CLI
一度だけ実行します。単一引用符により、ユーザー設定にはキーそのものではなくVLOGME_API_KEYへの参照が保存されます。Gemini CLIは起動時にこの変数を読みます。
gemini mcp add --scope user --transport http vlogme https://vlogme.ai/mcp --header 'Authorization: Bearer $VLOGME_API_KEY'
または、~/.gemini/settings.jsonに自分でサーバーを追加します。
{
"mcpServers": {
"vlogme": {
"httpUrl": "https://vlogme.ai/mcp",
"headers": { "Authorization": "Bearer $VLOGME_API_KEY" }
}
}
}
Gemini CLIでは、/mcpでサーバーとツールを一覧できます。
Codex
~/.codex/config.tomlにサーバーを追加します。Codexは指定した変数のキーを送ります。
[mcp_servers.vlogme]
url = "https://vlogme.ai/mcp"
bearer_token_env_var = "VLOGME_API_KEY"
tool_timeout_sec = 120
tool_timeout_secを長めにすると、ジョブを待つツール(1回の呼び出しで最大30秒)が応答するまでの余裕ができます。
n8n
AI AgentノードのあるワークフローにMCP Client Toolを追加し、次のように設定します。
- Endpoint:
https://vlogme.ai/mcp - Server Transport:HTTP Streamable
- Authentication:Bearer Auth(キーを保存した認証情報を選択)
これでエージェントはジョブの見積もり、開始、待機ができます。有料の開始にはいつも新しい見積もりとそのフィンガープリントが必要なので、ワークフローは必ず見積もり額で支払います。毎日の動画では、ジョブを開始する前に、見積もりのクレジットをあなたが決めた上限と比べるようにしてください。
APIキーとできること
キーでできるのは、作成時にチェックした内容だけです。
- read(すべてのキー):カタログ、見積もり、ファイル、ジョブ、残高。エージェントに機能を調べさせ、料金を見積もらせるにはreadキーで十分です。
- write:ファイルのアップロードとインポート、Directorでの計画、見積もり額での有料ジョブの開始。
- delete、share、publish:ファイルやプロジェクトの削除、公開リンク、連携したSNSアカウントへの投稿。エージェントに必要でなければオフのままにしてください。
キーでは、クレジットの購入、プランの変更、別のキーの作成、アカウントの削除は決してできません。有効期間は1〜365日で、Account → API & MCPで無効にすると、そのキーを使うすべてのクライアントがすぐに停止します。キーはアカウントの権限で動くため、秘密にしてください(利用規約)。
接続済みアプリ。 サインインで接続したアプリは、Allowページでチェックした同じ一覧の権限を持ちます。アクセスは自動で更新され、Account → API & MCP → Connected appsで接続を解除するとすぐに止まります。
エージェントで最初の動画を作る
接続したら、次のような依頼を試してください。
- 「VlogMeで、ソーラーパネルのしくみを説明する30秒の動画を作って。書き出す前に計画と料金を見せて」
- 「./photo.jpgをゆっくりズームする5秒のクリップにして。先に見積もりを出して」
- 「./me.pngの私の写真に『ようこそ、私たちのお店へ』と話させて。どのモデルが合っていて、いくらかかる?」
- 「VlogMeで何が作れて、10秒の動画はいくら?」
エージェントは毎回同じ手順で進めます。カタログを読み、見積もりを取り、クレジットをあなたに示し、その見積もりと新しい冪等キーでジョブを開始し、ジョブを待って、15分間有効なダウンロードリンクを渡します。Directorの動画では、見積もりの前に計画と準備が入ります。各手順はREST APIリファレンスのMCPの章で説明しています。
よくある質問
MCPサーバーは無料ですか?接続、カタログ、見積もり、Directorの計画と準備は、アプリと同じ上限の範囲内で料金がかかりません。開始したジョブ(書き出しを含む)には、アプリと同じクレジットがかかります。
エージェントが確認なしにクレジットを使うことはありますか?有料のツールはすべて、見積もり額を示して了承を待つようエージェントに伝えます。また、許可していないツールを呼び出す前には、クライアントが毎回確認します。ジョブは見積もり額でしか開始されません。料金を一切使わずに調べさせたい場合は、readだけのキーを渡してください。
エージェント経由だとサイトより高くなりますか?いいえ。料金、残高、無料枠は同じです。
結果に透かしは入りますか?VlogMeは、作成したものに目に見える透かしを入れません。
どのクライアントで使えますか?Streamable HTTPでAuthorizationヘッダーを送れるMCPクライアントなら使えます。Claude Code、Cursor、VS Code、Gemini CLI、Codex、n8nも含まれます。claude.aiやChatGPTのコネクタのようにOAuthのサインインで接続するクライアントでは、キーは不要です。サインインしてAllowを押すだけです。
エージェントにはいくつのツールが見えますか?最大59です。すべてのツールを個別の項目として読み込むには、URLに?tools=allを付けます。付けない場合、サーバーは短い主要ツールの一覧を返すことがあり、そのときはvlogme_find_toolsとvlogme_call_toolで残りを使えます。2つの有料ツールは常に短い一覧に入っているため、クライアントは呼び出しごとに確認します。削除、共有、公開を行うツールはvlogme_call_toolでは実行されません。使うには?tools=allで接続してください。
ファイルはどこにありますか?アプリで作ったものと同じくLabにあります。ツールの応答に含まれるダウンロードリンクは15分間有効です。新しいリンクは何度でも取得できます。
リクエストが拒否されたら?ツールの応答が理由をわかりやすく伝え、拒否された呼び出しには料金がかかりません。短時間にリクエストが多すぎると、rate_limitedと待つ秒数付きで拒否されます。


