Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Importar uma configuração de cliente MCP — três servidores que um assistente de programação usa

Um .mcp.json do Claude Code que lista três servidores Model Context Protocol — dois iniciados a partir de uma linha de comando e um que outra pessoa executa — convertido em rascunhos de arquivos Aggrega por aggrega import, com cada servidor mapeado para a realização de como ele é executado, e compilado para Kubernetes.

Importar uma configuração de cliente MCP percorre o processo passo a passo: o comando, os arquivos que ele escreve e por que cada linha está ali, o build e os servidores em execução. Esta pasta contém cada etapa desse passo a passo:

pasta ou arquivoo que contém
source/a configuração do cliente, .mcp.json, o .aggrega-config.yaml que torna a pasta um espaço de trabalho, e import-answers.yaml, o nome do Secret do Kubernetes do qual o token do servidor do GitHub é lido
draft/os arquivos que aggrega import .mcp.json --target helm escreveu, sem alterações, incluindo release.lock, e o que ele imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão

Em um checkout do repositório da documentação, check.sh executa a importação novamente, compara o que ela escreve e imprime com draft/, compara os blocos que o passo a passo cita com estes arquivos, e valida e compila o que a importação escreveu. Ele precisa do catálogo da biblioteca padrão (onde obter um) em um checkout ao lado deste repositório, ou do diretório dele indicado em AGGREGA_CATALOG_DIRS.

Gerar o exemplo

Você pode executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute para você.

Escreva o exemplo em uma nova pasta com o nome dele:

Terminal window
aggrega scaffold --example import-mcp

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd import-mcp

Build

A importação cria os rascunhos dos arquivos Aggrega ao lado do projeto, em source/. Ela avalia o projeto em relação ao catálogo da biblioteca padrão, que o registry padrão do espaço de trabalho publica como um snapshot assinado: a primeira importação o baixa, o verifica, o mantém no cache de conteúdo do espaço de trabalho e o identifica pelo seu digest no registro que escreve ao lado dos rascunhos. Um espaço de trabalho que nomeia suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou em workspace.catalog_dirs — importa em relação a elas. A importação lê o nome do Secret de import-answers.yaml e depois baixa aquilo de que a Release rascunhada depende, de modo que o build vem logo em seguida:

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

O build escreve os manifestos do Kubernetes em dist/helm/; a criação do Secret e a aplicação dos manifestos estão no passo a passo vinculado acima.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço de trabalho ainda não contém uma pasta `import-mcp`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-mcp` e sem `dir`: ela grava o exemplo em uma nova pasta `import-mcp`, cuja pasta `source` contém o que este exemplo importa. Depois chame a ferramenta `import` com `workspace_root` definido como `import-mcp/source`, `source` definido como `.mcp.json` e `target` definido como `helm`: ela lê as respostas de que precisa de `import-answers.yaml` ao lado de `.mcp.json`, grava seus rascunhos em `import-mcp/source` e baixa o que eles precisam. Depois chame a ferramenta `validate` com `workspace_root` definido como `import-mcp/source` e `release` definido como `release.yaml`, e a ferramenta `build` com `workspace_root` definido como `import-mcp/source`, `release` definido como `release.yaml` e `write` definido como true. Diga-me quais arquivos o build gravou; eles estão em `import-mcp/source/dist/`.

Teste

Com o build aplicado, encaminhe uma porta local para o Service do servidor fetch e deixe o comando em execução:

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

Em outro terminal, peça ao servidor que abra uma sessão com a requisição initialize do 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"}}}

O passo a passo faz a mesma chamada no Docker Compose e para o servidor do GitHub.