mcpField
F
faktry

faktry

リモート
faktry.aiメディア・デザイン13 週間前に更新
リポジトリ公式サイト

faktry について

faktry MCPは、faktryのメディアツールをMCP対応クライアントに公開し、画像、動画、音声、PDF、3Dアセットの生成と編集に使えます。AIクライアントでメディアを扱うユーザー向けに、ホスト型サーバー、非同期ジョブ追跡、再利用可能なメディアライブラリを備えています。

主な機能

  1. 01画像、動画、音声の生成と編集
  2. 02PDFの作成と操作
  3. 03テキストや画像から3Dアセットを生成
  4. 04非同期生成ジョブの追跡
  5. 05ライブラリアセットの保存と閲覧
  6. 06アカウントのクレジットと使用量の確認

活用シーン

  1. 01商品画像の作成と修正
  2. 02商品画像から字幕付き動画を作成
  3. 03ナレーションや音楽の生成と音声編集
  4. 04PDFの作成、結合、内容の抽出

MCP 対応

ホスト型MCPサーバーは、メディア生成・編集、ジョブ状態、クレジット、ライブラリ管理の70以上のツールを公開します。クライアントはOAuthまたはAPIキーでリモート接続でき、stdioブリッジも利用できます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://faktry.ai/api/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

パッケージ
npm@faktry/mcp0.1.1

ツール

詳細

faktry

faktry MCP

faktry のメディアスタック全体を、いつも使っているツールで利用できます。
MCP 互換クライアントから画像、動画、音声、PDF を生成・編集できます。

ライセンス:MIT ドキュメント

インストール · ツール · 使用例 · トラブルシューティング

faktry プラットフォーム


faktry MCP サーバーは、画像、動画、音声、PDF、3D の生成・編集に対応する70以上のツールを備えた faktry のツールキット全体を、Model Context Protocolに対応するあらゆるクライアントに提供します。チャットから離れることなく、商品写真を生成し、ナレーション付きの UGC 風動画に仕上げ、字幕を付け、サムネイル一覧を書き出せます。

  • README の画像 ホスト型のリモートサーバーです。 https://faktry.ai/api/mcp に接続するだけで、ローカルサーバーを起動する必要はありません。stdio のみ対応するクライアントでは、npx -y @faktry/mcp ブリッジを利用できます。
  • OAuth と API キーから選べます。 Claude.ai、Claude Desktop、Cursor、Hermes からワンクリックで接続するか、設定ベースのクライアントに静的 API キーを入力できます。
  • デフォルトで非同期です。 動画や一部の画像・音声など、時間のかかるジョブはすぐに job_id を返します。準備が整うまで faktry_job_status をポーリングしてください。
  • 結果を記憶するライブラリです。 faktry_library_save で結果を保存し、後のセッションで faktry_library_list を使って呼び出せます。
  • 料金は faktry アカウント経由で支払います。 利用分は既存のクレジット残高から差し引かれます。faktry_credits でいつでも残高を確認できます。

インストール

ワンクリック/OAuth

これらのクライアントでは認証が自動で処理されます。URL を貼り付けてサインインし、承認してください。

MCP サーバー URL:

https://faktry.ai/api/mcp
Claude.ai
  1. Claude.ai を開き、Settings → Integrations に移動します。
  2. Add MCP Server をクリックし、上記の URL を貼り付けます。
  3. Claude.ai から faktry にリダイレクトされます。サインインして Approve をクリックします。
  4. これで完了です。Claude.ai がトークンを自動的に保存します。
Claude Desktop
  1. Claude Desktop を開き、Settings → Developer → MCP Servers に移動します。
  2. Add Server をクリックし、上記の URL を貼り付けます。
  3. ブラウザーウィンドウが開きます。faktry にサインインして Approve をクリックします。
  4. ツールがすぐに表示されない場合は、Claude Desktop を再起動します。
Cursor
  1. Cursor を開き、Settings → AI → MCP Servers に移動します。
  2. Add MCP Server をクリックし、上記の URL を貼り付けます。
  3. Cursor が OAuth を検出し、ブラウザーのログインウィンドウを開きます。
  4. faktry にサインインしてアクセスを承認し、Cursor に戻ります。
Hermes Agent
  1. Hermes Agent を開き、Settings → MCP Servers に移動します。
  2. + をクリックし、上記の URL を貼り付けます。
  3. Hermes がブラウザーでログイン画面を開きます。faktry にサインインして承認します。
  4. サーバーをオンにすると、ツールがすぐに表示されます。
ChatGPT Desktop (Business/Enterprise/Edu のみ)
  1. Settings → Beta Features で Developer Mode を有効にします。
  2. Settings → MCP Servers → Add Server に移動します。
  3. 上記の URL を貼り付け、ブラウザーで OAuth の手順に従います。
### 設定ファイル/API キー

まず faktry.ai/api/keys で API キーを作成し、クライアントの設定に faktry を追加します。YOUR_API_KEY_HERE を実際のキーに置き換えてください。キーが表示されるのは作成時の一度だけです。

Claude Code

.mcp.json(プロジェクト)または ~/.claude.json(ユーザー)に追加します。

{
  "mcpServers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

自動的に認識されるため、再起動は不要です。

VS Code (Copilot)

.vscode/mcp.json(ワークスペース)に追加するか、設定 → MCP サーバーから追加します。

{
  "servers": {
    "faktry": {
      "type": "http",
      "url": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json(Windows の場合は %USERPROFILE%\.codeium\windsurf\mcp_config.json)を編集します。Windsurf では url ではなく serverUrl を使用する点に注意してください。

{
  "mcpServers": {
    "faktry": {
      "serverUrl": "https://faktry.ai/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY_HERE" }
    }
  }
}

ツールを有効にするには Windsurf を再起動してください。

Continue.dev

~/.continue/config.yaml に追加します。

mcpServers:
  faktry:
    type: http
    url: https://faktry.ai/api/mcp
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_API_KEY_HERE"

Continue.dev は自動的に再読み込みします。

Codex CLI

~/.codex/config.toml に追加します。

[mcp.servers.faktry]
type = "http"
url = "https://faktry.ai/api/mcp"

[mcp.servers.faktry.headers]
Authorization = "Bearer YOUR_API_KEY_HERE"

codex mcp list で確認してください。

stdio クライアント(npx) — Zed、古い Claude Desktop の設定、リモート MCP に対応していないもの

@faktry/mcp パッケージは、ホスト型サーバーへのシンプルな stdio ブリッジです。Node 18 以降が必要です。

一般的な形式:

FAKTRY_API_KEY=YOUR_API_KEY_HERE npx -y @faktry/mcp

Claude Desktop(claude_desktop_config.json)およびその他のほとんどの mcpServers クライアント:

{
  "mcpServers": {
    "faktry": {
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Zed(settings.json、Windows の場合は %APPDATA%\Zed\settings.json):

{
  "context_servers": {
    "faktry": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@faktry/mcp"],
      "env": { "FAKTRY_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

代わりにブラウザーからサインイン(OAuth)する場合は、FAKTRY_API_KEY を省略してください。

Kilo Code
  1. Kilo Code 拡張機能の設定 → MCP サーバーを開きます。
  2. 上記の Claude Code と同じ JSON スニペットを使って、新しいサーバーを追加します。
  3. YOUR_API_KEY_HERE を実際のキーに置き換えます。
その他の MCP クライアント

https://faktry.ai/api/mcp を指定するリモート HTTP サーバーを追加し、次のヘッダーを設定します。

Authorization: Bearer YOUR_API_KEY_HERE

クライアントごとのスニペットとパスも faktry.ai/mcp で生成できます。


ツール

クライアントはプロンプトに基づいて呼び出すツールを選ぶため、ツール名を指定して呼び出す必要はありません。faktry は 5 つのカテゴリにわたって 70 以上のツールを提供します。

カテゴリ例対応する機能
faktry_image_*generate, edit, inpaint, outpaint, upscale, removebackground, effects, collage, watermark, smartcropテキストからの画像生成、編集、アップスケーリング、背景除去、合成
faktry_video_*text2video, image2video, avatar, motioncontrol, subtitle, reframe, stabilize, upscale, scenedetect生成、編集、アバター、モーションコントロール、字幕、リフレーム
faktry_audio_*generatespeech, clonevoice, generatemusic, generatesound, mix, transcribe, trim音声合成、音声クローン、音楽/効果音の生成、ミキシング
faktry_pdf_*create, merge, split, compress, extract, mdconvertPDF の作成と加工
faktry_3d_*image23d, text23d画像またはテキストからの 3D アセット生成

ユーティリティツールもあります。

ツール機能
faktry_job_statusjob_id を指定して非同期ジョブを completed になるまで確認し、result_url を返します
faktry_creditsクレジット残高と当月の使用量を確認します
faktry_library_list以前に保存したメディアアセットを参照します
faktry_library_save結果の URL をライブラリに保存し、セッションをまたいで再利用できるようにします
非同期ジョブのパターン

多くの生成ツール(動画、一部の画像/音声ツール)は非同期です。

  1. 生成ツールを呼び出す → job_id を受け取ります。
  2. 数秒おきに、その job_id を指定して faktry_job_status を確認します。
  3. ステータスが completed になると、レスポンスに result_url が含まれます。
  4. 必要に応じて faktry_library_save で保存します。

プロンプトの例

faktryを接続したら、以下をお試しください。

Generate a studio product shot of a matte black wireless speaker on a
white background, then upscale it to 4K.
Turn this product image into a 9:16 UGC-style video with a voiceover
reading the description, and add subtitles.
Remove the background from this photo, then composite it onto a
gradient backdrop.
Clone this voice sample and generate a 30-second narration reading
this script.
Check my faktry credits, then show me what's in my library.

トラブルシューティング

接続後にツールが表示されない
  • Claude.ai / Desktop: Settings → Integrations(または Developer → MCP Servers)で、faktryが接続済みになっていることを確認してください。接続に失敗したことが通知されなかった場合は、削除して再追加してください。OAuthウィンドウを開けるよう、ポップアップがブロックされていないことを確認してください。
  • Claude Code: claude mcp list にサーバーが表示されるはずです。
  • Codex: codex mcp list に faktry が表示されるはずです。追加後、新しいセッションを開始してください。
  • 簡単な動作確認:クライアントに 「faktryのクレジットを確認して」 と尋ねてください。
認証またはAPIキーのエラー
  • 設定ファイルを使うクライアントの場合、YOUR_API_KEY_HERE が faktry.ai/api/keys で発行した有効なキーに置き換えられていることを確認してください。キーは作成時にのみ表示されます。
  • OAuthクライアントの場合は、コネクターを切断して再接続し、認証フローをやり直してください。
生成処理が読み込み中のままになる

動画のレンダリングや一部の音声・画像ジョブは、通常の画像生成より時間がかかります。ツールは保留中の job_id をすぐに返します。completed と表示されるまで faktry_job_status をポーリングし続けてください。


リンク


ライセンス

MIT © faktry

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。