Imagifly 開発者ドキュメント
エージェント

Claude Code

Anthropic のターミナル向けコーディングエージェントに Imagifly MCP サーバーを追加します。

Claude Code

Claude Code は Anthropic のエージェント型コーディングツールです。コードの読み書き、コマンドの実行、複数ステップにわたる開発タスクの遂行を、ターミナルと IDE 上で行います。Imagifly サーバーを接続すると、作業中に画像や動画も生成できます。

サーバーを追加する

API コンソールで API キーを作成し、環境変数に設定します。
使用しているシェル向けのコマンドを実行します。
Claude Code を再起動するか、/mcp を実行して再接続します。

macOS / Linux の場合:

claude mcp add --transport http imagifly https://imagifly.net/api/mcp \
  --header "Authorization: Bearer $IMAGIFLY_API_KEY"

Windows PowerShell の場合:

claude mcp add --transport http imagifly https://imagifly.net/api/mcp `
  --header "Authorization: Bearer $env:IMAGIFLY_API_KEY"

--scope user を付けると、すべてのプロジェクトでサーバーを利用できます。

claude mcp add --scope user --transport http imagifly https://imagifly.net/api/mcp \
  --header "Authorization: Bearer $IMAGIFLY_API_KEY"
スコープ保存先利用できる範囲
local(デフォルト)~/.claude.json(プロジェクトごと)現在のプロジェクトのみ
projectリポジトリ内の .mcp.jsonリポジトリを開いたすべてのユーザー
user~/.claude.json(グローバル)すべてのプロジェクト

プロジェクト単位の設定

.mcp.json をコミットすると、サーバー定義を共有できます。Claude Code は環境変数から ${IMAGIFLY_API_KEY} を展開するため、シークレットがコミットされることはありません。

{
  "mcpServers": {
    "imagifly": {
      "type": "http",
      "url": "https://imagifly.net/api/mcp",
      "headers": {
        "Authorization": "Bearer ${IMAGIFLY_API_KEY}"
      }
    }
  }
}

`url` には `type` が必要です

Claude Code は type が "http" の場合にのみ url をリモートサーバーとして扱います。type のない url は設定エラーとして報告されます。

確認する

claude mcp list
claude mcp get imagifly

セッション内で /mcp を実行すると、接続状態とそのツールが表示されます。generate_image、get_image_generation、generate_video、get_video_generation、list_image_models、list_video_models が表示されるはずです。

試してみる

Generate a 16:9 image of a paper boat on a rainy windowsill, then show me the image URL.

エージェントは generate_image を呼び出し、タスクが成功するまで get_image_generation でポーリングして、URL を返します。

このページの内容