Voltar as noticias
Contexto Sobre MCP, Parte IV: Sem Diretório de Trabalho
Compartilhar
WebMCPAltaEN

Contexto Sobre MCP, Parte IV: Sem Diretório de Trabalho

Fonte original: Dev.to - WebMCP·14 de setembro de 2026

Curadoria, tradução e análise: Redação Triplo Hub.

Parte I: um cliente MCP não tem diretório de trabalho, então ele nunca vê seu AGENTS.md.

Parte II: publique o servidor para que um cliente possa encontrá-lo.

Parte III: mantenha os fatos como dados e as instruções como prosa, para que o que ele encontra vale a pena ver.

Agora tire o diretório de trabalho completamente. O cliente do WebMCP é uma aba do navegador
que não falha em encontrar um diretório de trabalho. Ele não tem o
conceito.

Então, o que significa "expor seu contexto" quando não há repositório, nenhum processo e
não há servidor — apenas uma página?

A API não é do FAF

document.modelContext.registerTool() é a própria API experimental do Chrome
(chrome://flags/#enable-webmcp-testing). Uma página registra uma ferramenta, um agente
inspecionando essa página a chama, feito — sem processo MCP separado, sem transporte,
sem diretório de trabalho a ter ou não ter. Onde a API nativa não está disponível,
@mcp-b/webmcp-polyfill — um pacote real e independente, não do FAF — fornece
a mesma superfície de registerTool como uma alternativa:

const native = getDocumentContext();
if (native && typeof native.registerTool === 'function') {
  return { context: native, source: 'native' };
}
try {
  const { initializeWebMCPPolyfill } = await import('@mcp-b/webmcp-polyfill');
  initializeWebMCPPolyfill();
} catch {
  return { context: null, source: 'none' };
}
const polyfilled = getDocumentContext();
if (polyfilled && typeof polyfilled.registerTool === 'function') {
  return { context: polyfilled, source: 'polyfill' };
}
return { context: null, source: 'none' };

O WebMCP não se importa com o que você registra. Esta é a parte que importa mais
do que qualquer ferramenta específica: a capacidade da plataforma é genérica, aberta e não
é de propriedade de nenhum produto. O que se segue é uma demonstração disso, não a
única forma que pode assumir.

Três ferramentas, duas maneiras de registrá-las

faf.one/webmcp registra três:

Ferramenta Retorna
score_faf { score, tier, populated, active, gaps } — 0–100, no navegador
fill_6ws um fragmento YAML de human_context: de um formulário
emit_agents_md { markdown } — uma renderização mínima de AGENTS.md

Essas são as três ações da Parte III, em uma aba: preencher os seis W's, pontuar o que
permanece em branco e escrever o AGENTS.md a partir dos fatos.

score_faf e emit_agents_md são registrados em script com
registerTool(), e ambos carregam annotations: { readOnlyHint: true }. Isso
não é um comentário. É parte do registro, e um agente pode lê-lo antes
de chamar qualquer coisa: o mesmo sinal de confiança que as anotações de ferramentas MCP dão a um cliente, agora
em uma página da web em vez de um servidor.

fill_6ws é um formulário HTML simples com os atributos toolname, tooldescription e
toolautosubmit: o navegador transforma o formulário na ferramenta. Se o
formulário não for capturado, a página registra fill_6ws em script em vez disso.

score_faf roda inteiramente do lado do cliente. O núcleo de pontuação é WASM
(faf_wasm_sdk), compilado uma vez a partir da mesma fonte Rust que o CLI e os
trabalhadores de borda usam — sem ida e volta ao servidor, sem processo MCP para iniciar:

export function scoreYaml(yaml: string): string {
  if (!ready) throw new ToolError('kernel_not_ready', 'O núcleo de pontuação WASM não está inicializado');
  return score_faf(yaml);
}

E o mapeador de resultados se recusa a preencher a imagem. Slots ignorados — campos que
não se aplicam a este projeto — não são contados como ausentes:

/** A pontuação está populada/ativa. Slots ignorados não são ausentes — 13/13, não 13/21. */

gapsFromSlots apenas relata o que está genuinamente vazio. Uma ferramenta que está disposta a
inflar seu próprio denominador para parecer melhor é exatamente o tipo de coisa que um
argumento de "fatos estruturados" desmorona sem.

A parte que é honesta sobre seus próprios limites

emit_agents_md renderiza um rea

Análise editorial da Triplo Hub

A discussão sobre a ausência de um diretório de trabalho em clientes MCP é crucial para empresas brasileiras que buscam integrar agentes de IA em suas operações. A compreensão das APIs experimentais do Chrome pode facilitar a adoção de novas tecnologias e melhorar a interatividade dos sites.

Compartilhar
Seguir @triploup

Noticias relacionadas

Gostou do conteudo?

Receba toda semana as principais novidades sobre WebMCP.