MCP Academy · Aula

O que as raízes informam a um servidor

Saiba quais pastas o cliente disponibiliza.

Aula 1 de 413 etapas

O que as raízes informam a um servidor é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 1 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.

Os servidores são um pouco cegos

Seu servidor é executado como um processo próprio, portanto não consegue simplesmente ver o projeto do usuário. Ele precisa que o cliente informe quais pastas estão disponíveis. Essa indicação é chamada de raiz. 🧭

O que uma raiz realmente é

Uma raiz é um único local que o cliente informa que o servidor pode usar, geralmente uma pasta de projeto. Ela marca o limite de onde você deve acessar.

As raízes geralmente são URIs file://

A maioria das raízes são URIs file:// que apontam para um diretório no disco. O esquema deixa explícito que você está acessando uma pasta local, e não um endereço da web.

file:///home/ada/projects/my-app

Um nome amigável também

Cada raiz pode conter um nome opcional, um rótulo curto como "Meu aplicativo". Ele serve apenas para as pessoas, para que registros e prompts sejam claros em vez de exibirem caminhos brutos.

Mais de uma raiz

Um cliente pode expor várias raízes ao mesmo tempo, como uma pasta de código e uma pasta de documentação. Seu servidor deve tratar a lista como o conjunto completo de locais que pode acessar.

As raízes são uma sugestão, não uma prisão

As raízes são uma orientação, não uma imposição rígida do protocolo. Elas informam onde você deve se concentrar, mas cabe a você permanecer dentro delas. ✋

Por que isso mantém os usuários seguros

As raízes permitem que o usuário diga: "trabalhe aqui, em nenhum outro lugar". Esse escopo impede que um servidor vasculhe arquivos privados muito além do projeto que o usuário realmente abriu.

O cliente controla a lista

O cliente decide o que conta como uma raiz, geralmente a partir da pasta do espaço de trabalho aberta pelo usuário. Seu servidor nunca define as próprias raízes; ele apenas lê o que recebe.

As raízes podem mudar

As raízes não são fixas. Se o usuário abrir uma nova pasta, o conjunto muda, e um cliente compatível pode informar ao seu servidor que a lista foi atualizada.

Nem todo cliente as possui

As raízes são um recurso opcional do cliente. Alguns ambientes as oferecem, outros não; portanto, um servidor bem desenvolvido funciona adequadamente tanto quando a lista está cheia quanto quando está vazia.

Como uma raiz aparece em JSON

Na transmissão, uma entrada de raiz é mínima: apenas um URI e um nome opcional. Essa estrutura simples é tudo de que seu servidor precisa para saber onde pode operar.

{ "uri": "file:///home/ada/projects/my-app", "name": "My App" }

Verificação rápida

Certifique-se de que a finalidade de uma raiz esteja clara.

Recapitulação: raízes em poucas palavras

Você aprendeu que uma raiz é uma localização fornecida pelo cliente, geralmente uma pasta file:// com um nome opcional, que define o escopo de onde seu servidor deve trabalhar. O cliente controla a lista, e ela pode mudar. 🎯

Grátis para começar

Aprenda Python com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos
30
Aulas
120

Perguntas Frequentes

A aula “O que as raízes informam a um servidor” é grátis?

Sim — o texto completo de “O que as raízes informam a um servidor” é 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 “O que as raízes informam a um servidor”?

Saiba quais pastas o cliente disponibiliza. 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 1 de 4.

Quanto tempo leva a aula “O que as raízes informam a um servidor”?

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

  1. O que as raízes informam a um servidor
  2. Solicitar as raízes do cliente
  3. Negociar capacidades
  4. Respeitar os limites do cliente
← Voltar para MCP Academy