Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Configurar Aggrega con tu asistente de IA

Un asistente de IA capaz de ejecutar comandos en tu máquina —un agente de programación en tu terminal o en tu editor— puede configurar Aggrega por ti: instalar el binario aggrega, añadirse la skill de Aggrega y conectarse al servidor MCP de Aggrega. Un asistente que instala plugins hace los dos últimos pasos en uno solo, instalando el plugin de Aggrega; cualquier otro añade la skill y conecta el servidor uno tras otro. Pega en él el prompt de abajo y realizará esos pasos; el prompt le indica que te consulte antes de instalar nada.

Cuando termina, el asistente tiene dos formas de trabajar con Aggrega. La skill es una carpeta con un archivo SKILL.md que el asistente carga cuando tu petición tiene que ver con Aggrega: le indica al asistente cómo funciona el ciclo de redacción y que tome cada respuesta sobre un esquema o un archivo del binario en lugar de su memoria. El servidor MCP, aggrega mcp, le da las herramientas de Aggrega — scaffold, validate, build y las demás — y el material de referencia con el que trabajan. La skill de Aggrega describe la skill y el plugin, Conectar el servidor MCP el servidor, y Qué puede hacer tu asistente con Aggrega lo que alcanza a través de él.

Una vez configurado, Primeros pasos, cada recorrido guiado de Importar y la página de cada ejemplo ejecutable que se compila con Aggrega dan la tarea que enseñan como un prompt para pegar en el asistente, junto a los comandos.

El prompt

Configura Aggrega por mí, paso a paso, y dime qué ejecutaste en cada paso.
1. Ejecuta `aggrega version`. Si no se encuentra el comando, pregúntame antes de instalar Aggrega y luego instálalo para mi usuario con el instalador oficial: en Linux o macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, en Windows en PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Ejecuta `aggrega version` de nuevo. Si el instalador imprimió una línea para añadir a mi `PATH`, muéstramela.
2. Si `https://aggrega.ai/docs/ai-assistants/skill/` da una forma de instalar en ti el plugin de Aggrega, pregúntame antes de instalarlo y luego instálalo de esa forma, o dime qué hacer cuando sea un paso que yo doy en tu interfaz. El plugin añade la skill de Aggrega y te conecta al servidor MCP de Aggrega. Si no, ejecuta `aggrega skills install --help` y busca tu propio identificador en la lista que imprime. Pregúntame si quiero la skill en este proyecto o en todos los proyectos, y luego ejecuta `aggrega skills install --agent <your identifier>`, añadiendo `--global` para todos los proyectos. Si no estás en la lista, omite la instalación de la skill y dilo.
3. Si instalaste el plugin, ya estás conectado al servidor MCP de Aggrega. Si no, conéctate al servidor MCP de Aggrega, que es el comando `aggrega mcp`, de la forma en que añades un servidor MCP, tal como describe para ti `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Si necesitas un reinicio o una recarga para cargar el plugin o el servidor, dime qué hacer.
4. Una vez conectado, llama a la herramienta `describe-capabilities` sin argumentos y resume lo que enumera.

El prompt es el mismo en todos los idiomas en los que se publica la documentación: solo se traducen sus frases, y cada comando, opción, dirección y nombre de herramienta que contiene permanece exactamente como está escrito, de modo que un asistente lee las mismas instrucciones sea cual sea el idioma desde el que lo copies.

El instalador descarga la última release, la comprueba frente a los resúmenes SHA-256 publicados de la release y la instala solo para tu usuario, sin derechos de administrador; Instalar el binario describe lo que hace y cómo instalarlo a mano en su lugar.

Qué cambia de un asistente a otro

Tres partes del prompt dependen del asistente: la forma en que instala el plugin de Aggrega, si instala plugins; si no, el identificador que pasa a --agent cuando instala la skill y la forma en que añade el servidor. El asistente las deduce a partir del prompt, pero si las conoces puedes escribirlas en él.

AsistenteInstalación del pluginInstalación de la skill sin el plugin
Claude Codeclaude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsaggrega skills install --agent claude-code
Codexcodex plugin marketplace add aggrega-ai/aggrega-skills y luego codex plugin add aggrega@aggregaaggrega skills install --agent codex
GitHub Copilot CLIcopilot plugin marketplace add aggrega-ai/aggrega-skills y luego copilot plugin install aggrega@aggregaaggrega skills install --agent github-copilot
Gemini CLIgemini extensions install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent gemini-cli
Antigravityagy plugin install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent antigravity, o --agent antigravity-cli para la CLI de Antigravity
Cursorgit clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega y luego Developer: Reload Windowaggrega skills install --agent cursor

Visual Studio Code con GitHub Copilot, Kiro y OpenClaw también instalan el plugin; Instalar el plugin da la forma para cada asistente y lo que pregunta OpenClaw antes de instalar. Los identificadores que acepta --agent, y la carpeta en la que escribe cada uno, se enumeran en aggrega skills y los imprime aggrega skills install --help. La forma en que cada asistente añade el servidor — un comando propio, o una entrada en su configuración o en un archivo de lista de servidores — está en Conectar el servidor MCP, cliente por cliente.

Cuando una parte del prompt no se aplica

  • Un asistente que instala el plugin omite conectar el servidor: el plugin ya lo conectó. El plugin no instala el binario, así que el paso 1 sigue aplicándose. Donde el asistente inicia el servidor del plugin fuera de tu proyecto —Codex lo inicia en la carpeta propia del plugin—, la skill le indica que comunique al servidor la carpeta de tu proyecto, como describe La carpeta en la que trabaja el servidor.
  • Un asistente que no instala ningún plugin y no está en la lista de --agent omite la instalación de la skill. Aun así llega a las herramientas de Aggrega a través del servidor MCP una vez conectado, y el servidor le proporciona sus propias indicaciones cuando se conecta.
  • Un asistente que no puede ejecutar comandos — una aplicación de chat sin acceso a tu terminal — no puede seguir el prompt. Instala el binario como describe Instalación, y conecta tú mismo la aplicación como describe Conectar el servidor MCP. Para Claude Desktop, consulta Claude Desktop más abajo.
  • Un servidor que otra persona ejecuta para ti, al que se accede por HTTPS, no necesita ni el binario, ni el plugin, ni la skill. En su lugar, da la dirección al cliente del asistente, como describe Un servidor al que se accede por HTTPS.

Claude Desktop

Claude Desktop se conecta a Aggrega mediante el paquete de extensión que incluye cada release, y ese paquete inicia el aggrega instalado en tu equipo. Configura ambos tú mismo en tu equipo:

  1. Instala aggrega en PowerShell en Windows con irm https://aggrega.ai/install.ps1 | iex, o en una terminal en macOS o Linux con curl -fsSL https://aggrega.ai/install.sh | sh. Instalar el binario describe lo que hace el instalador.
  2. Instala el paquete de extensión, establece su Workspace folder y reinicia Claude Desktop, como describe Claude Desktop en Conectar el servidor MCP.

Una sesión de Claude Desktop puede ejecutar sus comandos en un contenedor en la nube en lugar de en tu equipo, así que el prompt anterior, pegado en ella, actúa sobre el contenedor. Allí, aggrega se instala y se ejecuta desde el shell de la sesión una vez que la política de red del contenedor permite aggrega.ai — un propietario de la organización lo permite en la configuración de acceso a la red de la organización. El servidor MCP de Aggrega no está conectado allí: Claude Desktop añade un servidor local solo desde la configuración de sus extensiones, y la extensión inicia el aggrega de tu equipo, no el del contenedor.

aggrega skills install no tiene una entrada para Claude Desktop, así que una sesión de Claude Desktop omite la instalación de la skill. Llega a las herramientas de Aggrega a través del servidor MCP una vez instalada la extensión, y el servidor le proporciona sus propias indicaciones cuando se conecta.