Layerdock

Cómo conectar tu agente de codificación a Layerdock

Layerdock incluye un servidor MCP, por lo que cualquier agente de codificación que hable el Protocolo de Contexto de Modelos puede listar tus docks, leer los comentarios sobre ellos, responder en un hilo y resolver un pin. El objetivo es el ciclo completo: de "un revisor marcó esto" a "está arreglado y se le ha informado" sin salir del editor. La configuración es un token, un bloque de configuración y un reinicio.

Qué hace tu agente una vez conectado

1. Lee los comentarios. Cada pin abierto llega con el selector CSS, la captura de pantalla y la URL de la página, además del rastro de consola y red capturado cuando se reportó el pin y las especificaciones de diseño exactas del elemento desde Inspect (espaciado, radio, tipografía, colores). Ese contexto completo viene con MCP tanto en Pro como en Agency; ver los registros de consola y red dentro del panel es la parte exclusiva de Agency.
2. Arregla el problema. Tu agente ya tiene el repositorio abierto. Tiene el selector, así que sabe qué elemento quiso decir el revisor, no solo qué página.
3. Responde y resuelve. La respuesta llega al hilo que tu revisor está viendo y el pin cambia a resuelto. Nadie sale del editor para cerrar el ciclo.

Paso 1: crea un token

Abre Integraciones → Agentes de codificación y nombra un token según la máquina desde la que lo usarás, para saber cuál revocar más tarde. Layerdock almacena solo un hash del mismo, por lo que el valor en texto plano se muestra exactamente una vez, al crearlo: cópialo antes de salir de la página. Un token actúa como tú: puede leer cada dock al que tengas acceso y responder a los comentarios en tu nombre, bajo las mismas reglas de rol que se aplican a ti en el panel.

Paso 2: añade la configuración para tu editor

Elige tu editor a continuación y obtendrás el bloque que necesita, en el archivo donde debe ir. Reemplaza ldk_your_token_here con el token que acabas de copiar. Si el archivo ya existe, fusiona el bloque en el objeto que ya está allí en lugar de pegarlo encima: una configuración que ya no se analiza es la razón más común por la que el servidor nunca aparece.

.mcp.json Raíz del repositorio

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

Este archivo normalmente se confirma. En un repositorio compartido, exporta LAYERDOCK_TOKEN en tu shell y pon "${LAYERDOCK_TOKEN}" en el valor de la variable de entorno en lugar del token en sí, para que tu token personal nunca llegue al historial de git.

Antes de reiniciar: calienta la caché

Ejecuta esto una vez, en una terminal, antes de que tu editor intente conectarse:

npx -y @layerdock/mcp --version

npx descarga el paquete la primera vez que lo ejecuta, y en una conexión lenta esa descarga puede tardar más de lo que tu editor permite que un servidor MCP arranque: 30 segundos en Claude Code. El resultado es un CONNECT_TIMEOUT en un servidor que funciona perfectamente. El comando anterior lo coloca en la caché de npx y sale; cada lanzamiento posterior es instantáneo. Si ya has superado el tiempo de espera, ejecútalo y reinicia tu editor.

Cualquier otro cliente MCP

Nada de lo anterior es específico de esos siete editores. Cualquier cliente MCP funciona: dale el comando npx -y @layerdock/mcp y la variable de entorno LAYERDOCK_TOKEN, en el archivo o pantalla de configuración donde guarde los servidores MCP. El paquete se publica en npm como @layerdock/mcp y no necesita instalación global; npx lo obtiene en la primera ejecución.

Paso 3: comprueba que funcionó

1. Reinicia tu editor. Los servidores MCP se leen una vez, al inicio. Cierra la aplicación y ábrela de nuevo; recargar la ventana no siempre es suficiente.
2. Confirma que se conectó. En Claude Code, escribe /mcp y Layerdock debería aparecer como conectado. En cualquier otro cliente, pide al agente que liste las herramientas que tiene y busca las de Layerdock.
3. Dale algo que hacer. Abre un dock que tenga comentarios y prueba el siguiente prompt.

Lee los comentarios abiertos de Layerdock en este dock, arregla lo que puedas, luego responde en cada pin y resuélvelo.

Si el servidor no aparece

El cliente nunca lista el servidor. Casi siempre es el archivo, no el token. Comprueba que siga analizándose después de tu edición (una coma suelta rompe toda la configuración), que fusionaste el bloque en el objeto existente en lugar de pegarlo encima, y que usaste el bloque para este cliente: VS Code y Zed nombran la clave de manera diferente.

Se agota el tiempo en el primer lanzamiento. Casi siempre es una descarga fría de npx que supera el presupuesto de inicio del cliente, no un problema del servidor. Ejecuta npx -y @layerdock/mcp --version una vez en una terminal y reinicia tu editor: el segundo lanzamiento lee desde la caché de npx y se conecta inmediatamente.

Se conecta, pero cada llamada devuelve no autorizado. El token es incorrecto o ya no es válido. Confirma que el prefijo en tu configuración coincide con un token listado como Activo en la página de Agentes de codificación, y que pegaste el valor completo. Los tokens no se pueden leer de nuevo, así que si no estás seguro, revócalo y crea uno nuevo.

Relacionado

Para saber qué recibe realmente el agente y por qué importa, consulta Corrección de errores con IA mediante MCP. Esta guía asume que ya tienes un dock con comentarios. Si no es así, comienza con recopilar comentarios de clientes en un sitio web, o consulta precios.