MCP で Agent を接続する

接続方法を選択してください

FreeLipSync は、https://freelipsync.com/mcp でリモート MCP エンドポイントを公開します。 REST API と同じビデオ生成機能とアカウント クレジットをエージェントに提供します。 登録済みの FreeLipSync アカウントが必要です。 匿名アクセスはサポートされていません。 ステージングでテストする場合は、代わりにステージング オリジンを使用してください。

API Key 構成と OAuth の両方がサポートされています。 サーバー エントリごとに 1 つの資格情報ソースを選択します。 既存の構成ファイルは引き続き有効な接続方法です。 OAuth を使用する必要はありません。

キーは作成時のダイアログで完全な値をコピーしてください。OAuth ではキーのコピーは不要です。アカウントごとに API Key は最大 5 個、独立した OAuth 認可接続は最大 5 件です。API Key での接続はキー枠を使用し、OAuth 接続枠は使いません。どちらもアカウントの残高、モデル、利用制限を共有します。

OAuth 認証フロー

1. Authorization ヘッダーまたは API Key 設定を使用せずに、リモート HTTPS URL をクライアントに追加します。
2. クライアントに応じて、Connect / Authenticate / Sign in を選択します。
3. ブラウザで、FreeLipSync アカウントにサインインし、要求しているクライアントと権限を確認します。
4. 新しい接続を作成するか (デフォルト)、置き換える既存の接続を明示的に選択します。 別のデバイスでの認証の成功は通常、個別にカウントされます。
5. エージェントが購入した API クレジットを使用できるようにしてから、承認します。 クライアントに戻り、以下のツールを確認します。

リクエストを拒否することもできます。 すべての 5 接続スロットが使用されている場合は、Agent コンソール で古い接続を明示的に置き換えるか取り消します。 新しい認証は、サイレントに接続を削除しません。 トークンの更新と既存の認証の再接続では、スロットは追加されません。 OAuth 接続は、生成の送信時にアカウントのクレジットを消費する可能性があります。

クライアント OAuth の互換性が重要: FreeLipSync は、オープンな動的登録エンドポイントではなく、公開されたクライアント ID メタデータ (CIMD) と事前登録されたクライアントをサポートします。 互換性のあるクライアント バージョンを使用するか、サポートされている場合は割り当てられたクライアント ID を使用します。 クライアントが動的登録のみをサポートしており、サインインが失敗する場合は、API Key メソッドを使用するか、サポートに連絡してクライアントの登録を確認してください。

クライアントの互換性と OAuth の違い

OAuth の登録とトークン認証は別のものです。 FreeLipSync は、CIMD または事前登録されたクライアント ID (none + PKCE または private_key_jwt) をサポートします。 これは、サポートされているメソッドの新しい CIMD 配列と古い単一メソッド フィールドを理解します。 署名されたクライアントは、公開された公開鍵を自動的に使用します。 ユーザーは秘密キーをアップロードしません。

FreeLipSync は、オープン動的登録 (DCR)、クライアント シークレット認証、または client_credentials 付与を提供しません。 クライアントが DCR を必要とする場合は、利用可能な場合は事前登録されたパブリック クライアント オプションを使用するか、カスタム ベアラー ヘッダーをサポートするクライアントで API Key 構成を使用します。 割り当てられた ID を取得し、実際のコールバックを構成する前に登録します。 API Key と OAuth クライアント ID は異なる資格情報です。

Codex: 構成ファイルまたは OAuth

Codex の Plugins → MCPs の下にリモート HTTP サーバーを追加または編集します。 一部のバージョンは Settings → MCP サーバーを使用します。 このローカル MCP エントリは、API Key 構成をサポートしており、上記のホストされたプラグイン OAuth エントリとは別のものです。

資格情報ソースを 1 つ選択してください。 例では、https://freelipsync.com/mcp を使用します。 ステージングの場合は、これを https://staging.freelipsync.com/mcp に置き換えて、ステージング アカウントにキーを作成します。 プロダクション キーとステージング キーは交換できません。

オプション A: デスクトップ設定に API Key を貼り付けます。

環境変数を設定したくない場合は、このオプションを使用します。 Agent コンソール でキーを作成し、完全なシークレットをコピーして、次のように入力します。

Bearer の後にスペースを 1 つ使用します。 キー自体には Bearer プレフィックスがありません。 ヘッダーに FLS_API_KEY という名前を付けたり、シークレットを Bearer token env var に貼り付けたりしないでください。 保存して再接続します。 クライアントがまだ古い構成を使用している場合は、クライアントを再起動するか、新しいセッションを開きます。

同等の個人用 ~/.codex/config.toml エントリは次のとおりです。

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }

オプション B: 環境変数を通じて API Key を指定します。

Bearer token env var はシークレットではなく変数名を受け取ります。 FLS_API_KEY に設定します。 この変数は、Codex を実行しているプロセスの環境に存在する必要があります。 その値は、Bearer を除いた完全なキーです。 Codex はプレフィックスを追加します。

対応する個人設定ファイルは次のとおりです。

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
bearer_token_env_var = "FLS_API_KEY"

端末から起動された Codex CLI の場合:

export FLS_API_KEY='YOUR_API_KEY'
codex mcp list
codex
# Inspect /mcp in the new session.

別のターミナルで変数をエクスポートしても、すでに実行中のデスクトップ アプリは更新されません。 Dock または [スタート] メニューから起動されたアプリも、端末変数を継承しない場合があります。 デスクトップ プロセス環境を提供する方法がわからない場合は、オプション A を使用してください。

Headers は、HTTP リクエスト ヘッダーを作成します。 Headers from environment variables は、既存の環境変数からヘッダー値を読み取ります。 どちらのフィールドもシステム環境変数を作成しません。 FLS_API_KEY という名前のヘッダーにはベアラー設定が設定されず、MCP_BEARER_TOKEN などの灰色のプレースホルダーは変数が構成されたことを意味しません。

オプション C: OAuth を使用してブラウザで認証する

URL のみを入力します。 前の Authorization 行を削除するなど、Bearer token env var、Headers、および Headers from environment variables は空のままにしておきます。 保存し、表示される場合は Authenticate / Sign in を選択し、FreeLipSync にサインインして接続を承認します。 API Key を作成したり貼り付けたりする必要はありません。

構成ファイルの場合は、以下のみを保持します。

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"

CLI コマンド:

# Run the next line only if this server name does not exist; otherwise edit it.
codex mcp add freelipsync --url https://freelipsync.com/mcp
codex mcp login freelipsync
codex mcp list

コマンド内の freelipsync を、保存したサーバー名に置き換えます。 上記の 3 つの TOML ブロックは代替手段です。 サーバー用に 1 つのエントリを保持します。 OAuth に切り替える前に、キー付き構成を削除します。ログインしても、まだ構成されている不正な Authorization ヘッダーは修復されません。

保存後に接続を確認してください

新しいセッションで、「FreeLipSync get_capabilities と get_usage を呼び出して、モデルとクレジットを確認します。ビデオを生成しないでください。」 アカウントの応答が成功すると、接続が確認されます。 リストに表示されるサーバー名だけでは表示されません。

HTTP 401, の場合、URL とキーが同じ環境に属していること、キーが完全であること、静的ヘッダーが Authorization: Bearer YOUR_API_KEY であること、古い Bearer 変数や重複した Authorization 設定が残っていないことを確認します。 オプション B では、実際にクライアントを起動するプロセスの環境も確認します。

フィールドの定義については、公式 OpenAI MCP ガイド および 構成リファレンス を参照してください。

Claude Code: 構成ファイルまたは OAuth

API Key アクセスの場合、このエントリを個人/ローカルの MCP 構成に入れるか、プロジェクトの .mcp.json にマージします。 環境変数はClaude Codeで展開されます。 実際のキーを共有構成から外し、変数を設定して Claude Code を起動します。

{
  "mcpServers": {
    "freelipsync": {
      "type": "http",
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer ${FLS_API_KEY}"}
    }
  }
}

export FLS_API_KEY='YOUR_API_KEY'
claude mcp list

OAuth の場合は、まずキー付きエントリまたはその Authorization ヘッダーを削除し、URL 専用の HTTP サーバーを追加し、対話型 Claude Code セッションで /mcp 経由で認証します。

claude mcp add --transport http --scope user freelipsync https://freelipsync.com/mcp
claude
# In Claude Code, run /mcp and choose Authenticate for freelipsync.

一度に 1 つの方法を使用してください。 構成された無効な Bearer ヘッダーは、別のフローを介してサインインしても修正されません。 Claude Code の公式 MCP ガイド を参照してください。

Claude Desktop および Claude web

OAuth の場合は、Claude の Connectors 管理ページを開き、FreeLipSync という名前のカスタム Web/リモート コネクタを追加し、「https://freelipsync.com/mcp」と入力します。 サインインを選択し、利用可能な場合はクロードの公開されたクライアント ID を使用します。 FreeLipSync 認証ページに入力します。 組織では、まず所有者にコネクタを有効にするよう要求する場合があります。 リモート コネクタはパブリック HTTPS エンドポイントに到達する必要があります。 localhost はクロードのクラウドからアクセスできません。 Claude のリモート コネクタ ガイド を参照してください。

従来の Claude Desktop 設定ファイルを使う場合、stdio のみ対応のクライアントにはリモート接続用のローカルブリッジが必要です。stdio 設定にリモートの url を貼るだけでは接続できません。Node.js / npx を用意し、Desktop の開発者設定から claude_desktop_config.json を開いて次のエントリを追加し、Desktop を再起動します。プレースホルダーは手元で置き換え、個人用ファイルを公開しないでください。

{
  "mcpServers": {
    "freelipsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://freelipsync.com/mcp",
        "--header", "Authorization:${FLS_AUTH_HEADER}"
      ],
      "env": {"FLS_AUTH_HEADER": "Bearer YOUR_API_KEY"}
    }
  }
}

mcp-remote はサードパーティの互換性ブリッジであり、FreeLipSync パッケージではありません。 管理者の指示 とインストールされているバージョンを確認してください。 そのヘッダー引数は環境拡張をサポートします。 上記の形式では、引数内のスペースも避けます。 可能な場合は、クライアントのネイティブ HTTP サポートを優先します。 このデスクトップ ファイルは、Claude web の構成メカニズムではありません。

Cursor: 構成ファイルまたは OAuth

API Key アクセスの場合は、個人の ~/.cursor/mcp.json (または、キーが含まれている場合はソース管理外に置かれたプロジェクト .cursor/mcp.json) を使用します。 プレースホルダーをローカルで置き換えます。 別のクライアントの形式からの環境拡張が、インストールされている Cursor バージョンで機能すると想定しないでください。

{
  "mcpServers": {
    "freelipsync": {
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

OAuth の場合は、ヘッダー オブジェクトを削除して、url のみを含む同じエントリを使用します。 Cursor の MCP 設定で、接続/認証し、ブラウザー認証が提供されている場合はそれを完了します。 構成を変更した後、クライアントをリロードまたは再起動し、Agent モードでツールを確認します。 そのバージョンの登録フローに互換性がない場合は、上記のキー構成を使用してください。 Cursor の公式 MCP 説明書 を参照してください。

VS Code および GitHub Copilot

ネイティブ VS Code MCP 構成の場合、ファイル内に実際のキーではなくパスワードを入力して .vscode/mcp.json を作成します。

{
  "inputs": [
    {"type":"promptString","id":"fls-key","description":"FreeLipSync API Key","password":true}
  ],
  "servers": {
    "freelipsync": {
      "type":"http",
      "url":"https://freelipsync.com/mcp",
      "headers":{"Authorization":"Bearer ${input:fls-key}"}
    }
  }
}

OAuth の場合は、サーバーのタイプと URL を保持したまま、inputs と headers を削除します。 サーバーを起動/接続し、認証プロンプトに従います。 クライアントの登録には、上記で説明した互換性がある必要があります。 Copilot の Agent モードでツールを選択し、以下の確認プロンプトを試してください。 VS Code 形式は、別のクライアントの mcpServers ではなく、servers を使用します。 インタラクティブ入力は、すべての Copilot ハーネスまたはポータブル構成でサポートされているわけではありません。 VS Code MCP リファレンス を参照してください。

ツールを確認してプロンプトを試してください

まずエージェントに尋ねます: 「FreeLipSync を使用して、利用可能なモデルとクレジット残高を確認してください。ビデオはまだ作成しないでください。」 クレジットを消費せずに、get_capabilities と get_usage を呼び出す必要があります。 構成ファイルにサーバーがリストされているだけでは、認証が機能したことを示す十分な証拠にはなりません。

次に試してください: 「私の画像と音声から短い Image Fast トーキング写真を作成します。まず見積もりを取得し、クレジットを教えてください。送信する前に私の確認を待ってください。ローカル ファイルをアップロードできない場合は、ブラウザのアップロード リンクを教えてください。」 支出ツールに対するクライアントの承認を有効にしておきます。

エージェントからのローカル ファイルのアップロード

2 つのローカル ファイル パスと、HTTPS インポートがあります。 ローカル パスを import_asset URL として渡さないでください。

• ファイルの読み取りと HTTP PUT ができるクライアントは、kind、filename、content_type、size_bytes、idempotency_key を指定して create_asset_upload を呼び出します。返された URL に指定ヘッダーで実際のファイルをアップロードし、confirm_asset_upload を呼び出します。署名付きストレージ URL に API Key を送信しないでください。
• ローカル ファイル/HTTP アクセス権のないクライアントは、画像/ビデオ/オーディオごとに create_asset_upload_session を呼び出します。 browser_upload_url を開き、同じ FreeLipSync アカウントにサインインして、ブラウザーにアップロードします。 エージェントは asset_id を保持し、get_asset をポーリングします。 ID をコピーして戻す必要はありません。 アップロード チケットを公に共有しないでください。
• 既存のパブリック HTTPS ファイルの場合、import_asset と kind、url、idempotency_key がインポートを開始します。 準備が整うまで待ってから引用してください。

URL 専用/クラウド コネクタは、MCP を使用するだけではデスクトップ ファイルにアクセスできません。 たとえば、Claude のリモート コネクタはクラウドから実行されるため、クライアントが添付ファイルを署名付き URL に転送できない場合は、ブラウザのアップロード リンクを使用します。

クレジット、再試行、接続管理

API と MCP の消費レートは同じです。Video Lip Sync / Image Fast は毎秒 1 クレジット、Image Max は 2、Image Super / Music Video は 3 です。確認済みの音声時間を秒単位で切り上げ、最低 5 秒として計算します。estimate_generation は total_points と見積もり ID を返し、create_generation はその quote_id と idempotency_key を受け取ります。アップロード、利用状況の照会、見積もりではクレジットを消費しません。受理済みの生成は取り消せず、処理失敗時のみ元の確保額を返還します。API の課金と復旧手順も参照してください。

不確実な送信後は、同じ引用符と冪等性キーを保持してください。 返されたジョブ ID を保存し、クエリします。 エージェントに別のタスクを作成して「再試行」するよう依頼しないでください。 poll_after_seconds を使用してポーリングし、Retry-After でバックオフし、list_generations を使用して複数のアクティブなジョブを一緒にクエリします。 API と MCP はアカウント読み取りバケットを共有し、3 つの Web サイト/API/MCP エントリ ポイントはすべて送信頻度とビデオ実行容量を共有します。 Web サイトと API/MCP には、個別の未完了タスク許容量があります: 各プールの Free 1, Starter 3, Pro 10。 すべての REST/MCP 資格情報は API/MCP プールを共有します。 例については、API/MCP を使用する理由 を参照してください。

Agent コンソールからキーまたは OAuth 接続を取り消します。 キーを取り消すと、REST を含む、そのキーを共有するすべてのクライアントでの今後の使用が停止されます。 OAuth 接続を取り消すと、その接続のみが影響を受けます。 どちらの操作でも、すでに受け付けたタスクはキャンセルされません。 ローカル クライアント エントリを削除するだけでは、FreeLipSync の資格情報は取り消されません。 同時実行性を高めるためではなく、個別の取り消しが必要な場合は、個別のキーまたは独立した承認を使用してください。

トラブルシューティング

クライアント設定はバージョン間で異なる場合があります。 現在の手順については、各クライアントのリンクされた公式ドキュメントを参照してください。 HTTP を直接統合する必要がありますか? API ドキュメント を読んでください。