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

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

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

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

pasta ou ficheiroo 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 a partir do qual é lido o token do servidor do GitHub
draft/os ficheiros que aggrega import .mcp.json --target helm escreveu, inalterados, incluindo release.lock, e o que imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão

Num checkout do repositório da documentação, check.sh volta a executar a importação, compara o que esta escreve e imprime com draft/, compara os blocos que o guia cita com estes ficheiros, e valida e compila o que a importação escreveu. Precisa do catálogo da biblioteca padrão (onde obter um) num checkout ao lado deste repositório, ou do respetivo diretório indicado em AGGREGA_CATALOG_DIRS.

Gerar o exemplo

É possível executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute por si.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example import-mcp

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd import-mcp

Compilação

A importação cria os rascunhos dos ficheiros Aggrega ao lado do projeto, em source/. Avalia o projeto face ao catálogo da biblioteca padrão, que o registo predefinido do espaço de trabalho publica como um instantâneo assinado: a primeira importação obtém-no, verifica-o, guarda-o na cache de conteúdos do espaço de trabalho e identifica-o pelo seu digest no relatório que escreve ao lado dos rascunhos. Um espaço de trabalho que indica as suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS, ou em workspace.catalog_dirs — importa antes face a essas. A importação lê o nome do Secret a partir de import-answers.yaml e depois obtém aquilo de que depende a Release rascunhada, pelo que a compilação segue de imediato:

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

A compilação escreve os manifestos do Kubernetes em dist/helm/; a criação do Secret e a aplicação dos manifestos estão descritas no guia indicado acima.

Com um assistente de IA

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

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `import-mcp`, chame uma vez a ferramenta `scaffold` com `example` definido como `import-mcp` e sem `dir`: esta escreve o exemplo numa nova pasta `import-mcp`, cuja pasta `source` contém o que este exemplo importa. Em seguida, chame a ferramenta `import` com `workspace_root` definido como `import-mcp/source`, `source` definido como `.mcp.json` e `target` definido como `helm`: esta lê as respostas de que precisa a partir de `import-answers.yaml`, ao lado de `.mcp.json`, escreve os seus rascunhos em `import-mcp/source` e obtém aquilo de que precisam. Em seguida, 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. Indique-me que ficheiros o build escreveu; encontram-se em `import-mcp/source/dist/`.

Testar

Com o build aplicado, reencaminhe 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

Noutro terminal, peça ao servidor que abra uma sessão com o pedido 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 guia faz a mesma chamada no Docker Compose e para o servidor do GitHub.