Bancada técnica local¶
O primeiro teste acompanha uma troca em que alguém formula uma contribuição, outro participante a lê e acrescenta algo, e o primeiro consegue recuperar a resposta. As orientações abaixo permitem experimentar esse percurso no Gemini com arquivos selecionados.
A bancada técnica oferece um percurso opcional para examinar armazenamento por participante, preparação formal e acesso por MCP, usando uma máquina como servidor para os demais aparelhos na rede local. O certificado e as credenciais pertencem a essa instalação, enquanto o site público continua estático. A bancada não empacota coleções nem faz leitura contextual automatizada.
Primeiro teste: site, IA e arquivos¶
Para experimentar a adoção com Gemini no Android, comece por seu primeiro rascunho, com o guia geral de primeiro uso. Se já quer participar de um espaço, escolha o anexo de participação. Use apenas um deles na conversa. Guarde os rascunhos onde já trabalha e selecione os arquivos que deseja compartilhar. O outro participante usa suas próprias orientações e contexto, prepara uma contribuição relacionada e escolhe o que devolver. Você recupera e considera a resposta.
Basta o chat e a troca dos arquivos selecionados. Anote onde precisou de ajuda que o site não ofereceu; isso mostra o que as instruções ainda precisam resolver. Veja o percurso.
Este circuito por anexo não depende de uma conexão MCP nativa do Gemini. Na documentação do Gemini consultada em outubro de 2026, apps MCP personalizados exigem conta pessoal, idade mínima de 18 anos, uso nos EUA, inglês e Keep Activity ativo. Portanto, a bancada MCP abaixo é um ensaio separado, não uma integração Gemini MCP pronta para este piloto no Brasil.
Conferir a atribuição antes da troca¶
Os arquivos de exemplo permitem testar a diferença entre formulações independentes e uma solução que declara ter utilizado ambas. Peça à IA que explique o que cada autor assumiu e compare a resposta com os quatro arquivos. Verifique se o modelo conserva as origens e reconhece que semelhança não demonstra dependência.
Em seguida, apresente uma decisão hipotética de aprovar a implementação. Verifique se a IA a distingue de um reconhecimento posterior por quem recebeu uma consequência. Não é necessário gerar um Nod para completar o exercício. Este é um caso fictício de avaliação das instruções; só o teste executado permite relatar como o modelo respondeu.
Observar o trabalho das duas pessoas¶
Escolham uma questão real e observem o que cada pessoa consegue acrescentar: uma condição desconhecida, uma correção de critério, uma hipótese ou um teste. Registrem o esforço para explicar o contexto, encontrar antecedentes, esclarecer dúvidas e retomar a resposta. As IAs podem ajudar em qualquer dessas atividades; o interesse é avaliar a colaboração que os recursos tornam possível.
Se compararem com seu fluxo habitual, mantenham o mesmo acesso a pessoas, informações, modelos, canais e testes automatizados. Nos dois percursos deve ser possível tomar iniciativa sem tarefa atribuída. Observem o que a preservação e as relações explícitas acrescentam, incluindo seu custo, e se cada pessoa encontra razões para continuar contribuindo. Um teste técnico bem-sucedido não responde sozinho a essas perguntas.
Verificar a leitura a frio, inclusive em um modelo menos capaz¶
Depois de guardar um rascunho real selecionado pelo autor, abra uma conversa nova, sem o histórico original, e anexe somente o guia de primeiro uso e esse rascunho. Peça ao Gemini que identifique a formulação, quem a assumiu, o que permanece incerto e quais relações estão declaradas; repita com outro modelo ou configuração disponível, sem acrescentar explicações. Inclua no conjunto um trabalho parcial ou uma hipótese corrigida. Anote omissões, autorias trocadas, relações inventadas e o esforço de revisão. A leitura correta de um exemplo não certifica o modelo nem o protocolo; uma falha orienta melhoria do rascunho ou das instruções, sem autorizar inventar dados faltantes.
Escopo da bancada técnica¶
Os passos seguintes verificam armazenamento, preparação e limites de acesso dos componentes de referência. A facilidade de começar pelo site, a fidelidade das descrições produzidas pelo Gemini e o benefício da colaboração precisam ser observados nos testes de uso.
Preparar o ambiente¶
Uma máquina hospeda os arquivos e executa o servidor durante o teste. Os demais aparelhos acessam pelo navegador. No Android, não é necessário instalar Rust. Use as pastas locais protocol e website, com as fontes da mesma edição. A primeira contém os componentes da bancada; a segunda, as páginas e o gerador do site. As obras usadas na geração vêm do repositório publications. Obtenha as fontes nos repositórios indicados ou use cópias locais correspondentes à mesma edição.
Use Python 3.11+, Rust 1.88+ e OpenSSL que aceite a opção req -addext.
Reutilize as dependências já instaladas. A preparação local já inclui as dependências
do protocolo e das obras; ao começar com três pastas separadas, execute
python3 tools/attach_protocol.py --source ../protocol e
python3 tools/attach_publications.py --source ../publications a partir de website.
Na pasta website:
cargo build --manifest-path protocol/reference/legible-core/Cargo.toml
python3 -m venv .venv
.venv/bin/python -m pip install -r site/requirements.lock
.venv/bin/python site/legible_build.py --mode preview
export PYTHONPATH="$PWD/protocol/reference/legible-mcp"
export LEGIBLE_BIN="$PWD/protocol/reference/legible-core/target/debug/legible"
.venv/bin/python -m legible_mcp.pilot init --runtime "$PWD/.local/pilot" --lan-host IP_DO_WIFI --participant seu-id --participant outro-id
.venv/bin/python -m legible_mcp.pilot doctor --runtime "$PWD/.local/pilot"
.venv/bin/python -m legible_mcp.pilot serve --runtime "$PWD/.local/pilot" --bind 0.0.0.0
Troque seu-id e outro-id pelos identificadores dos dois participantes: letras minúsculas sem acento, números e hífens simples. Esses identificadores nomeiam os espaços privados e a autoria declarada dos rascunhos; não são DIDs nem prova de identidade civil. Em um ensaio fictício, use participante-a e participante-b; escolha os identificadores reais apenas no seu ambiente privado. Ambientes já criados não são renomeados nem sobrescritos.
Troque IP_DO_WIFI pelo endereço da máquina na rede. No Mac, consulte ipconfig getifaddr en0 ou as configurações de Wi-Fi. Inicialize apenas uma vez; o comando se recusa a sobrescrever um ambiente existente.
O site fica em https://IP_DO_WIFI:8443/pt/ e o fluxo privado em https://IP_DO_WIFI:8443/pilot/. Para inglês, use /en/ no site e /pilot/?lang=en na página do piloto. O endereço MCP é https://IP_DO_WIFI:8443/mcp. Não abra a pasta de trabalho por um servidor genérico.
Os aparelhos precisam estar na mesma rede, com comunicação entre dispositivos permitida. Mantenha a máquina acordada e autorize este processo Python no firewall apenas para a rede local de confiança. Não encaminhe portas ao exterior.
Certificado e acesso individual¶
O servidor cria um certificado HTTPS local de 30 dias. Ele não é uma chave de assinatura de registros. Transfira somente tls-cert.pem do diretório privado para os aparelhos de teste, por um caminho de confiança. Compare a impressão:
openssl x509 -in .local/pilot/tls-cert.pem -noout -fingerprint -sha256
Reconheça esse certificado nas configurações do navegador/sistema. No Android, procure instalação de certificado e credenciais: a confiança é para HTTPS, não para autenticação Wi-Fi. Os menus variam; aparelhos gerenciados podem impedir isso. Confirme a confiança no aparelho real antes de usar dados sensíveis. Não desative a verificação TLS do cliente MCP. Remova a confiança do piloto quando o teste acabar. O servidor não altera essas configurações automaticamente. Se o IP mudar, pare e configure outro ambiente, preservando os arquivos anteriores.
Cada pessoa recebe somente o arquivo .local/pilot/SEU_ID-access.json que lhe corresponde, por um canal de confiança. Na página, cada pessoa cola seu browser_token. A credencial mcp_token é diferente e serve apenas ao MCP. Não cole credenciais no Gemini nem as inclua em URLs ou capturas de tela. Recarregar ou sair da página limpa a credencial daquela sessão no navegador, mas não revoga uma cópia do token; para revogar, pare o servidor e substitua o segredo correspondente na configuração privada.
Os espaços privados não se misturam. Compartilhar copia a versão escolhida para o espaço do destinatário, preservando origem, autoria declarada e bytes. Quem administra a máquina hospedeira continua podendo ler seus arquivos; o isolamento testado é entre pedidos dos participantes pela aplicação. Não há criptografia em repouso ou proteção contra administrador/malware.
Usar Gemini com a bancada já configurada¶
- Entre na página local com sua credencial.
- Anexe o arquivo único de primeiro uso e copie a instrução do site para o Gemini. Se não conseguir anexar, cole o conteúdo. Não peça ao Gemini para abrir um endereço privado da sua rede. A instrução da bancada é um auxílio para o trabalho, não substitui o material de referência.
- Trabalhe no seu software, relatório, estratégia ou outro resultado habitual. Peça uma proposta pequena sobre uma direção, critério, correção de rota ou julgamento que realmente fez. O conhecimento tácito pode exigir perguntas.
- Cole o Markdown proposto na página local. Revise autoria, formulação, referências e contexto. Guarde privadamente ou descarte; nada foi enviado ao outro participante.
- Escolha uma versão e o destinatário. Leia o diálogo antes de compartilhar.
- A outra pessoa atualiza a lista, lê e prepara sua contribuição relacionada. Ela compartilha a resposta escolhida; a primeira recupera e considera.
O Gemini é o provedor escolhido pelos participantes. Só envie contexto que possa ser processado por ele. O servidor não chama modelos, sincroniza Drive ou envia automaticamente arquivos ao Google.
Anexos e integrações dependem da conta. Drive exige condições de atividade, conexão Workspace e, em contas de trabalho, administração. Apps MCP personalizados têm restrições atuais de região, conta e idioma; o piloto não depende dessa conexão. Consulte anexos no Android e apps personalizados.
Rascunho e preparação formal pelo mesmo caminho¶
Os rascunhos usam Legible Draft, com os campos técnicos Genealogy 0.1. O mesmo armazenamento e o mesmo core Rust atendem à página e ao MCP. Não há conversão do rascunho em declaração assinada.
Para preparar uma declaração formal, selecione seu rascunho, informe seu DID público Ed25519 e revise o conteúdo proposto. A associação do DID ao login é declarada; não prova controle da chave. Para Appoint, há uma proposta editável. Trace e Nod exigem preenchimento explícito, para que a ferramenta não presuma peso, dependência ou consequência. O resultado é um arquivo novo, não assinado, com referência ao hash dos bytes do rascunho.
Confira o arquivo exato e baixe-o para seu ambiente confiável. A assinatura segue o caminho de terminal já documentado no pacote, fora do servidor. É válido guardar o registro assinado privadamente. Assinatura móvel nativa, importação e compartilhamento de registros assinados pela página não fazem parte desta entrega.
MCP e diagnóstico na rede¶
Um segundo desktop pode testar o endpoint com o cliente de diagnóstico das fontes, seu próprio arquivo de acesso e o certificado público:
export PYTHONPATH="$PWD/reference/legible-mcp"
python3 -m legible_mcp.probe --url https://IP_DO_WIFI:8443/mcp --access /CAMINHO/PRIVADO/SEU_ID-mcp-access.json --ca /CAMINHO/tls-cert.pem
Execute a partir da raiz do protocolo. O resultado informa TLS, edição negociada, ferramentas e quantidade de rascunhos acessíveis, sem mostrar segredos ou conteúdo. O cliente de IA deve aceitar Streamable HTTP, cabeçalho Bearer individual e confiança no certificado local. O formato de configuração varia por cliente; o diagnóstico não certifica um host externo.
O perfil local de credenciais não implementa OAuth MCP. A conexão nativa Gemini–MCP local continua não verificada. O transporte HTTP oferece respostas JSON e negocia 2025-03-26, 2025-06-18 e 2025-11-25. Não há SSE. Consulte o guia técnico no repositório do protocolo para o contrato de sessões, ferramentas, assinatura e limites do ambiente.
Se o cliente desktop já usa stdio, configure a ponte local
legible_mcp.lan_stdio para o endpoint HTTPS. Ela usa o mesmo armazenamento
e perímetro, sem abrir diretamente os diretórios privados. O template completo
está em docs/local-pilot.md no repositório do protocolo. Entregue ao cliente somente
SEU_ID-mcp-access.json, nunca o arquivo de acesso do
navegador. Não rode dois processos escrevendo diretamente no mesmo espaço.
Avaliação de atrito e limite desta etapa¶
Use um trecho curto de trabalho real. Marque tempo, trocas de aplicativo, correções da proposta e dúvidas de permissão. Verifique:
- reenvio idêntico sem duplicação;
- resposta da pessoa B com autoria própria, recuperável pela pessoa A;
- reformulação substancial como novo Appoint e Trace separado;
- sessão compartilhada com autoria ambígua explicitada, não adivinhada;
- referência à evidência privada sem acesso liberado ao outro participante;
- preparação formal guardada privadamente, sem assinatura ou envio automáticos.
Para evidência restrita, comece com um texto fictício pequeno: guarde na área privada da página e cite o hash. Arquivos reais podem permanecer no armazenamento que já usam; a página não os busca. Busca nesta etapa é literal, não inferência.
Comparar a coordenação, não o tamanho da rede¶
As pessoas A e B podem comparar dois percursos curtos: boas notas convencionais com IA; e contribuições preservadas e relacionadas com Legible. Mantenham as mesmas pessoas, modelos, informações, permissões, canais de contato e orçamento de tempo. Ambos podem contribuir sem tarefa atribuída. Não comparem uma rede com alguém isolado, nem forneçam só a um percurso acesso a fontes úteis.
Usem situações de dificuldade semelhante e alternem a ordem dos percursos, anotando diferenças e aprendizado entre tentativas. No piloto com duas pessoas, essa comparação é exploratória, não uma estimativa causal ou prova de superioridade. Avaliem separadamente o efeito da preservação, das relações explícitas e da possibilidade de iniciativa sem alocação; não atribuam todo resultado ao formato.
| Resultado observado | O que anotar |
|---|---|
| Correção técnica | Formato, origem, relações, reenvio, isolamento e esforço de correção |
| Facilidade de participação | Tempo para ler e trocar, aplicativos, pedidos de ajuda e limites de acesso |
| Coordenação aberta | Ocasião de contribuir encontrada sem convite, mudança do problema, alternativa inesperada ou reconsideração após recusa |
| Sustentação da participação | Benefício relatado por cada pessoa, esforço total e disposição de continuar contribuindo |
Deixem a pessoa B decidir se quer acrescentar algo à formulação recebida, inclusive por um caminho diferente do escolhido por A. Atribuir-lhe uma tarefa apenas para obter o resultado esperado retiraria do teste a iniciativa que se pretende observar. Separem sugestões da IA, declarações dos participantes e evidências. Anotem também a ausência de resultado útil, sem fabricar Nods ou deduzir desinteresse da falta de registros. A participação de uma terceira pessoa fica como extensão do piloto.
A busca local procura termos literais; a pertinência contextual pode ser examinada no chat com os arquivos selecionados. Registrem o atrito encontrado para orientar ajustes nas ferramentas e nas instruções.
Se a busca encontrar uma entrada ilegível, a página mostra um aviso persistente e lista as íntegras. Confira o arquivo e o hash indicados; a falha não apaga a contribuição. Diferenças apenas de quebra de linha recebem explicação própria, sem substituição automática do original. Origem e autoria de rascunhos seguem declaradas, não autenticadas.