VidSeeds.ai

VidSeeds.ai MCP マーケットプレイスとコネクターカタログ

AI コーディングクライアントから VidSeeds.ai を直接操作して、動画をアップロードする前に SEO とメタデータを最適化し、複数のプラットフォームに公開できます。

VidSeeds.ai はクリエイターがすでに所有している動画を分析し、YouTube、TikTok、Instagram、Facebook、 LinkedIn、X 向けに最適化されたタイトル、説明、タグ、サムネイル、チャプターを作成して公開します。動画の生成や編集を行うものではありません。

このリポジトリは、VidSeeds.ai のワークフローを公開するホスト型 MCP コネクターの公開マーケットプレイス／カタログソースです （247 個のツール。すべて vidseeds_ がプレフィックスです）。各種クライアントが必要とする、機械可読なメタデータを提供します。

クライアント／カタログ	このリポジトリが提供するもの
Claude Code	.claude-plugin/marketplace.json、.claude-plugin/plugin.json、.mcp.json、ワークフロースキル
Codex	.agents/plugins/marketplace.json、.codex-plugin/plugin.json、codex.mcp.json、ワークフロースキル
Official MCP Registry とその下流カタログ	mcp-publisher とレジストリ互換のクローラー向けのルート server.json
ChatGPT	ソースのメタデータ／アセットと、別個の Apps SDK エンドポイント https://vidseeds.ai/api/mcp/chatgpt のドキュメント
Cursor およびその他の MCP クライアント	https://vidseeds.ai/api/mcp 用のコピー＆ペーストできる Streamable HTTP 設定

このコネクターには認証情報は含まれません。お客様が用意するトークンを使ってホスト型エンドポイントを呼び出す方法をクライアントに伝えます。

• エンドポイント： https://vidseeds.ai/api/mcp（MCP Streamable HTTP）
• 認証（このプラグイン）： Personal Access Token（Authorization: Bearer vs_pat_…）
• 認証（Claude.ai／Desktop）： 同じエンドポイントは OAuth 2.0（PKCE ＋ Dynamic Client Registration）にも対応しています。カスタムコネクターとして追加すれば、トークンは不要です。以下のアプリ内ガイドをご覧ください。
• ChatGPT App： 専用エンドポイント https://vidseeds.ai/api/mcp/chatgpt は、結果をウィジェットとして表示する OpenAI ChatGPT App（Apps SDK）を提供します。ローカル専用ツール（ffmpeg／ffprobe のレシピ、precision-trim、ローカル音声の文字起こし）は、ChatGPT にローカルシェルがないため、ここでは非表示です。これらのツールには Claude Code／Codex プラグインをお使いください。ChatGPT への配布は ChatGPT Apps の申請／ディレクトリ登録フローを通じて行います。この Git リポジトリをカスタムマーケットプレイスとして追加する方法ではありません。
• サーバー： vidseeds v1.9.2（エージェント向けの説明：クライアントの切り捨て上限に合わせたルーティング優先のサーバー指示、vidseeds_guide ツール、ワークフロープロンプト）

その他のクライアントと、コピー＆ペーストできる設定手順： アプリ内セットアップガイド https://vidseeds.ai/settings/mcp-settings では、Claude.ai と Desktop（OAuth）、 Claude Code、Cursor、Codex など、あらゆる MCP クライアントを対象に、 それぞれすぐにコピーできるスニペットを用意しています。 💳 有料コネクター - 14 日間の無料トライアル。 MCP サーバーは、有料の VidSeeds.ai サブスクライバーが利用できます。すべてのアカウントで、最初の MCP 接続時に 開始する 14 日間の無料トライアルを利用できます。これには、これまで一度も接続したことのない古いアカウントも 含まれます。トライアル終了後もコネクターを使い続けるには、有効なサブスクリプションが必要です。プランの管理は https://vidseeds.ai/pricing から行えます。

VidSeeds.ai のソースコードを編集する場合： このリポジトリで作業するのと同じコーディングエージェントのセッションで、vidseeds MCP サーバーを接続したままにしないでください。 カタログ（?toolset=core を指定した場合も）は、ユーザーの動画やチャンネルを操作するための 製品の操作画面 です。実際のコード変更に必要なコンテキストを消費します。 通常のファイルシステム／grep／編集ツールを使ってください。MCP レイヤー、新しい ツール、ルートハンドラーなどを明示的にテストする場合にのみ、MCP に接続してください（?toolset=core を推奨）。 ルートの AGENTS.md の「Context Hygiene」セクションを参照してください。

---

1. パーソナルアクセストークンを取得する（必須）

1. https://vidseeds.ai にサインインします（無料アカウント）。
2. 設定 → MCP 設定を開きます：https://vidseeds.ai/settings/mcp-settings。
3. トークンを作成し、シークレット（vs_pat_…）をコピーします。これは一度しか表示されません （デフォルトの有効期限は 90 日です）。
4. VIDSEEDS_PAT 環境変数としてクライアントに公開します（以下を参照）。

🔒 トークンの値をファイルに保存してはいけません。このパッケージはトークンを名前で 参照します（VIDSEEDS_PAT）。接続時に、クライアントが環境から値を注入します。 PAT が漏洩すると、アカウントへの管理者以外の全アクセスが可能になります。パスワードと同様に扱ってください。

ℹ️ トークンの作成は無料ですが、接続には有料サブスクリプションまたは有効な 14 日間のトライアルが必要です（上記を参照）。アクセス権とは別に、個々のツールは残高から seedsを消費します（読み取り専用ツールは無料です）。接続アクセスとツールごとの seed コストは 別々に設定され、どちらも呼び出しごとにサーバー側で適用されます。

---

2. Claude Code にインストールする

オプション A - プラグインをインストールする（推奨）

/plugin marketplace add CarrotGamesStudios/vidseeds-mcp
/plugin install vidseeds@vidseeds

次に、Claude Code の起動元の環境でトークンを使用できるようにします。

export VIDSEEDS_PAT="vs_pat_your_token_here"
claude

/mcp を実行して、vidseeds サーバーが接続され、ツールが一覧表示されることを確認します。認証エラーが表示される場合、 起動元のシェルで VIDSEEDS_PAT が設定されていません。エクスポートして再起動してください。

プラグインの .mcp.json は Bearer ${VIDSEEDS_PAT} を使ってトークンを注入します。これは Anthropic の公式 GitHub コネクターと同じ 形式です。起動前に VIDSEEDS_PAT を設定してください。設定されていない場合、Claude Code は vidseeds サーバーに 設定が必要であることを示します。

オプション B - サーバーを直接追加する（プラグインなし）

プラグインをインストールせずにすばやくテストできます。日常的な利用にはオプション A を推奨します。トークンを環境変数 （VIDSEEDS_PAT）に保持して実行時に読み込むため、解決済みのトークンを ~/.claude.json に書き込まずに済みます。

生のトークンを貼り付けるのではなく、環境変数を参照してください。これにより、シークレットがシェルの履歴やターミナルのスクロールバックに残りません。

export VIDSEEDS_PAT="vs_pat_your_token_here"
claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=core \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

---

3. Codex にインストールする

Codex はまだセルフサービスの一元的なプラグイン公開に対応していないため、最も確実な方法は サーバーを Codex の設定に追加することです。

オプション A - ~/.codex/config.toml（推奨）

[mcp_servers.vidseeds]
url = "https://vidseeds.ai/api/mcp"
bearer_token_env_var = "VIDSEEDS_PAT"

次に、Codex の実行環境でトークンをエクスポートします。

export VIDSEEDS_PAT="vs_pat_your_token_here"

オプション B - CLI

codex mcp add vidseeds --url https://vidseeds.ai/api/mcp?toolset=core --bearer-token-env-var VIDSEEDS_PAT

オプション C - リポジトリ／チームのマーケットプレイス

codex plugin marketplace add CarrotGamesStudios/vidseeds-mcp
codex plugin add vidseeds@vidseeds

このリポジトリには、Codex リポジトリマーケットプレイス .agents/plugins/marketplace.json と、 プラグインマニフェスト .codex-plugin/plugin.json も含まれています（MCP 設定は codex.mcp.json）。 このリポジトリを Codex マーケットプレイスとして指定し、codex plugin add または codex → /plugins から vidseeds をインストールしてください。同じ VIDSEEDS_PAT 環境変数を使用できます。

---

4. Cursor にインストールする

サーバーを ~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加します。 Cursor は url / headers 内の ${env:…} を解決するため、シークレットを貼り付けず、名前でトークンを参照してください。

{
  "mcpServers": {
    "vidseeds": {
      "url": "https://vidseeds.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDSEEDS_PAT}"
      }
    }
  }
}

環境変数に VIDSEEDS_PAT を設定し、Cursor Settings → MCP で vidseeds サーバーを有効にします。ツール名には vidseeds_ というプレフィックスが使われます（ドットではなくアンダースコアです）。 Cursor は vidseeds.generate_thumbnail のようなドット区切りの名前を拒否します。

---

5. 公式 MCP レジストリとその他のカタログ

ルートの server.json は、ホスト型リモートサーバーのレジストリ互換の説明ファイルです。

• 名前：io.github.CarrotGamesStudios/vidseeds-mcp
• リモート：https://vidseeds.ai/api/mcp の streamable-http
• 認証ヘッダー：必須のシークレットである Authorization の値。例： Bearer vs_pat_your_token_here
• リポジトリ：https://github.com/CarrotGamesStudios/vidseeds-mcp

メンテナー向けの注意：コネクターのバージョン、エンドポイント、認証要件、または正式な説明が変更された場合は、公式の mcp-publisher CLI を使って server.json を公開または再公開してください。公式レジストリを取り込むディレクトリーサイトは、Claude/Codex 固有のプラグインマーケットプレイスを必要とせずに VidSeeds.ai を見つけられるようになります。

---

6. ChatGPT

ChatGPT では、この Git リポジトリをカスタムマーケットプレイスとしてインストールできません。ChatGPT Apps ディレクトリーで公開された後に VidSeeds.ai ChatGPT App を使用するか、ホスト型エンドポイントに対応するカスタム MCP コネクターをサポートしたクライアントを使用してください。ChatGPT エンドポイントは https://vidseeds.ai/api/mcp/chatgpt です。ChatGPT で安全に使用できるツールのサブセットと、レンダリング済みのウィジェットを公開します。

---

7. エージェントスキル（ワークフローガイド）

このプラグインには skills/ にスキルが含まれており、ツールの組み合わせを推測せずに、エージェントが MCP を効率的に使えるようにします。コストのかかるワークフローの前に vidseeds-efficiency を読んでください。

スキル	使用する場面
vidseeds-setup	PAT/OAuth、トライアル、初回接続
vidseeds-efficiency	Seeds、MCP の日次クォータ、非同期ポーリング
vidseeds-thumbnails	生成、編集、スタジオ、プロジェクトへの適用
vidseeds-projects	YouTube → プロジェクト → メタデータ
vidseeds-analytics	チャンネル情報、詳細分析、発見
vidseeds-local-video	ローカルファイル、ffmpeg のレシピ、トリミング
vidseeds-publishing	接続、公開前チェック、公開

ツールごとのパラメーターと Seeds のコストは、ホスト型サーバーの tools/list の説明に記載されています。スキルが教えるのは組み合わせ方であり、完全なカタログではありません。メンテナーによる同期については、MAINTAINERS.md を参照してください。

---

8. コネクターでできること

VidSeeds.ai のクリエイターワークフロー全体をカバーする 247 個のツール：

領域	例
メタデータの最適化	タイトル、説明、タグ、チャプター、最適化履歴
サムネイル	AI 生成、編集、スタイル変更、Thumbnail Studio（トレンド、ブリーフ、被写体、オーバーレイテキスト、スタイルプロファイル）、YouTube への公開
プロジェクト	YouTube 動画から作成、スナップショット、サムネイルの適用、プラットフォームごとの設定
アナリティクスとインテリジェンス	チャンネル／動画のアナリティクス、チャンネルインテリジェンス、動画の事後分析、外れ値の検出、公開チャンネルの監査
発見と調査	キーワード調査、トレンド動画、急成長チャンネル、動画のアイデア
自動クリップ	保存済みショート動画の一覧表示／取得、メタデータの編集、キャプションのスタイル、リフレーム、ダウンロード
翻訳とキャプション	メタデータのローカライズ（85 言語）、キャプションのアップロード／取得／削除
ローカル動画メディア	probe、フレーム／クリップの抽出、精密トリミングとミッドロール分析（コマンドはローカルで実行）
公開	プラットフォームの接続、公開のスケジュール設定／確定、YouTube への直接アップロード
アカウント	Seeds 残高、サブスクリプション、紹介、サポート

Seeds： 一部のツール（サムネイル生成、AI インテリジェンス、翻訳など）では、 VidSeeds.ai の残高から Seeds が消費されます。読み取り専用ツールは無料です。各ツールの説明に コストが記載されています。不明な場合は vidseeds_get_seed_balance を確認してください。

---

9. ツールカタログのサイズ管理

247 個のツールは多すぎます。 VidSeeds.ai を MCP クライアントに接続すると、ツールカタログ全体（約 46K トークン）が エージェントのコンテキストに読み込まれます。エージェントの動作が遅い、または処理しきれないと感じる場合は、より軽量なツールセットに切り替えられます：

9a. MCP URL に ?toolset=core を使用する

最小限の構成にするには ?toolset=guide を追加します（オリエンテーション用の vidseeds_guide ツールと説明のみ、約 1 個のツール）。 約 247 個から必須の約 74 個のツール（約 16K トークン）に減らすには ?toolset=core を追加します。ほとんどの用途で推奨されるデフォルト設定です：

Claude Code（ほとんどの用途に推奨）：

claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=core \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

超軽量（ガイドのみ）の場合：

claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=guide \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

Cursor（推奨デフォルト）：

{
  "mcpServers": {
    "vidseeds": {
      "url": "https://vidseeds.ai/api/mcp?toolset=core",
      "headers": {
        "Authorization": "Bearer ${env:VIDSEEDS_PAT}"
      }
    }
  }
}

（最も軽量にするには ?toolset=guide を使用してください。）

Codex（推奨）：

[mcp_servers.vidseeds]
url = "https://vidseeds.ai/api/mcp?toolset=core"
bearer_token_env_var = "VIDSEEDS_PAT"

Claude Desktop - カスタム MCP コネクターの定義時に追加します：

URL: https://vidseeds.ai/api/mcp?toolset=core

⚠️ いつでも元の構成に戻せます。 core のみのエージェントで core セットにないツール（例：詳細なインテリジェンス、精密トリミング、コメント管理）が必要になった場合は、URL から ?toolset=core を削除して再接続するだけです。完全なカタログはいつでも利用できます。

core ツールセットに含まれるツール：プロジェクト、メタデータの最適化、公開、 サムネイル、基本的なアナリティクス、チャンネル管理、翻訳、接続、請求、 紹介。その他すべて（詳細なインテリジェンス、競合調査、ローカル動画ツール、 管理、自動クリップ、一括編集、コメント、アシスタントのワークフロー）は除外されます。

9b. AI が VidSeeds.ai のツールをデフォルトで使うようにする

汎用エージェントが、接続されている VidSeeds.ai のツールではなく、生の Python コードや ffmpeg コマンドのテンプレート、ブラウザー自動化を使ってしまうことがあります。サーバーには、こうした切り詰め制限に合わせたルーティング優先の指示が含まれています（v1.9.2）が、クライアントに直接指示することで、ルーティングを確実にできます。

Claude.ai / Claude Desktop - Settings → Profile → Preferences（全体に適用）またはプロジェクトのカスタム指示に貼り付けます。

When my request involves my videos, channels, titles, descriptions, tags,
thumbnails, video SEO, keywords, analytics, comments, clips, captions,
translations, scheduling, or publishing, ALWAYS use the connected VidSeeds.ai
tools (vidseeds_*) first - search the available tools for "vidseeds" if none
are loaded. Do not use web search, browser automation, or general knowledge
for these tasks: VidSeeds.ai has authenticated access to my actual channel data,
transcripts, and analytics.

Claude Code - 同じブロックをプロジェクトの CLAUDE.md（全プロジェクトに適用する場合は ~/.claude/CLAUDE.md）に追加します。

Codex / Cursor - それぞれ AGENTS.md / プロジェクトルールに追加します。

---

プラットフォーム利用枠（MCP の1日あたりの呼び出し上限）

ツールごとのシード消費に加え、読み取り・書き込みを問わず、すべての MCP ツール呼び出しが、1日を通して継続的に補充される余裕のあるプラットフォーム利用枠の対象になります。これにより、実際の本番ワークロード（毎日のショート動画、調整、ポーリング、エージェントによる調査）はどのプランでも余裕をもって利用できる一方、大量のスクレイピングや不正利用が長時間続く場合は、実費が発生します。

プラン	1日あたりの呼び出し回数	バケット上限
Sprout	1,000	2,000
Growth	3,000	6,000
Harvest	8,000	16,000
Agency	20,000	40,000
Trial	1,000	1,000

• 深夜のリセットではなく、継続的に補充されます。 バケットはプランごとの速度（例：Sprout = 1,000回／日）で補充され、上限まで蓄積されるため、利用の少ない日の分を翌日に適度に持ち越せます。
• 超過分： バケットが空になると、追加のツール呼び出しごとに1シード（MCP_OVERAGE_SEED_COST）が、ツールごとのシード消費に加えてかかります。バケットは継続的に補充されるため、再び補充されれば超過料金はかからなくなります。
• 残高と料金の確認は無料で、利用枠の対象外です - vidseeds_get_seed_balance と vidseeds_get_seed_balance_and_subscription は、呼び出し回数を消費せず、超過料金も発生しません。
• 残りの無料呼び出し回数は、vidseeds_get_seed_balance でいつでも確認できます（1日あたりの補充量、バケット上限、利用可能な無料呼び出し回数、超過料金が返されます）。

呼び出しが利用枠を超過し、残高で1シードの超過料金を支払えない場合、ツールはトップアップ用リンクを含む明確な MCP_QUOTA_EXCEEDED エラーを返します。予期しない請求は発生しません。

YouTube のサムネイルアップロード上限

YouTube では、カスタムサムネイルのアップロードに対して、VidSeeds.ai のシードや MCP の呼び出し枠とは別のレート制限が設けられています。サムネイルを一括で差し替える場合は、接続されている YouTube チャンネル／アカウントごとに、ローリング24時間あたり約100件以下のサムネイルアップロードを目安にしてください。vidseeds_publish_thumbnail_to_youtube が uploadRateLimitExceeded または「too many thumbnails recently」を返した場合は、バッチを停止し、次の動画 ID を保存して、後から再開してください。

---

セキュリティ

• このパッケージには認証情報は含まれていません。ユーザーが指定した PAT を VIDSEEDS_PAT から読み取り、Claude Code / Codex が https://vidseeds.ai/api/mcp を呼び出す方法を定義しています。
• vs_pat_… トークンをコミット、貼り付け、共有しないでください。トークンのローテーションまたは無効化は、https://vidseeds.ai/settings/mcp-settings で行ってください。
• Cookie／セッション認証は、サーバーの設計上拒否されます。受け付けられる認証情報は PAT のみのため、クライアントの設定に誤りがあってもダッシュボードへのログインを利用できません。

バージョン管理

プラグインのバージョンは VidSeeds.ai MCP コネクターパッケージのバージョンに対応しています（現在 1.9.2 - クライアントの切り詰め制限に合わせたルーティング優先のサーバー instructions により、ツール検索クライアントはデフォルトで VidSeeds のツールを使用します。また、vidseeds_guide ツール、vidseeds://guide リソース、ワークフロープロンプトも含まれます）。 ワイルドカード PAT スコープは、サーバーの拡張に伴い新しいツールにも自動的に適用されるため、既存のトークンを再作成しなくても引き続き使用できます。

リンク

• 製品：https://vidseeds.ai
• MCP の設定：https://vidseeds.ai/settings/mcp-settings
• MCP：https://modelcontextprotocol.io

ライセンス

MIT - LICENSE を参照してください。