エージェント
MCP サーバー
Model Context Protocol に対応したあらゆるエージェントに Imagifly を接続します。
Imagifly は次のリモート MCP サーバーを提供しています。
https://imagifly.net/api/mcpStreamable HTTP トランスポートを使用し、HTTP API と同じ API キーで認証して、6 つのツールを公開します。リモート HTTP サーバーに対応した MCP クライアントであれば接続できます。ここでは、当社が動作確認しているクライアントを順に説明します。
ツール
| ツール | 機能 |
|---|---|
list_image_models | 画像モデルのカタログ。クレジット価格と上限を含みます。 |
generate_image | テキストから画像を生成するタスクを送信します（参照画像、比率、品質、解像度、ステップは任意）。 |
get_image_generation | 画像タスクをポーリングし、画像 URL を取得します。 |
list_video_models | 動画モデルのカタログ。サイズ、長さ、対応ワークフローを含みます。 |
generate_video | テキストから動画、参照から動画、最初/最後のフレームを使うタスクを送信します。 |
get_video_generation | 動画タスクをポーリングし、動画 URL を取得します。 |
ツール呼び出しは HTTP API を薄くラップしたものです。モデル、クレジット、エラーコードはすべて同じです。生成は引き続き非同期なので、エージェントは通常 generate_* を 1 回呼び出し、タスクが完了するまで get_* を呼び出します。
認証
すべてのリクエストでヘッダーにキーを渡します。
Authorization: Bearer imf_your_key_herex-api-key: imf_your_key_here も使用できます。キーは API コンソールで作成してください。
手動での設定
ほとんどのクライアントでは、同じ JSON 設定をそのまま使えます。
{
"mcpServers": {
"imagifly": {
"type": "http",
"url": "https://imagifly.net/api/mcp",
"headers": {
"Authorization": "Bearer imf_your_key_here"
}
}
}
}クライアントが対応している場合は、環境変数の展開（${IMAGIFLY_API_KEY} または ${env:IMAGIFLY_API_KEY}）を使い、キーをディスクに書き込まないようにしてください。
クライアントを選ぶ
Claude Code
Anthropic のターミナル向けコーディングエージェント。CLI コマンド 1 つで追加できます。
Codex
OpenAI Codex CLI。CLI コマンド 1 つで追加できます。
OpenClaw
セルフホスト型のエージェントゲートウェイ。JSON 設定を編集します。
WorkBuddy
Tencent の AI オフィスエージェント。設定画面からサーバーを追加します。
Cursor
Anysphere の AI エディタ。mcp.json を編集します。
接続を確認する
エージェントにツール一覧を表示させてください。正常に接続できていれば、上記の 6 つの imagifly ツールが表示されます。サーバーには接続済みと表示されるのにツールが一覧に出ない場合、通常はリクエストが未認証です。ヘッダーが Authorization: Bearer imf_... の形式どおりに送信されているか確認してください。