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

Importar una configuración de cliente MCP — tres servidores que usa un asistente de programación

Un .mcp.json de Claude Code que enumera tres servidores Model Context Protocol — dos iniciados desde una línea de comandos y uno que ejecuta otra persona — convertido en borradores de archivos Aggrega por aggrega import, con cada servidor asignado a la realización de cómo se ejecuta, y compilado para Kubernetes.

Importar una configuración de cliente MCP lo recorre paso a paso: el comando, los archivos que escribe y por qué está ahí cada línea, la compilación y los servidores en ejecución. Esta carpeta contiene cada etapa de ese recorrido:

carpeta o archivoqué contiene
source/la configuración del cliente, .mcp.json, el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo, e import-answers.yaml, el nombre del Secret de Kubernetes del que se lee el token del servidor de GitHub
draft/los archivos que escribió aggrega import .mcp.json --target helm, sin cambios, incluido release.lock, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar

En un checkout del repositorio de la documentación, check.sh vuelve a ejecutar la importación, compara lo que escribe e imprime con draft/, compara los bloques que cita el recorrido con estos archivos, y valida y compila lo que escribió la importación. Necesita el catálogo de la biblioteca estándar (dónde conseguir uno) descargado junto a este repositorio, o su directorio indicado en AGGREGA_CATALOG_DIRS.

Generar el ejemplo

Puedes ejecutar la importación de este ejemplo con los comandos de abajo, o hacer que tu asistente de IA la ejecute por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example import-mcp

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd import-mcp

Compilación

La importación redacta los borradores de los archivos Aggrega junto al proyecto, en source/. Evalúa el proyecto frente al catálogo de la biblioteca estándar, que el registro predeterminado del espacio de trabajo publica como una instantánea firmada: la primera importación lo descarga, lo verifica, lo guarda en la caché de contenido del espacio de trabajo y lo identifica por su digest en el informe que escribe junto a los borradores. Un espacio de trabajo que indica sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio frente a ellas. La importación lee el nombre del Secret de import-answers.yaml y luego descarga aquello de lo que depende la Release redactada, de modo que la compilación sigue de inmediato:

Terminal window
cd source
aggrega import .mcp.json --target helm
aggrega build --release release.yaml

La compilación escribe los manifiestos de Kubernetes en dist/helm/; la creación del Secret y su aplicación se describen en el recorrido enlazado arriba.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo todavía no contiene una carpeta `import-mcp`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-mcp` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-mcp`, cuya carpeta `source` contiene lo que importa este ejemplo. Luego llama a la herramienta `import` con `workspace_root` establecido en `import-mcp/source`, `source` establecido en `.mcp.json` y `target` establecido en `helm`: lee las respuestas que necesita de `import-answers.yaml` junto a `.mcp.json`, escribe sus borradores en `import-mcp/source` y descarga lo que estos necesitan. Luego llama a la herramienta `validate` con `workspace_root` establecido en `import-mcp/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-mcp/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-mcp/source/dist/`.

Probarlo

Con la compilación aplicada, reenvía un puerto local al Service del servidor fetch y deja el comando en ejecución:

Terminal window
kubectl port-forward svc/fetch-default 8080:8080

Desde otra terminal, pide al servidor que abra una sesión con la solicitud initialize de MCP:

Terminal window
curl -sS http://127.0.0.1:8080/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}'
: keepalive
: keepalive
event: message
data: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}

La guía hace la misma llamada en Docker Compose y al servidor de GitHub.