Referência das ferramentas MCP

Esta página lista as ferramentas MCP do Pathrule por capacidade. O assistente raramente precisa de todas. A maioria das sessões usa apenas pathrule_get_context e mais uma ou duas leituras ou escritas. O servidor stdio local e o Remote MCP hospedado expõem, cada um, somente as operações que o seu runtime consegue de fato executar.

Para entender o modelo por trás, veja a visão geral do MCP.

Contexto e descoberta

A maioria das sessões começa e termina com pathrule_get_context. A resposta traz a visão geral do espaço de trabalho, os ids do conteúdo correspondente e uma dica sobre qual ferramenta chamar em seguida. O assistente segue essa dica em vez de tentar adivinhar.

Memória

O fluxo padrão é get_context para encontrar o id da memória relevante, depois read_memory para obter o corpo caso o assistente precise citá-lo, e write_memory quando o usuário pede para registrar algo.

Regra

As regras são do nível do espaço de trabalho e podem ser vinculadas a mais de um nó. Para escrever uma regra no mesmo caminho pela segunda vez, use a atualização, não a escrita, para evitar duplicatas.

Skill

Para o fluxo de criação, veja Como escrever skills. O assistente faz primeiro um rascunho e chama pathrule_write_skill depois que o usuário aprova o corpo.

Padrões

Atividade

O registro de atividade alimenta a atividade recente do espaço de trabalho, que a extensão do VS Code mostra na visualização Recent Activity, e as camadas de aprendizado derivadas. A granularidade certa é um registro por resposta (não por arquivo).

Aprendizado do projeto

O que um agente deduz a partir do seu código, guardado junto com os arquivos que ele leu e compartilhado com o espaço de trabalho. Veja Aprendizado do projeto.

Sugestões e atualização

As sugestões são a forma como o Pathrule evita que a árvore de conteúdo se degrade. O assistente pode sinalizar um problema concreto, assumir um brief, propor uma correção e resolvê-la, tudo sem sair do editor.

Controle local de escrita lazy

O servidor stdio local anuncia o conjunto completo de ferramentas desde o primeiro tools/list: leituras, escritas, atualizações, exclusões, padrões, setup, atualização e atividade. Não é preciso desbloquear nada antes da primeira escrita, e a lista permanece a mesma durante toda a sessão, então uma conversa longa nunca paga o custo de uma lista de ferramentas que muda no meio do caminho.

Se você preferir começar cada sessão com uma lista menor, o modo lazy está disponível como opção. Defina PATHRULE_MCP_TOOLS=lazy no ambiente da entrada MCP do Pathrule. No modo lazy, as ferramentas de leitura e pathrule_log_activity ficam visíveis na inicialização, e aparece uma ferramenta extra:

O modo lazy não remove nada; ele muda o momento em que as ferramentas de alteração ficam visíveis. Sem a variável, ou com qualquer outro valor, pathrule_enable_writes não existe, porque não há nada a habilitar.

Remote MCP hospedado

O Remote MCP tem seus próprios schemas nativos do Cloud. Uma permissão de leitura expõe sete ferramentas: pathrule_get_context, mais ferramentas de listagem e leitura para memória, regra e skill. Uma permissão de escrita adiciona escrita, atualização, exclusão e histórico para cada tipo, totalizando um catálogo completo de dezenove ferramentas.

O servidor de autorização reconhece pathrule:read, pathrule:write, pathrule:refresh e pathrule:activity. Escopos reconhecidos não adicionam ferramentas que não estejam no catálogo. O Remote MCP não expõe administração da organização, setup do espaço de trabalho, snapshots, importação de padrões, aprendizado do projeto, registro de atividade nem fluxos de atualização. Ele não instala hooks e não lê arquivos locais.

Use tools/list no servidor conectado para ver os schemas exatos. A página Remote MCP trata da autorização e do limite da entrega local.

Convenções

As convenções abaixo valem para a superfície stdio local. Os schemas remotos estão descritos acima.

• Escritas orientadas a caminho. As ferramentas de escrita recebem um node_path relativo ao espaço de trabalho, como /apps/api ou /. Se o caminho não existir, os nós intermediários são criados automaticamente.
• Concorrência otimista. As ferramentas de atualização e exclusão aceitam um expected_version_id vindo de uma leitura anterior. Uma divergência retorna uma resposta de conflito clara com a versão atual, para que o assistente possa reler e mesclar em vez de sobrescrever.
• Duplicatas são recusadas. Uma memória cujo título já existe naquele caminho, ou uma regra ou skill cujo nome já existe no espaço de trabalho, é rejeitada com um erro de duplicata, para que o assistente atualize o registro existente. Uma memória ou regra pode ser forçada com allow_duplicate: true depois que o assistente revisar a existente.
• Compacto por padrão. As respostas são compactas no caso comum. No servidor local, passe verbose: true quando precisar do registro completo.
• Ids estáveis. As respostas das ferramentas trazem valores estáveis de id e version_id. O assistente pode referenciá-los em chamadas seguintes sem reler o item pai.

O que ler em seguida

• Visão geral do MCP, para o modelo por trás da superfície de ferramentas.
• Como os hooks funcionam, para a camada push que complementa essas chamadas pull.
• Como escrever memórias, Como escrever regras, Como escrever skills, para saber o que colocar nas escritas.