AI アシスタントで Aggrega をセットアップする
マシン上でコマンドを実行できる AI アシスタント(ターミナルやエディターで動くコーディングエージェント)は、Aggrega のセットアップを代わりに行えます。aggrega バイナリをインストールし、Aggrega のスキルを自身に追加し、自身を Aggrega MCP サーバーに接続します。プラグインをインストールできるアシスタントは、Aggrega プラグインをインストールすることで後の 2 つを 1 つの手順で行い、それ以外のアシスタントはスキルの追加とサーバーの接続を順に行います。下のプロンプトを貼り付けると、アシスタントはこれらの手順を順に進めます。プロンプトは、何かをインストールする前に確認を取るようアシスタントに指示しています。
完了すると、アシスタントには Aggrega を扱う方法が 2 つあります。スキルは SKILL.md ファイルを収めたフォルダーで、リクエストが Aggrega に関わるときにアシスタントが読み込みます。スキルはオーサリングのループがどう進むかをアシスタントに伝え、スキーマやファイルに関するすべての回答を記憶からではなくバイナリから得るよう指示します。MCP サーバー aggrega mcp は、Aggrega のツール(scaffold、validate、build など)と、それらのツールが参照するリファレンス資料をアシスタントに提供します。スキルとプラグインについては Aggrega スキル、サーバーについては MCP サーバーの接続、サーバーを通じてアシスタントが利用できるものについてはアシスタントが Aggrega でできることで説明しています。
セットアップが完了すると、はじめに、インポートの各ウォークスルー、そして Aggrega でビルドされる各実行可能な例のページでは、コマンドの横に、それぞれが教えるタスクがアシスタントに貼り付けるプロンプトとして示されます。
プロンプト
Aggrega をセットアップしてください。1 ステップずつ進め、各ステップで何を実行したかを教えてください。
1. `aggrega version` を実行してください。コマンドが見つからない場合は、Aggrega をインストールする前に私に確認し、そのうえで公式インストーラーを使って私のユーザーにインストールしてください。Linux または macOS では `curl -fsSL https://aggrega.ai/install.sh | sh`、Windows の PowerShell では `irm https://aggrega.ai/install.ps1 | iex` です。もう一度 `aggrega version` を実行してください。インストーラーが私の `PATH` に追加する行を表示した場合は、それを見せてください。2. `https://aggrega.ai/docs/ai-assistants/skill/` に自分へ Aggrega プラグインをインストールする方法が記載されている場合は、インストールする前に私に確認し、その方法でインストールしてください。それが私がインターフェースで行う手順である場合は、私が何をすればよいかを教えてください。プラグインは Aggrega スキルを追加し、Aggrega MCP サーバーへの接続を行います。そうでない場合は、`aggrega skills install --help` を実行し、表示される一覧から自分自身の識別子を見つけてください。スキルをこのプロジェクトに入れるか、すべてのプロジェクトに入れるかを私に確認し、そのうえで `aggrega skills install --agent <your identifier>` を実行してください。すべてのプロジェクトの場合は `--global` を付けます。一覧に自分がない場合は、スキルのインストールを省略し、その旨を伝えてください。3. プラグインをインストールした場合は、すでに Aggrega MCP サーバーに接続されています。そうでない場合は、MCP サーバーを追加するときの自分の方法で、Aggrega MCP サーバー(コマンド `aggrega mcp`)に自分自身を接続してください。その方法は `https://aggrega.ai/docs/ai-assistants/mcp-server/` に自分向けに記載されています。プラグインやサーバーを読み込むために再起動や再読み込みが必要な場合は、私が何をすればよいかを教えてください。4. 接続したら、引数なしで `describe-capabilities` ツールを呼び出し、それが一覧表示する内容を要約してください。プロンプトは、ドキュメントが公開されているどの言語でも同じです。翻訳されるのは文だけで、その中のコマンド、フラグ、アドレス、ツール名はすべて書かれたとおりのままです。そのため、どの言語からコピーしても、アシスタントは同じ指示を読み取ります。
インストーラーは最新のリリースをダウンロードし、そのリリースで公開されている SHA-256 ダイジェストと照合して、管理者権限なしで現在のユーザーにのみインストールします。インストーラーが行うことと、代わりに手動でインストールする方法はバイナリのインストールで説明しています。
アシスタントごとに異なる点
プロンプトのうち 3 つの部分はアシスタントによって異なります。プラグインをインストールできるアシスタントであれば Aggrega プラグインのインストール方法、そうでなければ、スキルをインストールするときに --agent に渡す識別子と、サーバーを追加する方法です。アシスタントはこれらをプロンプトから判断しますが、分かっている場合はプロンプトに書き込んでおくこともできます。
| アシスタント | プラグインのインストール | プラグインを使わないスキルのインストール |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills の後に codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills の後に copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity、Antigravity CLI の場合は --agent antigravity-cli |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega の後に Developer: Reload Window | aggrega skills install --agent cursor |
GitHub Copilot を使う Visual Studio Code、Kiro、OpenClaw もプラグインをインストールします。各アシスタントでの方法と、OpenClaw がインストール前に確認する内容はプラグインのインストールに記載されています。--agent が受け付ける識別子と、それぞれが書き込むフォルダーは、aggrega skills に一覧があり、aggrega skills install --help でも表示されます。各アシスタントがサーバーを追加する方法(独自のコマンド、または設定やサーバー一覧ファイルのエントリー)は、MCP サーバーの接続にクライアントごとに記載されています。
プロンプトの一部が当てはまらない場合
- プラグインをインストールするアシスタントは、サーバーの接続を省略します。プラグインが接続済みだからです。プラグインはバイナリをインストールしないため、手順 1 は引き続き必要です。アシスタントがプラグインのサーバーをプロジェクトの外で起動する場合(Codex はプラグイン自身のフォルダーで起動します)、サーバーが作業するフォルダーで説明しているとおり、スキルはプロジェクトのフォルダーをサーバーに伝えるようアシスタントに指示します。
- プラグインをインストールせず、
--agentの一覧にもないアシスタントは、スキルのインストールを省略します。接続後は MCP サーバーを通じて Aggrega のツールを引き続き利用でき、接続時にはサーバーが独自のガイダンスを渡します。 - コマンドを実行できないアシスタント(ターミナルにアクセスできないチャットアプリケーション)は、プロンプトに従えません。インストールの説明に従ってバイナリをインストールし、MCP サーバーの接続の説明に従ってアプリケーションを自分で接続してください。Claude Desktop については、後述の Claude Desktop を参照してください。
- 他の人が代わりに運用し、HTTPS 経由で接続するサーバーには、バイナリもプラグインもスキルも必要ありません。代わりに、HTTPS 経由で接続するサーバーの説明に従って、アシスタントのクライアントにアドレスを指定してください。
Claude Desktop
Claude Desktop は、各リリースに含まれる拡張機能パッケージを通じて Aggrega に接続し、そのパッケージはコンピューターにインストールされた aggrega を起動します。両方をご自身のコンピューターで設定してください:
- Windows では PowerShell で
irm https://aggrega.ai/install.ps1 | iexを、macOS または Linux ではターミナルでcurl -fsSL https://aggrega.ai/install.sh | shを実行してaggregaをインストールします。インストーラーの動作はバイナリのインストールで説明しています。 - 拡張機能パッケージをインストールし、その Workspace folder を設定してから Claude Desktop を再起動します。手順は「MCP サーバーの接続」の Claude Desktop で説明しています。
Claude Desktop のセッションは、コマンドをコンピューターではなくクラウドのコンテナで実行できるため、上記のプロンプトをそこに貼り付けるとコンテナ上で動作します。コンテナでは、コンテナのネットワークポリシーが aggrega.ai を許可すれば、セッションのシェルから aggrega をインストールして実行できます。許可は組織のオーナーが組織のネットワークアクセス設定で行います。Aggrega の MCP サーバーはそこでは接続されません。Claude Desktop はローカルサーバーを拡張機能の設定からのみ追加し、拡張機能が起動するのはコンテナ内のものではなく、コンピューター上の aggrega だからです。
aggrega skills install には Claude Desktop の項目がないため、Claude Desktop のセッションはスキルのインストールを省略します。拡張機能をインストールすると MCP サーバーを通じて Aggrega のツールを利用でき、接続時にはサーバーが独自のガイダンスを渡します。