Eagle Skill サーバー設定ガイド

注意事項:
Eagle MCP プラグインは Eagle 4.0 Build 12(2025-09-14)以降のバージョンが必要です。現在はまだ Beta テスト段階であり、安定性は完全ではありません。また、AI モデルによって能力やパフォーマンスに差異があり、AI が誤った結果や予期しない結果を生成する可能性があります。本プラグインをご利用の際は、必ず 事前にすべてのデータの完全なバックアップを行い、Agent がタスクを実行する前に、タスクの内容と実行の詳細を必ず確認してください。Agent の判断ミスやモデルの制限により、データが意図しない状態に変更されることを防ぐためです。

MCP モードに加えて、Eagle は Eagle Skill を軽量な代替手段として提供しています。AI アシスタントが Eagle 素材ライブラリを直接操作できるようになり、「タグ整理、分類、翻訳、一括管理」など、従来は大量の手作業が必要だった作業を自然言語で完了できます。

すでに Eagle MCP をお使いの場合、Skill と MCP の違いが気になるかもしれません。以下は Skill モードの3つの利点です:

  • Token を大幅に節約:MCP モードではすべてのツール定義が context window に読み込まれますが、Skill モードでは簡潔な Skill の説明のみが読み込まれるため、Token 消費を大幅に削減できます。

  • オンデマンド読み込み:詳細なツールリファレンスは AI が必要とする時のみ読み込まれ、各会話の消費をさらに削減します。

  • 設定不要:MCP クライアントの設定や JSON 設定ファイルの編集は不要です。Skill パッケージを AI ツールの Skills フォルダにコピーするだけで使用できます。

現在 Skill をサポートしている AI ツールには、Claude Code、OpenClaw(ロブスター)、Gemini CLI、Codex、Google Anti-Gravity などがあります。本記事では Claude Code を例に、Eagle Skill の完全な設定手順をご案内します。Eagle MCP プラグインのインストールと起動、Skill パッケージのインストール、AI ツールでの検証を含め、ゼロから AI を素材ライブラリのワークフローに接続する方法をご説明します。


Skill とは?

Skill は AI の「スキルパック」と考えることができます。事前に作成された指示とツールリファレンスのセットで、AI が特定のツールを操作したり、特定のタスクを実行する方法を学習できるようにするものです。Eagle Skill をインストールすると、AI ツールが Eagle 素材ライブラリとのやり取り方法を理解できるようになります。素材の検索、タグの管理、フォルダの整理など、すべて自然言語で完了できます。

MCP とは異なり、Skill は追加のサーバープロトコル設定を必要としません。SKILL.md 説明ファイルと補助スクリプトを含むフォルダを指定の場所に配置するだけで、AI が自動的に検出して読み込みます。Skill は Agent Skills オープンスタンダードに準拠しており、現在 Claude Code、OpenClaw(ロブスター)、Gemini CLI、Codex、Google Anti-Gravity など、多くの主要 AI ツールがサポートしています。

以下は Anthropic チームが制作した Skill の紹介動画です。Skill の仕組みとコンセプトを素早く理解するために、ぜひご覧ください:

Eagle Skill サーバー設定ガイド

YouTube プレーヤーを読み込む

Eagle Skill でできること

Eagle Skill は素材管理ワークフロー向けに、デザイン・クリエイティブのニーズにより密着した操作機能を提供します。

主な機能・特徴

  • スマートタグシステム分析

    タグの使用パターンを分析し、同義語グループ(例:「猫 / cat / ねこ」)、スペル変体、使用頻度を検出し、統合・廃止・標準化の提案を行います。

  • 自然言語で複雑なタスクを制御

    「条件付きの検索と整理」指示を出すことができます。例えば、フォルダ、星評価、期間、既存のタグセットで整理範囲を制限できます。

  • クラウドとローカルモデルの統合

    予算やプライバシーの要件に応じて、クラウドモデルまたはローカルモデルを選択できます(実際のサポート範囲はお使いの AI ツールとモデルサービスによって異なります)。

💡 モデルの推奨:Claude Sonnet 4.5 以降のバージョン
Eagle Skill で比較的複雑な、または複数ステップの推論が必要なタスク(タグのグルーピング分析、一括分類提案など)を実行する場合、Claude Sonnet 4.5 以降のバージョンを強くお勧めします。Claude シリーズは「Tool Use(ツール呼び出し)」について専門的にトレーニングされており、指示構造と返却フォーマットをより正確に理解でき、ツールを複数回呼び出して構造化された結果を生成するシナリオで特に安定したパフォーマンスを発揮します。予算面での制約がある場合は、Claude Haiku 4.5 にダウングレードすることも可能です。ツール呼び出しの精度は Sonnet よりやや低くなりますが、実行速度とコスト面で優れており、テスト段階や重要度の低いタスクに適しています。


Eagle Skill のインストール

Part 1:Eagle MCP プラグインのインストール

Eagle Skill は Eagle MCP プラグインが提供するローカルサーバーが必要なため、最初のステップとしてプラグインをインストールして有効化します。

  1. Eagle アプリケーションを開きます

  2. 上部メニューの「プラグイン」→「プラグインセンター」をクリックします

  3. 検索バーに「MCP」と入力します

  4. 「Eagle MCP」プラグインを見つけて「インストール」をクリックします

  5. インストール完了後、プラグインリストで「有効化」ボタンをクリックします

  6. 初回有効化時に MCP サーバーが自動的に起動します(デフォルトポート:41596)。システムにサーバーステータスが表示されます:✅ 起動済み

Part 2:プロジェクトフォルダの準備

AI Agent の作業ディレクトリとなる専用フォルダを作成します。この手順は一度だけ行えば OK です。

  1. コンピュータ上の任意の場所(例:~/Projects/)に新しいフォルダを作成します。名前は自由に決められます——本ガイドでは Eagle Agent とします。
  2. Eagle Agent フォルダの中に、.claude という名前のフォルダを作成します。macOS では、ドットで始まる名前は不可視ファイルとして扱われるという警告が表示されます——「"."を使用」をクリックして確認してください。
  3. .claude フォルダの中に、skills という名前のフォルダを作成します。

完了後、フォルダ構造は以下のようになります:

コード
Eagle Agent/
└── .claude/
    └── skills/        ← 次のステップでこのフォルダを指定します

Part 3:Eagle MCP プラグインから Skill をインストール

  1. Eagle MCP プラグインの設定パネル(環境設定 → Eagle MCP)を開きます。下にスクロールして Eagle Skill セクションを見つけてください。「+ Skill をインストール」と「使い方」の2つのボタンが表示されます。
  2. 「+ Skill をインストール」をクリックします。フォルダ選択ダイアログが表示されます。
  3. 先ほど作成した skills フォルダ(Eagle Agent/.claude/skills)に移動し、選択して「開く」をクリックします。

プラグインが自動的に eagle-skill パッケージを対象の場所にコピーします。Finder で確認できます——フォルダ構造は以下のようになります:

コード
Eagle Agent/
└── .claude/
    └── skills/
        └── eagle-skill/
            ├── SKILL.md
            ├── scripts/
            └── references/

Part 4:Claude Code でインストールを検証

ターミナルを開き、以下の手順ですべてが正常に動作していることを確認します。

  1. プロジェクトフォルダに移動し、Claude Code を起動します:

  2. Claude Code が起動したら、スラッシュコマンド /skills を入力して利用可能な Skills を一覧表示します。「Project skills (.claude/skills)」の下に eagle が表示されるはずです。

  3. Esc キーを押して Skills ダイアログを閉じ、テスト用の質問を入力します:

    コード
    私の Eagle ソフトウェアのバージョンは?
    
  4. Claude が eagle-skill の使用許可を求めてきます——「Yes」(または「Yes, and don't ask again」)を選択して許可します。

Claude が Eagle のバージョンとライブラリ名を正しく返答した場合(例:「Eagle 4.0.0 を macOS で実行中です……」)、Skill は正常にインストールされ、使用可能な状態です。その他の AI ツールをお使いの場合も、検証方法は同様です。ツールを開いた後、Eagle に関連する質問を試みてください。


プライバシーとデータ漏洩に関する説明(必ずお読みください)

Eagle Skill を使用する際、データが「お使いのコンピュータから外部に送信されるかどうか」は、主に クラウドモデルと ローカルモデルのどちらを使用するかによって決まります:

クラウドモデル(Cloud LLM)を使用する場合

推論プロセス中に、「ファイル名、タグ、注釈、検索条件、要約」などの情報がモデルサービスプロバイダーに送信され、推論と応答の完了に使用される場合があります。

推奨する対策:

  • 機密性の高い素材(契約書、個人情報、未公開プロジェクト)を Agent による一括処理に直接かけないようにしてください
  • まず小さなフォルダでテストし、リスクが許容範囲であることを確認してから範囲を拡大してください

ローカルモデル(Local LLM)を使用する場合

データは通常クラウドに送信する必要がなく、プライバシーリスクは比較的低くなります。ただし、ローカルモデル間では品質、速度、ツール呼び出しの安定性にばらつきがあります。

補足説明:Eagle MCP サーバー自体はローカルで動作し、AI の「指示」を Eagle の「制御可能な操作」に変換する役割を担います。実際のデータ外部送信は通常、MCP 自体ではなく、選択したモデルの推論段階で発生します。


権限とセキュリティに関する推奨事項(誤操作リスクの低減)

Eagle Skill は非常に強力な機能を持つため、「一度に大量の変更」が行われる可能性があります。以下の SOP を常に遵守することをお勧めします:

  • 分析してから実行:まず AI に提案と「予定変更リスト」を出力させ、問題がないことを確認してから実行します
  • 小規模でテスト:少数のファイルや単一のフォルダから始めて、段階的に範囲を拡大します
  • タスクを分割:一言でライブラリ全体を整理することは避け、2〜5 のステップに分割するとより管理しやすくなります
  • 範囲を明確に限定:フォルダ、ファイル数、期間、タグセットを指定します
  • 読み取り専用タスクから開始:バージョン照会、統計、候補リストなどでフローを検証してから、一括変更を行います

Eagle Skill 実践例(そのままコピーして使用可能)

各例の前に「まず変更リストを出力してください。直接実行しないでください」という一文を追加し、安全な使用習慣を身につけることをお勧めします。

例 1:多言語タグ翻訳(まずリストを出力)

コード
フォルダ「/日本素材」内のタグをスキャンしてください。
日本語文字を含むタグを見つけて英語に翻訳し、
まず「日本語タグ → 英語タグ」の対照リストと影響するファイル数を出力してください。
確認後に英語タグを一括追加します。

例 2:タグ使用頻度分析とクリーンアップ提案(読み取り専用)

コード
Eagle のタグ使用状況を分析してください:
1) 使用頻度が 3 回未満のタグを一覧表示
2) 同義語・重複の可能性があるタグのグループを検出(スペルミスを含む)
3) 提案を提示:統合に適したもの、廃止に適したもの
まずレポートを出力し、変更は一切行わないでください。

例 3:新規インポートファイルの分類提案(まず提案、その後移動)

コード
最近追加された 10 個のファイルを分析してください。
ファイルタイプと既存のフォルダ構造に基づいて、
まず「提案する分類パス + 提案するタグ」のリストを出力し、
各提案の信頼度スコアまたは理由を記載してください。
確認後に移動とタグの適用を実行します。

例 4:単一ファイルの内容分析と完全なアーカイブ提案(まず分析)

コード
まず変更リストを出力してください。直接実行しないでください。

現在選択中のファイルを分析し、以下の分析を順に実行してください:
1) ファイルのフルパスとファイル名を読み取る
2) 画像の内容を分析し、検索に使える説明文を生成する(客観的・具体的に)
3) 「提案タグ」のセットを提示する(過度に抽象的なものは避け、再利用可能なキーワードを優先)
4) 既存のフォルダ構造に基づいて、最適な分類パスを提案する(単一パス)

以下の形式でリスト出力してください:
- ファイル名
- 提案する説明文
- 提案するタグ(リスト)
- 提案するフォルダパス
- 各提案の理由または信頼度の説明

確認後、実際の説明文の書き込み、タグの適用、ファイルの移動を実行します。

例 5:空の素材ライブラリの分野別フォルダ構造設計(構造の出力のみ)

コード
まず構造の提案を出力してください。フォルダは作成しないでください。

これは新しい空の Eagle 素材ライブラリです。
「ゲームデザイン(Game Design)」関連のインスピレーション画像を
整理する専用として使用する予定です。

フォルダ分類構造を設計してください。要件は以下の通りです:
1) 約 5 つの「第1階層カテゴリ」
2) 各第1階層カテゴリの下に 5〜10 の「第2階層サブカテゴリ」
3) 各第1階層カテゴリについて以下を提供:
   - フォルダの用途説明
   - 推奨するアイコンタイプ
   - アイコンの色(視覚的な区別のため、カテゴリ間で重複しないようにしてください)

出力フォーマットには以下を含めてください:
- 第1階層カテゴリ名
  - 用途説明
  - アイコンの推奨(形状 / タイプ)
  - アイコンの色
  - 第2階層サブカテゴリリスト(簡単な説明付き)

全体的な設計は「実用的、長期的に拡張可能、陳腐化しにくい」ことを重視してください。
全体構造を確認後、実際にフォルダを作成します。

よくある質問(トラブルシューティング)

Q1:Skill をインストールしたのに AI ツールが見つけられない場合

  • eagle-skill フォルダが AI ツールの Skills フォルダに正しく配置されていることを確認してください(例:Claude Code の場合は ~/.claude/skills/eagle-skill/)
  • フォルダ内に SKILL.md ファイルが含まれていることを確認してください
  • AI ツールを再起動してみてください(完全に閉じてから再度開く)
  • AI に「利用可能な Skills は何ですか?」と尋ねて、読み込まれているか確認してください

Q2:Skill は存在するが AI が Eagle ツールを呼び出さない場合

  • Eagle が動作中であり、Eagle MCP プラグインが ✅ 起動済み と表示されていることを確認してください(Skill もローカルサーバーが動作している必要があります)
  • まず読み取り専用の質問でテストしてください(バージョン照会、タグ統計、候補リスト)
  • 場合によっては「Eagle Skill を使って照会してください」と明示的に補足してください
  • ローカルサーバーのエンドポイントに正常にアクセスできることを確認してください:http://localhost:41596/mcp

Q3:結果が異常または誤っている場合

  • まず「変更リスト」と「影響範囲」の出力を要求し、直接適用しないようにしてください
  • タスクを分割し、フォルダの範囲を絞り、1回あたりの処理ファイル数を減らしてください

Q4:Skill と MCP の違いは?どちらを使うべき?

比較項目 MCP モード Skill モード
対応ツール Claude Desktop、Cursor、Claude Code など、すべての MCP クライアント Claude Code、OpenClaw(ロブスター)、Gemini CLI、Codex、Google Anti-Gravity など、Agent Skills 標準に対応するツール
Token 消費 高い(すべてのツール定義が context window に読み込まれる) 低い(Skill の説明のみ読み込み、リファレンスはオンデマンド読み込み)
設定方法 JSON 設定ファイルの編集またはツール UI での設定が必要 フォルダを
~/.claude/skills/
にコピーするだけ
サーバー要件 必要(Eagle MCP プラグインがローカルサーバーを提供) 必要(同様に Eagle MCP プラグインのローカルサーバーに依存)
適した場面 Cursor、Claude Desktop など複数の AI ツールを使用する場合 Skill 対応の AI ツールを使用し、Token の節約と設定の簡素化を求める場合

簡単に言えば:お使いの AI ツールが Skill をサポートしている場合(Claude Code、OpenClaw、Gemini CLI、Codex、Google Anti-Gravity など)、より優れた Token 効率とより簡便な設定プロセスのために Skill モードをお勧めします。Cursor、Claude Desktop、またはその他 MCP のみをサポートするツールをお使いの場合は、Eagle MCP サーバー設定ガイドを参照して設定してください。両方のモードは同時にインストールでき、互いに干渉しません。

サイト内を検索

↑ ↓ 選択 · Enter 開く · Esc 閉じる