# Instrucciones para el agente: Plumb: lleva Figma o una web a un grafo de diseño

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/tathagat22/plumb-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/plumb-figma-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: comprueba los requisitos

Comprueba que Node.js ≥20 y npm están disponibles, que tu editor admite MCP y que Figma Desktop abre el archivo de ensayo. Deja la carga del plugin para después de instalar el paquete.

### Paso 2: instalación según el README

```text
npm install -g plumb-mcp
plumb-mcp init
```

### Paso 3: carga el plugin y empareja

Localiza `plumb-mcp/figma-plugin/manifest.json` dentro del directorio que devuelve `npm root -g`, como indica el README. En Figma Desktop abre Plugins → Development → Import plugin from manifest, selecciona ese archivo, ejecuta Plumb y pulsa **Pair with Plumb**. Mantén el plugin abierto.

## Comprobación

Pide al agente llamar `plumb_status` y leer una pantalla de prueba. Comprueba que sus nodos corresponden al lienzo.

## Si algo falla

Si falla el emparejamiento, revisa que el plugin siga abierto y el cliente use el servidor configurado por init. Sigue el quick start del README para localizar el manifest.

[Procedimiento oficial](https://github.com/tathagat22/plumb-mcp#readme).