Layerdock

Como conectar seu agente de codificação ao Layerdock

O Layerdock inclui um servidor MCP, então qualquer agente de codificação que fale o Model Context Protocol pode listar seus docks, ler o feedback neles, responder em um thread e resolver um pin. O objetivo é o ciclo completo: de “um revisor sinalizou isso” até “está corrigido e eles foram avisados” sem sair do editor. A configuração é um token, um bloco de configuração e uma reinicialização.

O que seu agente faz depois de conectado

1. Ele lê o feedback. Cada pin aberto chega com o seletor CSS, a captura de tela e a URL da página, além do trace de console e rede capturado quando o pin foi reportado e as especificações exatas de design do elemento do Inspect (espaçamento, raio, tipografia, cores). Esse contexto completo vem com o MCP tanto no Pro quanto no Agency; visualizar os logs de console e rede dentro do dashboard é a parte exclusiva do Agency.
2. Ele corrige o problema. Seu agente já tem o repositório aberto. Ele tem o seletor, então sabe qual elemento o revisor quis dizer, não apenas qual página.
3. Ele responde e resolve. A resposta chega no thread que seu revisor está acompanhando e o pin muda para resolvido. Ninguém sai do editor para fechar o ciclo.

Passo 1: criar um token

Abra Integrations → Coding agents e dê um nome ao token baseado na máquina de onde você vai usá-lo, para saber qual revogar depois. O Layerdock armazena apenas um hash dele, então o valor em texto puro é mostrado exatamente uma vez, na criação — copie-o antes de sair da página. Um token age como você: ele pode ler todos os docks que você pode acessar e responder ao feedback em seu nome, sob as mesmas regras de função que se aplicam a você no dashboard.

Passo 2: adicionar a configuração para seu editor

Escolha seu editor abaixo e você recebe o bloco que ele precisa, no arquivo em que ele deve estar. Substitua ldk_your_token_here pelo token que você acabou de copiar. Se o arquivo já existir, mescle o bloco no objeto que já está lá em vez de colar por cima: uma configuração que não é mais interpretada é o motivo mais comum para o servidor nunca aparecer.

.mcp.json Raiz do repositório

{
  "mcpServers": {
    "layerdock": {
      "command": "npx",
      "args": ["-y", "@layerdock/mcp"],
      "env": { "LAYERDOCK_TOKEN": "ldk_your_token_here" }
    }
  }
}

Este arquivo normalmente é commitado. Em um repositório compartilhado, exporte LAYERDOCK_TOKEN no seu shell e coloque "${LAYERDOCK_TOKEN}" no valor da env em vez do token em si, para que seu token pessoal nunca entre no histórico do git.

Antes de reiniciar: aqueça o cache

Execute isto uma vez, em um terminal, antes de seu editor tentar conectar:

npx -y @layerdock/mcp --version

npx baixa o pacote na primeira vez que o executa, e em uma conexão lenta esse download pode demorar mais do que seu editor permite para um servidor MCP iniciar — 30 segundos no Claude Code. O resultado é um CONNECT_TIMEOUT em um servidor que está funcionando perfeitamente. O comando acima o coloca no cache do npx e sai; toda inicialização depois disso é instantânea. Se você já atingiu o timeout, execute-o e reinicie seu editor.

Qualquer outro cliente MCP

Nada acima é específico para esses sete editores. Qualquer cliente MCP funciona: dê a ele o comando npx -y @layerdock/mcp e a variável de ambiente LAYERDOCK_TOKEN, em qualquer arquivo ou tela de configurações onde ele mantém servidores MCP. O pacote é publicado no npm como @layerdock/mcp e não precisa de instalação global; npx o busca na primeira execução.

Passo 3: verifique se funcionou

1. Reinicie seu editor. Servidores MCP são lidos uma vez, na inicialização. Saia do aplicativo e abra-o novamente; recarregar a janela nem sempre é suficiente.
2. Confirme que conectou. No Claude Code, digite /mcp e o Layerdock deve aparecer como conectado. Em qualquer outro cliente, peça ao agente para listar as ferramentas que ele tem e procure pelas do Layerdock.
3. Dê algo para ele fazer. Abra um dock que tenha feedback e tente o prompt abaixo.

Leia o feedback aberto do Layerdock neste dock, corrija o que puder, depois responda em cada pin e resolva-o.

Se o servidor não aparecer

O cliente nunca lista o servidor. Quase sempre é o arquivo, não o token. Verifique se ele ainda é interpretado após sua edição (uma vírgula solta quebra toda a configuração), se você mesclou o bloco no objeto existente em vez de colar por cima, e se você usou o bloco para este cliente — VS Code e Zed nomeiam a chave de forma diferente.

Ele atinge o timeout na primeira inicialização. Quase sempre é um download frio do npx excedendo o orçamento de inicialização do cliente, não um problema com o servidor. Execute npx -y @layerdock/mcp --version uma vez em um terminal e reinicie seu editor — a segunda inicialização lê do cache do npx e conecta imediatamente.

Ele conecta, mas toda chamada volta como não autorizada. O token está errado ou não é mais válido. Confirme se o prefixo na sua configuração corresponde a um token listado como Ativo na página Coding agents e se você colou o valor inteiro. Tokens não podem ser lidos de volta, então se você não tiver certeza, revogue-o e crie um novo.

Relacionado

Para saber o que o agente realmente recebe e por que isso importa, veja AI bug fixing with MCP. Este guia assume que você já tem um dock com feedback nele. Se não, comece com collecting client feedback on a website, ou veja pricing.