faktry について
faktry MCPは、faktryのメディアツールをMCP対応クライアントに公開し、画像、動画、音声、PDF、3Dアセットの生成と編集に使えます。AIクライアントでメディアを扱うユーザー向けに、ホスト型サーバー、非同期ジョブ追跡、再利用可能なメディアライブラリを備えています。
主な機能
- 01画像、動画、音声の生成と編集
- 02PDFの作成と操作
- 03テキストや画像から3Dアセットを生成
- 04非同期生成ジョブの追跡
- 05ライブラリアセットの保存と閲覧
- 06アカウントのクレジットと使用量の確認
活用シーン
- 01商品画像の作成と修正
- 02商品画像から字幕付き動画を作成
- 03ナレーションや音楽の生成と音声編集
- 04PDFの作成、結合、内容の抽出
MCP 対応
ホスト型MCPサーバーは、メディア生成・編集、ジョブ状態、クレジット、ライブラリ管理の70以上のツールを公開します。クライアントはOAuthまたはAPIキーでリモート接続でき、stdioブリッジも利用できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://faktry.ai/api/mcpclaude mcp add --transport http faktry-faktry https://faktry.ai/api/mcp{"mcpServers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}Cursor で開く{"servers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}VS Code で開く{"mcpServers":{"faktry-faktry":{"type":"http","url":"https://faktry.ai/api/mcp"}}}{"mcpServers":{"faktry-faktry":{"serverUrl":"https://faktry.ai/api/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
faktry MCP
faktry のメディアスタック全体を、いつも使っているツールで利用できます。
MCP 互換クライアントから画像、動画、音声、PDF を生成・編集できます。
インストール · ツール · 使用例 · トラブルシューティング
faktry MCP サーバーは、画像、動画、音声、PDF、3D の生成・編集に対応する70以上のツールを備えた faktry のツールキット全体を、Model Context Protocolに対応するあらゆるクライアントに提供します。チャットから離れることなく、商品写真を生成し、ナレーション付きの UGC 風動画に仕上げ、字幕を付け、サムネイル一覧を書き出せます。
ホスト型のリモートサーバーです。 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
- Claude.ai を開き、Settings → Integrations に移動します。
- Add MCP Server をクリックし、上記の URL を貼り付けます。
- Claude.ai から faktry にリダイレクトされます。サインインして Approve をクリックします。
- これで完了です。Claude.ai がトークンを自動的に保存します。
Claude Desktop
- Claude Desktop を開き、Settings → Developer → MCP Servers に移動します。
- Add Server をクリックし、上記の URL を貼り付けます。
- ブラウザーウィンドウが開きます。faktry にサインインして Approve をクリックします。
- ツールがすぐに表示されない場合は、Claude Desktop を再起動します。
Cursor
- Cursor を開き、Settings → AI → MCP Servers に移動します。
- Add MCP Server をクリックし、上記の URL を貼り付けます。
- Cursor が OAuth を検出し、ブラウザーのログインウィンドウを開きます。
- faktry にサインインしてアクセスを承認し、Cursor に戻ります。
Hermes Agent
- Hermes Agent を開き、Settings → MCP Servers に移動します。
- + をクリックし、上記の URL を貼り付けます。
- Hermes がブラウザーでログイン画面を開きます。faktry にサインインして承認します。
- サーバーをオンにすると、ツールがすぐに表示されます。
ChatGPT Desktop (Business/Enterprise/Edu のみ)
- Settings → Beta Features で Developer Mode を有効にします。
- Settings → MCP Servers → Add Server に移動します。
- 上記の URL を貼り付け、ブラウザーで OAuth の手順に従います。
まず 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
- Kilo Code 拡張機能の設定 → MCP サーバーを開きます。
- 上記の Claude Code と同じ JSON スニペットを使って、新しいサーバーを追加します。
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, mdconvert | PDF の作成と加工 |
faktry_3d_* | image23d, text23d | 画像またはテキストからの 3D アセット生成 |
ユーティリティツールもあります。
| ツール | 機能 |
|---|---|
faktry_job_status | job_id を指定して非同期ジョブを completed になるまで確認し、result_url を返します |
faktry_credits | クレジット残高と当月の使用量を確認します |
faktry_library_list | 以前に保存したメディアアセットを参照します |
faktry_library_save | 結果の URL をライブラリに保存し、セッションをまたいで再利用できるようにします |
非同期ジョブのパターン
多くの生成ツール(動画、一部の画像/音声ツール)は非同期です。
- 生成ツールを呼び出す →
job_idを受け取ります。 - 数秒おきに、その
job_idを指定してfaktry_job_statusを確認します。 - ステータスが
completedになると、レスポンスにresult_urlが含まれます。 - 必要に応じて
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 をポーリングし続けてください。
リンク
- MCP セットアップ UI — faktry.ai/mcp
- APIキー — faktry.ai/api/keys
- faktry — faktry.ai
ライセンス
MIT © faktry
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。