Configurar o Aggrega com seu assistente de IA
Um assistente de IA capaz de executar comandos na sua máquina — um agente de programação no seu terminal ou no seu editor — pode configurar o Aggrega para você: instalar o binário aggrega, adicionar a si mesmo a skill do Aggrega e se conectar ao servidor MCP do Aggrega. Um assistente que instala plugins faz as duas últimas ações em uma única etapa, instalando o plugin do Aggrega; qualquer outro adiciona a skill e conecta o servidor, um após o outro. Cole nele o prompt abaixo, e ele executa essas etapas; o prompt o instrui a consultar você antes de instalar qualquer coisa.
Ao final, o assistente tem duas formas de trabalhar com o Aggrega. A skill é uma pasta com um arquivo SKILL.md que o assistente carrega quando sua solicitação diz respeito ao Aggrega: ela diz ao assistente como funciona o ciclo de criação e que ele deve tirar toda resposta sobre um schema ou um arquivo do binário, e não da memória. O servidor MCP, aggrega mcp, dá a ele as ferramentas do Aggrega — scaffold, validate, build e as demais — e o material de referência com que elas trabalham. A skill do Aggrega descreve a skill e o plugin, Conectar o servidor MCP o servidor, e O que seu assistente pode fazer com o Aggrega o que ele alcança por meio dele.
Depois de configurado, Primeiros passos, cada passo a passo em Importação e a página de cada exemplo executável que é compilado com o Aggrega apresentam a tarefa que ensinam como um prompt para colar no assistente, ao lado dos comandos.
O prompt
Configure o Aggrega para mim, um passo de cada vez, e me diga o que você executou em cada passo.
1. Execute `aggrega version`. Se o comando não for encontrado, me pergunte antes de instalar o Aggrega e depois instale-o para o meu usuário com o instalador oficial: no Linux ou no macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, no Windows, no PowerShell, `irm https://aggrega.ai/install.ps1 | iex`. Execute `aggrega version` de novo. Se o instalador exibiu uma linha para adicionar ao meu `PATH`, mostre-a para mim.2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indicar uma forma de instalar o plugin do Aggrega em você, pergunte antes de instalá-lo e depois instale-o dessa forma, ou me diga o que fazer quando for uma etapa que eu realizo na sua interface. O plugin adiciona a skill do Aggrega e conecta você ao servidor MCP do Aggrega. Caso contrário, execute `aggrega skills install --help` e encontre o seu próprio identificador na lista que ele exibe. Pergunte se eu quero a skill neste projeto ou em todos os projetos e depois execute `aggrega skills install --agent <your identifier>`, adicionando `--global` para todos os projetos. Se você não estiver na lista, pule a instalação da skill e diga isso.3. Se você instalou o plugin, já está conectado ao servidor MCP do Aggrega. Caso contrário, conecte-se ao servidor MCP do Aggrega, que é o comando `aggrega mcp`, da forma como você adiciona um servidor MCP, conforme `https://aggrega.ai/docs/ai-assistants/mcp-server/` descreve para você. Se precisar de uma reinicialização ou de um recarregamento para carregar o plugin ou o servidor, me diga o que fazer.4. Depois de conectado, chame a ferramenta `describe-capabilities` sem argumentos e resuma o que ela lista.O prompt é o mesmo em todos os idiomas em que a documentação é publicada: só as frases dele são traduzidas, e todo comando, flag, endereço e nome de ferramenta que ele contém permanece exatamente como está escrito, de modo que um assistente lê as mesmas instruções seja qual for o idioma do qual você o copia.
O instalador baixa a release mais recente, verifica-a em relação aos digests SHA-256 publicados da release e a instala apenas para o seu usuário, sem direitos de administrador; Instalar o binário descreve o que ele faz e como instalar manualmente em vez disso.
O que muda de um assistente para outro
Três partes do prompt dependem do assistente: a forma como ele instala o plugin do Aggrega, se ele instala plugins; caso contrário, o identificador que ele passa para --agent ao instalar a skill e a forma como ele adiciona o servidor. O assistente as descobre a partir do prompt, mas, se você as conhece, pode escrevê-las nele.
| Assistente | Instalação do plugin | Instalação da skill sem o plugin |
|---|---|---|
| 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 e depois codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills e depois 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, ou --agent antigravity-cli para a CLI do Antigravity |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega e depois Developer: Reload Window | aggrega skills install --agent cursor |
O Visual Studio Code com o GitHub Copilot, o Kiro e o OpenClaw também instalam o plugin; Instalar o plugin indica a forma para cada assistente e o que o OpenClaw pergunta antes de instalar. Os identificadores que --agent aceita, e a pasta em que cada um grava, estão listados em aggrega skills e são exibidos por aggrega skills install --help. A forma como cada assistente adiciona o servidor — um comando próprio, ou uma entrada nas configurações dele ou em um arquivo de lista de servidores — está em Conectar o servidor MCP, cliente por cliente.
Quando uma parte do prompt não se aplica
- Um assistente que instala o plugin pula a conexão do servidor: o plugin o conectou. O plugin não instala o binário, então a etapa 1 continua valendo. Quando o assistente inicia o servidor do plugin fora do seu projeto — o Codex o inicia na própria pasta do plugin —, a skill diz a ele para informar ao servidor a pasta do seu projeto, como descreve A pasta em que o servidor trabalha.
- Um assistente que não instala nenhum plugin e não está na lista de
--agentpula a instalação da skill. Ele ainda alcança as ferramentas do Aggrega pelo servidor MCP depois de conectado, e o servidor lhe passa orientações próprias quando ele se conecta. - Um assistente que não pode executar comandos — um aplicativo de chat sem acesso ao seu terminal — não consegue seguir o prompt. Instale o binário como Instalação descreve e conecte você mesmo o aplicativo como Conectar o servidor MCP descreve. Para o Claude Desktop, veja Claude Desktop abaixo.
- Um servidor que outra pessoa executa para você, acessado por HTTPS, não precisa nem do binário, nem do plugin, nem da skill. Em vez disso, informe o endereço ao cliente do assistente, como descreve Um servidor acessado por HTTPS.
Claude Desktop
O Claude Desktop se conecta ao Aggrega pelo pacote de extensão que cada release traz, e esse pacote inicia o aggrega instalado no seu computador. Configure os dois você mesmo no seu computador:
- Instale o
aggregano PowerShell no Windows comirm https://aggrega.ai/install.ps1 | iex, ou em um terminal no macOS ou no Linux comcurl -fsSL https://aggrega.ai/install.sh | sh. Instalar o binário descreve o que o instalador faz. - Instale o pacote de extensão, defina a Workspace folder dele e reinicie o Claude Desktop, como Claude Desktop em Conectar o servidor MCP descreve.
Uma sessão do Claude Desktop pode executar seus comandos em um contêiner na nuvem em vez de no seu computador, então o prompt acima, colado nela, atua sobre o contêiner. Lá, o aggrega é instalado e executado pelo shell da sessão assim que a política de rede do contêiner permite aggrega.ai — um proprietário da organização permite isso nas configurações de acesso à rede da organização. O servidor MCP do Aggrega não fica conectado lá: o Claude Desktop adiciona um servidor local apenas pelas configurações de extensões, e a extensão inicia o aggrega do seu computador, não o do contêiner.
aggrega skills install não tem uma entrada para o Claude Desktop, então uma sessão do Claude Desktop pula a instalação da skill. Ela alcança as ferramentas do Aggrega pelo servidor MCP depois que a extensão é instalada, e o servidor lhe passa orientações próprias quando ela se conecta.