viral.app

viral-app-agents

コーディングエージェントやチャットアプリ向けの、viral.app 公式プラグインとインストール用ショートカットです。1 回のインストールで、エージェントが viral.app MCP サーバーに接続されます。UGC 分析、アカウントと動画の追跡、タグとタグのワークフロー、Creator Hub（キャンペーン、ブリーフ、求人情報、応募、クリエイターとのチャット、支払い）、バイラル動画ライブラリ、TikTok／Instagram／YouTube／Facebook のリアルタイム検索に使える 100 種類以上のツールを利用できます。プラグインには、エージェントにワークフローを教える7 つのスキルも含まれています。

MCP サーバーは https://viral.app/api/mcp（ストリーム可能な HTTP、OAuth）にあります。API アクセス権のある viral.app アカウントが必要です。viral.app/app/org/api/agents ですべてを管理できます。

インストール

どのクライアントも、ブラウザーで OAuth を使ってサインインします。viral.app は動的なクライアント登録に対応しているため、クライアント ID、シークレット、API キーを入力する必要はありません。同意時に組織を 1 つ選択します。

チャットアプリ： Claude.ai と Claude Desktop · ChatGPT · Grok · その他のチャットアプリ

プラグイン（MCP サーバー＋スキル）： Claude Code · Codex CLI · GitHub Copilot CLI · VS Code · Cursor · Gemini CLI · Qwen Code · Kiro · Devin · Factory Droid · Grok Build

MCP サーバーのみ： Augment · JetBrains Junie · OpenCode · Amp · Goose · Zed · Warp · Mistral Vibe · その他の MCP クライアント

チャットアプリ

Claude.ai と Claude Desktop

この URL でカスタムコネクターを追加し、クライアント ID とシークレットは空欄のままにします。

https://viral.app/api/mcp

コネクター設定を開くか、［Settings］、［Connectors］、［Add custom connector］の順に進みます。

トップ動画、クリエイター、キャンペーン、KPI グラフなどの結果は、Claude のウェブ版、Desktop、モバイルでインタラクティブなカードとして表示されます。

ChatGPT

ChatGPT 用 viral.app プラグインをインストールします。

• カード： 結果はチャット内にインタラクティブなカードとして表示されます。ChatGPT のデスクトップ版では、会話パネル付きのサイドバーアプリとして viral.app を利用することもできます。
• イベント： Work チャット（ChatGPT ウェブ版、または Cloud を選択したデスクトップアプリ）や dots で、viral.app を監視して何かあれば指定の対応をするよう ChatGPT に依頼できます。たとえば、「クリエイターが私の Habit Tracker の求人に応募したら、応募内容を要約して、私が承認できるよう返信の下書きを作成して」と依頼します。ChatGPT は viral.app の MCP Events を通じて登録し、条件に一致する各イベントを viral.app がそのチャットに配信します。チャット、応募、支払いに関するイベントは約 1 分以内に届きます。新しい動画や視聴回数のマイルストーンに関するイベントは、各アカウントの同期頻度（数時間ごと）に従います。監視を終了するには、ChatGPT に監視の停止を依頼してください。

Grok

grok.com で［Connectors］を開き、［New Connector］、［Custom］の順に選択して、https://viral.app/api/mcp を貼り付けます。

Grok Bot では、Marketplace に掲載されたら、そこから viral.app をインストールします。

その他のチャットアプリ

OAuth を使ったカスタムのリモート MCP URL に対応しています。https://viral.app/api/mcp を使用してください。

• Perplexity： ［Settings］、［Connectors］、［Custom connector］、［Remote］の順に進みます。OAuth と Streamable HTTP を選択します。
• Mistral Vibe（旧 Le Chat）、Work モード：［Connectors］、［Add Connector］、［Custom MCP Connector］の順に進みます。コネクターを追加できるのは管理者のみです。viralapp のように、特殊文字を含まない名前を使用してください。
• Notion のカスタムエージェント（Business および Enterprise）：管理者が［Settings］、［Connections］でカスタム MCP サーバーを有効にします。その後、エージェントの［Tools & Access］、［Add connection］、［Custom MCP server］の順に開きます。

プラグイン

Claude Code

claude plugin marketplace add https://github.com/fmd-labs/viral-app-agents
claude plugin install viral-app@viral-app

または、対話形式で /plugin marketplace add https://github.com/fmd-labs/viral-app-agents を実行してから、/plugin install viral-app を実行します。その後、/mcp を実行し、viral_app を選択して、ブラウザーで認証します。GitHub の SSH アクセス権がある場合は、fmd-labs/viral-app-agents という省略形も使用できます。

Codex CLI

codex plugin marketplace add https://github.com/fmd-labs/viral-app-agents
codex plugin add viral-app@viral-app

または、Codex TUI で対話形式により /plugins を実行します。その後、新しいセッションを開始し、codex mcp login viral_app で認証します。

Codex CLI 0.147 以降が必要です。古いバージョンでは、OAuth ログイン時に「Authorization server response missing required issuer」というエラーが発生します（Codex のバグで、0.147.0 で修正されています）。npm install -g @openai/codex@latest で更新してから、再試行してください。

プラグインを使わず、MCP サーバーのみを利用する場合：

codex mcp add viral_app --url https://viral.app/api/mcp
codex mcp login viral_app

GitHub Copilot CLI

copilot plugin marketplace add fmd-labs/viral-app-agents
copilot plugin install viral-app@viral-app

VS Code

エージェントプラグインからプラグイン（MCP サーバーとスキル）をインストールします。ユーザー設定にマーケットプレイスを追加します：

"chat.plugins.enabled": true,
"chat.plugins.marketplaces": ["fmd-labs/viral-app-agents"]

次に、拡張機能ビューで @agentPlugins を検索し、viral-app をインストールします。

MCP サーバーのみを利用する場合：

または、.vscode/mcp.json に追加します：

{ "servers": { "viral_app": { "type": "http", "url": "https://viral.app/api/mcp" } } }

Cursor

または、.cursor/mcp.json に追加します：

{ "mcpServers": { "viral_app": { "type": "http", "url": "https://viral.app/api/mcp" } } }

このリポジトリには、MCP サーバーとスキルをまとめた Cursor プラグインマニフェスト（.cursor-plugin/）も含まれており、Cursor Marketplace で利用できます。

Gemini CLI

gemini extensions install https://github.com/fmd-labs/viral-app-agents

Gemini CLI を再起動してから、/mcp auth viral_app を実行してサインインします。

Qwen Code

qwen extensions install fmd-labs/viral-app-agents:viral-app

MCP サーバーとスキルを利用できます。/mcp で接続を確認してください。

Kiro

Powers パネルで「Add Custom Power」を選択し、「Import power from GitHub」を選択して、次を入力します：

https://github.com/fmd-labs/viral-app-agents

Devin

devin plugins install fmd-labs/viral-app-agents#plugins/viral-app

まだサインインしていない場合は、先に Devin にサインインし（devin auth login）、次に devin mcp login viral_app を実行して viral.app に接続します。

Factory Droid

droid plugin marketplace add https://github.com/fmd-labs/viral-app-agents
droid plugin install viral-app@viral-app-agents --scope user

Droid ではリポジトリ名がマーケットプレイス名になるため、@viral-app-agents を指定します。/mcp を実行して、ブラウザーでのサインインを完了します。

Grok Build

grok plugin marketplace add fmd-labs/viral-app-agents
grok plugin install viral-app --trust

CLI では、--trust を指定しないとプラグインをインストールできません。

MCP サーバーのみ

これらのクライアントでは、同梱のスキルを含めずに MCP サーバーを利用できます。

Augment and Auggie

auggie mcp add viral_app --transport http --url https://viral.app/api/mcp

IDE 拡張機能で、Settings、MCP、Add remote MCP の順に選択し、接続タイプに HTTP を指定します。

JetBrains Junie

プロジェクト内の .junie/mcp/mcp.json（または ~/.junie/mcp/mcp.json）に追加するか、Settings、Tools、Junie、MCP Settings の順に選択します：

{ "mcpServers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

Junie CLI で /mcp を実行し、viral_app を選択して「Authorize」を選びます。

OpenCode

opencode.json に追加します：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": { "viral_app": { "type": "remote", "url": "https://viral.app/api/mcp" } }
}

次に、opencode mcp auth viral_app を実行します。

Amp

amp mcp add viral_app https://viral.app/api/mcp

Amp は次回の起動時に、ブラウザーでのサインインを開始します。

Goose

このリンクを開いて Goose Desktop に拡張機能を追加します（GitHub では goose:// リンクが表示されないため、ブラウザーにコピーしてください）：

goose://extension?type=streamable_http&url=https%3A%2F%2Fviral.app%2Fapi%2Fmcp&id=viral_app&name=viral.app&description=UGC%20analytics%20and%20tracking%20from%20viral.app

CLI では、goose configure を実行し、Add Extension、Remote Extension（Streamable HTTP）の順に選択して、URL https://viral.app/api/mcp を指定します。

スキルも追加するには、goose plugin install https://github.com/fmd-labs/viral-app-agents.git を実行します。Goose ではスキルが viral-app:viral-app-mcp、viral-app:ugc-reporting などの名前で読み込まれます。

Zed

Zed の設定に追加するか、Settings、AI、MCP Servers、Add Server、Add Remote Server の順に選択します：

{ "context_servers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

Zed からサインインを求められます。

Warp

Settings、Agents、MCP servers、Add の順に選択して、次を貼り付けます：

{ "mcpServers": { "viral_app": { "url": "https://viral.app/api/mcp" } } }

Mistral Vibe

vibe mcp add viral_app --url https://viral.app/api/mcp

その他の MCP クライアント

ストリーム可能な HTTP と OAuth を使用して、クライアントを https://viral.app/api/mcp に接続します。サーバーは標準の OAuth ディスカバリーメタデータを公開し、動的なクライアント登録に対応しているため、事前共有の認証情報は必要ありません。公式 MCP Registry での名前は io.github.fmd-labs/viral-app です。

スキル

プラグインには 7 つのスキルが含まれています。エージェントは必要に応じてスキルを読み込み、それぞれのスキルの詳しい資料は、隣接する references/ フォルダーに格納されています。

スキル	用途
viral-app-mcp	基本ガイド：接続と認証、クレジットの見積もり後に確定するフロー、クリエイターに届く書き込み操作のルール、ID と単位、MCP でできないこと、次に読み込むスキル
ugc-reporting	週次または月次の UGC レポート、期間ごとの変化を含む KPI とランキングの作成方法、Claude と ChatGPT のカード、Slack の要約、スケジュールタスクまたは ChatGPT ページを使った定期レポート
creator-briefs	viral.app の Copilot が作成する形式のクリエイターブリーフ：商品、viral ライブラリまたは独自の動画から選んだ実証済みのサンプル動画、ブリーフの構成、番号付きサンプル、ブリーフを読む人、通知するかどうか。MCP または API キーを使った REST API
creator-management	クリエイター名簿の日常管理：クリエイターの個別追加または CSV からの追加、招待、ソーシャルアカウントの連携、ダイレクトチャットとグループチャット、一斉送信、対応が滞っているクリエイターへのリマインダー、名簿の監査。MCP または REST
creator-campaigns	Creator Hub の全工程：ベンチマークとプレビュー手順を含むガイド付きキャンペーン設定、報酬の変更とカスタム料金、クリエイターの割り当て、求人掲載（執筆、ベンチマーク、公開）、応募、支払いの確認
viral-research	バイラル動画ライブラリ、類似動画、フックとシーンの分析、追跡対象動画の AI 分析、リアルタイム検索、調査結果からフックとブリーフを作成する方法
ugc-automations	「X を監視して Y を実行」：ChatGPT の MCP Events、その他のクライアント向けのポーリングによる代替手段、イベントごとの遅延、信頼できないクリエイターのテキストの処理

内容一覧

パス	目的
.claude-plugin/marketplace.json	Claude 形式のマーケットプレイスカタログ（Claude Code、Copilot CLI、VS Code、Factory、Grok Build）。viral-app を掲載しています
.agents/plugins/marketplace.json	Codex マーケットプレイスカタログ
.cursor-plugin/marketplace.json	Cursor マーケットプレイスカタログ（Cursor、Grok Bot）
gemini-extension.json	Gemini CLI 拡張機能マニフェスト（Gemini CLI、Qwen Code）
plugin.json	リポジトリルート用の Agent Plugins 1.0 マニフェスト（リポジトリルートに直接インストールした場合は Kiro、Mistral Vibe、Copilot CLI または Devin が使用します。Goose はスキルのみをインポートします）
mcp.json	リポジトリルート用の Agent Plugins 1.0 MCP 設定（plugin.json と併せて読み込みます）
skills/	ルートレベルのパッケージ用のプラグインスキルのコピー（Gemini CLI、Agent Plugins）。scripts/sync-skills.sh を使って plugins/viral-app/skills/ から生成されます
server.json	公式 MCP Registry エントリー io.github.fmd-labs/viral-app
.github/workflows/publish-mcp-registry.yml	プルリクエストで server.json を検証し、GitHub OIDC 経由で main から MCP Registry に公開します
plugins/viral-app/.claude-plugin/plugin.json	MCP サーバーをインラインで含む Claude 形式のプラグインマニフェスト（Claude Code、Copilot CLI、VS Code、Devin、Grok Build）
plugins/viral-app/.codex-plugin/plugin.json	Codex プラグインマニフェスト
plugins/viral-app/.cursor-plugin/plugin.json	Cursor プラグインマニフェスト
plugins/viral-app/.mcp.json	Claude 形式の MCP 設定（Codex、Factory、Grok Build 用。Claude Code はインラインエントリーと統合します）
plugins/viral-app/skills/	7 つのスキル（正本）
scripts/sync-skills.sh	plugins/viral-app/skills/ を skills/ にコピーします。--check を指定すると、コピーが異なる場合に失敗します
scripts/build-chatgpt-package.sh	OpenAI のプラグインダッシュボード（新しいバージョンをアップロード）用に dist/viral-app-chatgpt.zip をビルドします。OpenAI のパッケージルールに照らして検証した、Codex マニフェスト、.mcp.json、スキル、plugins/viral-app のアセットが含まれ、Claude および Cursor のマニフェストは含まれません
plugins/viral-app/assets/	プラグインのロゴ（logo.svg、400x400 の logo.png）

リリース時：

• plugin.json、gemini-extension.json、plugins/viral-app/.claude-plugin/plugin.json、plugins/viral-app/.codex-plugin/plugin.json、plugins/viral-app/.cursor-plugin/plugin.json、および .claude-plugin/marketplace.json と .agents/plugins/marketplace.json 内の該当エントリーで、viral-app の version をまとめて更新します（grep -rn '"version"' --include=*.json . で一覧を確認できます）。
• スキルは plugins/viral-app/skills/ のみ編集し、その後 scripts/sync-skills.sh を実行します（--check を指定すると、コピーが一致しているか検証できます）。
• ChatGPT 用には、scripts/build-chatgpt-package.sh を実行して dist/viral-app-chatgpt.zip をビルドし、OpenAI プラグインダッシュボードで新しいバージョンとしてアップロードします。このスクリプトは、ダッシュボードが他の名前を拒否するため、公開済みプラグインのパッケージ名（app-6a8713d41dc48191b33e75c49a764db3）を ZIP 内のマニフェストに書き込みます。ホストされた MCP サーバーへの変更にアップロードは不要ですが、マニフェストやスキルの変更には必要です。
• server.json には独自のバージョンがあり、MCP Registry は公開済みのバージョンを受け付けないため、このファイルを変更するたびにバージョンを更新します。

認証とセキュリティ

• OAuth がデフォルトです。同意時に組織を 1 つ選ぶと、許可はその組織に恒久的に限定されます。承認済みのクライアントは viral.app/app/user/settings/security で確認または取り消しができます。
• API キーは、1 つのエージェントで複数の組織を切り替える必要がある高度な設定でのみ使用します。viral.app のダッシュボードで組織ごとに作成してください。
• このリポジトリにシークレットは含まれておらず、今後も含まれません。viral.app エンドポイントを参照する公開設定のみを配布します。すべての認証情報は、実行時にご自身のブラウザーでの OAuth を通じて発行されます。
• viral.app のクレジットを消費するツール（ライブ検索、更新、動画分析）は、最初にコストを提示し、明示的な確認を伴って再度呼び出された場合にのみ実行します。

サポートとプライバシー

• サポート：[email protected]
• プライバシーポリシー：viral.app/legal/privacy
• 利用規約：viral.app/legal/terms

関連情報

• viral.app のドキュメント
• API リファレンス
• viral-app-skills：API キーを使用するワークフロー向けの CLI ベースのスキル
• n8n-nodes-viral-app：n8n コミュニティノード

ライセンス

MIT