MCP Academy · Aula

Respeitar os limites do cliente

Permaneça dentro do escopo permitido pelo host.

Respeitar os limites do cliente é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.

Saber não é suficiente

Você pode buscar raízes e ler recursos, mas o trabalho de verdade é respeitá-los. Um servidor confiável permanece dentro dos limites definidos pelo ambiente para ele. 🚧

Permaneça dentro das raízes

Antes de tocar em qualquer arquivo, confirme se o caminho está dentro de uma das raízes do cliente. Se não estiver, recuse a operação em vez de ultrapassar a área permitida.

Resolva os caminhos primeiro

Um caminho malicioso como ../../etc pode escapar de uma raiz. Sempre resolva o caminho para obter um caminho absoluto e normalizado antes de compará-lo com as pastas permitidas.

from pathlib import Path
real = Path(p).resolve()

Verifique a contenção com segurança

Teste se o caminho resolvido é relativo a uma raiz. O recurso auxiliar pathlib gera uma exceção se ele escapar, fornecendo uma resposta clara de sim ou não sobre prosseguir.

real.relative_to(root_path)

Não use recursos ausentes

Se o cliente nunca declarou um recurso, não o chame. Respeitar os limites significa confiar na negociação, não tentar usar recursos que nunca foram oferecidos.

Reaja adequadamente

Quando as raízes estiverem vazias ou não forem compatíveis, não tente adivinhar o sistema de arquivos. Restrinja o que sua ferramenta faz e explique o motivo ao usuário, em vez de acessar caminhos arbitrários.

Princípio do menor privilégio por padrão

As raízes definem um limite externo, mas você pode ser ainda mais restritivo. Solicite apenas o que uma tarefa realmente precisa, seguindo o princípio do menor privilégio, e não toque no restante.

Os limites não são apenas pastas

O respeito vai além dos caminhos. Respeite também o ritmo e os limites do ambiente, para nunca inundá-lo com chamadas nem ignorar um pedido de cancelamento do usuário.

Valide novamente após alterações

Quando chegar uma notificação list_changed sobre as raízes, verifique novamente todos os caminhos armazenados em cache. Uma pasta permitida há um minuto pode estar fora do escopo atual do usuário.

Falhe claramente, sem ultrapassar limites

Se uma solicitação apontar para fora das raízes, retorne um erro claro que o modelo possa ler. Uma recusa educada é melhor do que fazer silenciosamente algo que o usuário nunca autorizou.

Por que isso gera confiança

Os servidores que respeitam os limites são aqueles que os usuários mantêm instalados. Um bom controle de escopo transforma uma ferramenta poderosa em uma ferramenta segura, à qual as pessoas têm prazer em conceder acesso. 💛

Verificação rápida

Uma solicitação aponta para um caminho fora de todas as raízes declaradas. O que seu servidor deve fazer?

Recapitulação: respeitando os limites

Você resolve os caminhos, confirma que eles estão dentro de uma raiz, ignora recursos não declarados, reage adequadamente e recusa trabalhos fora do escopo. É isso que torna um servidor confiável. ✅

Perguntas Frequentes

A aula “Respeitar os limites do cliente” é grátis?

Sim — o texto completo de “Respeitar os limites do cliente” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.

O que vou aprender em “Respeitar os limites do cliente”?

Permaneça dentro do escopo permitido pelo host. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar MCP Academy?

Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Respeitar os limites do cliente”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de MCP Academy?

Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para MCP Academy