Documentação Oficial do MCP em Português
  1. Conceitos
Documentação Oficial do MCP em Português
  • Get Started
    • Introdução
    • Servidores de exemplo
    • Clientes de exemplo
    • Início rápido
      • Para os desenvolvedores de servidores
      • Para os desenvolvedores de clientes
      • Para utilizadores do Claude Desktop
  • Tutoriais
    • Construção de MCP com LLMs
    • Depuração
    • Inspetor
  • Conceitos
    • Arquitetura central
    • Recursos
    • Avisos
    • Ferramentas
    • Amostragem
    • Raízes
    • Transportes
  • Desenvolvimento
    • O que há de novo
    • Roteiro
    • Contribuindo
  1. Conceitos

Raízes

Compreendendo Roots em MCP
Roots são um conceito em MCP que define os limites onde os servidores podem operar. Eles fornecem uma maneira para os clientes informarem aos servidores sobre recursos relevantes e suas localizações.

O que são Roots?#

Um root é um URI que um cliente sugere que um servidor deve se concentrar. Quando um cliente se conecta a um servidor, ele declara com quais roots o servidor deve trabalhar. Embora usado principalmente para caminhos de sistema de arquivos, os roots podem ser qualquer URI válido, incluindo URLs HTTP.
Por exemplo, os roots podem ser:
file:///home/user/projects/myapp
https://api.example.com/v1

Por que Usar Roots?#

Os roots servem a vários propósitos importantes:
1.
Orientação: Eles informam aos servidores sobre recursos e localizações relevantes
2.
Clareza: Os roots deixam claro quais recursos fazem parte do seu workspace
3.
Organização: Múltiplos roots permitem que você trabalhe com diferentes recursos simultaneamente

Como os Roots Funcionam#

Quando um cliente suporta roots, ele:
1.
Declara a capacidade roots durante a conexão
2.
Fornece uma lista de roots sugeridos ao servidor
3.
Notifica o servidor quando os roots mudam (se suportado)
Embora os roots sejam informativos e não estritamente impositivos, os servidores devem:
1.
Respeitar os roots fornecidos
2.
Usar URIs de root para localizar e acessar recursos
3.
Priorizar operações dentro dos limites do root

Casos de Uso Comuns#

Os roots são comumente usados para definir:
Diretórios de projeto
Localizações de repositório
API endpoints
Localizações de configuração
Limites de recursos

Melhores Práticas#

Ao trabalhar com roots:
1.
Apenas sugira recursos necessários
2.
Use nomes claros e descritivos para os roots
3.
Monitore a acessibilidade do root
4.
Lide com as mudanças de root graciosamente

Exemplo#

Aqui está como um cliente MCP típico pode expor roots:
{
  "roots": [
    {
      "uri": "file:///home/user/projects/frontend",
      "name": "Frontend Repository"
    },
    {
      "uri": "https://api.example.com/v1",
      "name": "API Endpoint"
    }
  ]
}
Esta configuração sugere que o servidor se concentre tanto em um repositório local quanto em um API endpoint, mantendo-os logicamente separados.
Modified at 2025-03-12 10:13:43
Previous
Amostragem
Next
Transportes
Built with