MCP：Claude、Claude Code、Codex で FilmLune を使う

MCPは対応クライアントが構造化ツールを利用する仕組みです。FilmLuneは同じMCPエンドポイントで、再利用できる作例を公開し、対象アカウントに非公開のクラウド生成を提供します。別のREST型Public APIは提供しません。

対応クライアントをFilmLuneのStreamable HTTPエンドポイントに接続できます。アカウント不要の公開ツールは6つです（権利で絞り込まれたカタログツール5つと、生成モデル一覧）。メール確認済みの有効なアカウントは、権限を限定した自分のMCPアクセスキーで見積もり、参照画像のアップロード、対象クレジットによる非公開の画像・動画の生成ができます。これはMCPアクセスであり、独立したPublic APIではありません。

Streamable HTTPエンドポイント

https://filmlune.com/api/mcp/

対応するMCPクライアントにこのURLを追加してください。カタログ閲覧はキー不要です。生成には対象アカウントに紐づくMCPアクセスキーが必要です。

Claude Code

コマンドひとつで FilmLune を追加できます。公開カタログツールはキーなしで使えます。

claude mcp add --transport http filmlune https://filmlune.com/api/mcp/

生成するには、MCP アクセスキーを環境変数 FILMLUNE_MCP_KEY に入れ、ヘッダーとして追加します：

claude mcp add --transport http filmlune https://filmlune.com/api/mcp/ --header "Authorization: Bearer $FILMLUNE_MCP_KEY"

Codex

Codex の設定に FilmLune を追加します。Codex は環境変数 FILMLUNE_MCP_KEY のキーを送信します。キーがない場合は公開ツールのみ使えます。

[mcp_servers.filmlune]
url = "https://filmlune.com/api/mcp/"
bearer_token_env_var = "FILMLUNE_MCP_KEY"

Claude アプリ

Claude でカスタムコネクタを追加し、エンドポイントの URL を貼り付けると公開カタログツールを使えます。生成にはリクエストヘッダーで送る MCP アクセスキーが必要なため、現時点では Claude Code または Codex から生成してください。

接続してツールを呼び出す

1. 上のStreamable HTTPエンドポイントを対応MCPクライアントに追加するか、ローカルstdioサーバーを実行してください。
2. 接続を初期化し、公開ツール6つと、見積もり・アップロード・生成・履歴用のアカウントツール7つを一覧表示してください。
3. search_casesとget_caseはキーなしで閲覧できます。非公開メディアを作るにはMCPアクセスキーを追加し、generate_imageまたはgenerate_video、その後check_generationを呼び出してください。

MCP アクセスキー

キーはアカウントで作成・確認・無効化できます。キーは一度しか表示されません。共有ファイルではなく環境変数に保存してください。

FilmLuneがパスワード、ワンタイムコード、カード番号全体、セキュリティコード、MCPアクセスキー、StripeのシークレットをメールやX・Discordに送るよう求めることはありません。

• MCPアクセスキーを管理

権限と正規データ

生成済みカタログに書き込み経路はありません。認証付き生成は所有者限定の非公開FilmLuneジョブのみ作成し、ウェブサイトの安全性・クレジット制御に従います。カタログを編集・公開できません。プロンプト利用には記録単位の権利と別のコンテンツライセンスが適用されます。作例メディアと第三者の素材は対象外です。

ローカルstdioトランスポート

閲覧専用ツール5つ。アカウント、クラウド生成、クレジットへのアクセスはありません。

• GitHubのオープンソースリポジトリ

  github.com/xspring1982/filmlune-mcp