Nível 3 — Automação e escala · Módulo 3.1 — MCP: conectando o Claude aos sistemas

3.1.2 · Arquitetura: cliente e servidor

4 min de vídeo TODOS

Objetivo: ao final, o consultor identifica quem é cliente e quem é servidor MCP, escolhe o transporte adequado, e sabe em qual escopo adicionar um servidor.

O que você precisa levar desta aula

Cliente entende de protocolo; servidor entende do sistema. O cliente (Claude Code, desktop, VS Code) descobre e chama; o servidor guarda a credencial, executa e devolve.
Transportes: stdio para servidor local, HTTP para remoto (é o recomendado), e SSE está depreciado. No .mcp.json, entrada com url e sem type faz o servidor ser ignorado.
Três escopos ao adicionar: local (padrão — só aquele projeto, só você), project (vai para o repositório, a squad herda) e user (todos os seus projetos).

Quem faz o quê

Peça	Responsabilidade	Exemplos
Cliente	Descobrir o que o servidor expõe, decidir quando chamar, apresentar o resultado	Claude Code, app de desktop, extensão do VS Code
Servidor	Declarar capacidades, autenticar no sistema, executar e devolver	`github` oficial, MCP ABAP/ADT, MCP interno da Wayon
Sistema	A fonte de verdade	MRD, Jira, catálogo de RICEFW, Drive

O cliente não sabe nada sobre SAP. Quem sabe é o servidor. Trocar de cliente não exige refazer o servidor — é exatamente o ganho da aula 3.1.1.

Os transportes

Transporte	Quando	Comando
stdio	Servidor roda como processo local	`claude mcp add <nome> -- <comando> <args>`
HTTP	Servidor remoto — recomendado	`claude mcp add --transport http <nome> <url>`
SSE	Depreciado. Só se o serviço expõe apenas SSE	`claude mcp add --transport sse <nome> <url>`

Em configuração por JSON, o campo type aceita streamable-http como sinônimo de http.

A pegadinha: uma entrada de .mcp.json que tem url mas não tem type é erro de configuração. O Claude Code interpreta entrada sem type como servidor stdio, não acha comando para rodar, e ignora o servidor, reportando o problema. Servidor que "não aparece" costuma ser isso.

Os escopos

Escopo	Alcance	Onde fica
`local` (padrão)	Só o projeto onde você adicionou, só para você	`~/.claude.json`, sob o caminho daquele projeto
`project`	Todo mundo que clonar o repositório	`.mcp.json`, versionado
`user`	Todos os seus projetos	Configuração do usuário

# só para mim, neste projeto (padrão)
claude mcp add --transport http meu-teste https://exemplo/mcp

# para a squad inteira do Meridiano
claude mcp add --transport http catalogo-ricefw --scope project https://interno.wayon/mcp

# em todos os meus projetos
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp

Servidor em escopo project fica versionado no repositório, então adicionar um servidor é uma decisão da squad, não individual — e por isso o .mcp.json de repositório passa por diálogo de confiança antes de valer.

Regra Wayon Servidor MCP que toca sistema de cliente entra em escopo project, versionado no repositório da squad, nunca em escopo local na máquina de uma pessoa. O motivo é o mesmo dos hooks (aula 3.2.1): configuração que existe só numa máquina não é configuração da consultoria, e ninguém consegue auditar o que não está escrito em lugar nenhum.

📖 Instalar servidores MCP · Extensão vs CLI — módulo 2.1.7

Quiz — 4 questões

1.Quem guarda a credencial de acesso ao sistema: o cliente ou o servidor MCP?

a)O cliente, que autentica e passa o token ao servidor a cada chamada
Inverte as responsabilidades: o cliente conhece o protocolo, não o sistema nem suas credenciais.
b)O servidor — ele autentica no sistema, executa e devolve; o cliente só conhece o protocolo
Correto, e é essa separação que permite trocar de cliente sem refazer a integração.
c)Nenhum dos dois: a credencial fica no .mcp.json do projeto, em texto
Credencial em arquivo versionado seria justamente o antipadrão que a aula 3.1.5 alerta.

Ver resposta e por quê

❌a) Inverte as responsabilidades: o cliente conhece o protocolo, não o sistema nem suas credenciais.

✅b) Correto, e é essa separação que permite trocar de cliente sem refazer a integração.

❌c) Credencial em arquivo versionado seria justamente o antipadrão que a aula 3.1.5 alerta.

2.Você vai conectar um servidor MCP remoto novo. Qual transporte usar?

a)HTTP, que é o recomendado para servidor remoto
Correto. SSE está depreciado e stdio é para processo local.
b)SSE, que é o transporte próprio de servidor remoto
SSE está depreciado; use HTTP onde houver. Se um tutorial usa SSE, ele está desatualizado.
c)stdio, com a URL passada como argumento
stdio é para servidor que roda como processo local na sua máquina, não para endpoint remoto.

Ver resposta e por quê

✅a) Correto. SSE está depreciado e stdio é para processo local.

❌b) SSE está depreciado; use HTTP onde houver. Se um tutorial usa SSE, ele está desatualizado.

❌c) stdio é para servidor que roda como processo local na sua máquina, não para endpoint remoto.

3.Um servidor que você configurou por JSON simplesmente não aparece na lista do /mcp. A entrada tem url mas não tem type. O que aconteceu?

a)Faltou reiniciar a sessão — configuração por JSON só carrega no próximo início
Vale tentar, mas há uma causa específica no cenário descrito.
b)O type é opcional e o padrão é HTTP, então o problema está na URL
O padrão não é HTTP: entrada sem type é lida como stdio.
c)Entrada sem type é lida como servidor stdio; sem comando para rodar, o servidor é ignorado e o problema é reportado
Correto — é a pegadinha de configuração por JSON.

Ver resposta e por quê

❌a) Vale tentar, mas há uma causa específica no cenário descrito.

❌b) O padrão não é HTTP: entrada sem type é lida como stdio.

✅c) Correto — é a pegadinha de configuração por JSON.

4.A squad do Meridiano vai passar a usar um servidor MCP que consulta o catálogo interno de RICEFW. Qual escopo é o adequado? ---

a)local, que é o padrão e mantém a configuração privada de cada consultor
Cada pessoa teria que configurar por conta, e ninguém consegue auditar o que existe só em máquinas individuais.
b)project, que versiona no .mcp.json do repositório e faz a squad inteira herdar
Correto, e é a Regra Wayon para servidor que toca sistema de cliente.
c)user, para valer em todos os projetos do consultor
Levaria um servidor específico do Meridiano para projetos de outros clientes — escopo maior do que o necessário.

Ver resposta e por quê

❌a) Cada pessoa teria que configurar por conta, e ninguém consegue auditar o que existe só em máquinas individuais.

✅b) Correto, e é a Regra Wayon para servidor que toca sistema de cliente.

❌c) Levaria um servidor específico do Meridiano para projetos de outros clientes — escopo maior do que o necessário.