AI 어시스턴트로 Aggrega 설정하기
컴퓨터에서 명령을 실행할 수 있는 AI 어시스턴트(터미널이나 편집기에서 동작하는 코딩 에이전트)는 Aggrega 설정을 대신 해 줄 수 있습니다. aggrega 바이너리를 설치하고, Aggrega 스킬을 자신에게 추가하고, 자신을 Aggrega MCP 서버에 연결합니다. 플러그인을 설치하는 어시스턴트는 Aggrega 플러그인을 설치하여 뒤의 두 가지를 한 단계로 처리하며, 그 밖의 어시스턴트는 스킬을 추가한 다음 서버를 연결합니다. 아래 프롬프트를 붙여 넣으면 어시스턴트가 이 단계를 차례로 진행합니다. 프롬프트는 무엇이든 설치하기 전에 사용자에게 확인하도록 어시스턴트에게 지시합니다.
완료되면 어시스턴트는 두 가지 방법으로 Aggrega를 다룰 수 있습니다. 스킬은 SKILL.md 파일을 담은 폴더로, 요청이 Aggrega와 관련될 때 어시스턴트가 불러옵니다. 스킬은 작성 루프가 어떻게 진행되는지 알려 주고, 스키마나 파일에 관한 모든 답을 기억이 아니라 바이너리에서 얻도록 지시합니다. MCP 서버인 aggrega mcp는 Aggrega의 도구(scaffold, validate, build 등)와 그 도구들이 참조하는 자료를 어시스턴트에 제공합니다. 스킬과 플러그인은 Aggrega 스킬에서, 서버는 MCP 서버 연결에서, 어시스턴트가 서버를 통해 사용할 수 있는 것은 어시스턴트가 Aggrega로 할 수 있는 일에서 설명합니다.
설정이 끝나면 시작하기, 가져오기 아래의 각 안내, 그리고 Aggrega로 빌드되는 각 실행 가능한 예제의 페이지는 명령 옆에 각자가 가르치는 작업을 어시스턴트에 붙여 넣을 프롬프트로 제공합니다.
프롬프트
저를 위해 Aggrega를 한 단계씩 설정하고, 각 단계에서 무엇을 실행했는지 알려 주십시오.
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 다이제스트와 대조한 뒤, 관리자 권한 없이 현재 사용자에게만 설치합니다. 설치 프로그램이 하는 일과 대신 직접 설치하는 방법은 바이너리 설치에서 설명합니다.
어시스턴트마다 달라지는 부분
프롬프트의 세 부분은 어시스턴트에 따라 다릅니다. 플러그인을 설치하는 어시스턴트라면 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를 설치합니다. 설치 프로그램이 하는 일은 바이너리 설치에서 설명합니다. - MCP 서버 연결의 Claude Desktop에서 설명하는 대로 확장 패키지를 설치하고, Workspace folder를 설정한 다음, Claude Desktop을 다시 시작하십시오.
Claude Desktop 세션은 명령을 컴퓨터가 아닌 클라우드 컨테이너에서 실행할 수 있으므로, 위의 프롬프트를 세션에 붙여 넣으면 컨테이너에서 작동합니다. 그곳에서는 컨테이너의 네트워크 정책이 aggrega.ai를 허용하면 세션의 셸에서 aggrega를 설치하고 실행할 수 있습니다. 이는 조직 소유자가 조직의 네트워크 액세스 설정에서 허용합니다. Aggrega MCP 서버는 그곳에서 연결되지 않습니다. Claude Desktop은 확장 설정에서만 로컬 서버를 추가하고, 확장은 컨테이너에 있는 것이 아니라 컴퓨터에 있는 aggrega를 실행하기 때문입니다.
aggrega skills install에는 Claude Desktop 항목이 없으므로 Claude Desktop 세션은 스킬 설치를 건너뜁니다. 확장이 설치되면 MCP 서버를 통해 Aggrega의 도구를 사용할 수 있으며, 연결할 때 서버가 자체 안내를 제공합니다.