# Instrucciones para el agente: Pluck: busca y lee símbolos de código mediante MCP

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/hunhee98/pluck (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/pluck-code-retrieval

---

## 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: instala las herramientas

Comprueba que Rust y Cargo están disponibles, junto con compiladores C/C++ para las dependencias nativas. Los manifiestos de Pluck no fijan un mínimo numérico de Rust; usa un entorno estable actual que resuelva sus dependencias. En Linux revisa también OpenSSL y pkg-config para la dependencia `native-tls` declarada en el [Cargo.toml](https://github.com/hunhee98/pluck/blob/main/Cargo.toml). Si prefieres binarios, sigue la alternativa Homebrew del README antes de registrar MCP.

```bash
cargo install pluck-mcp pluck-cli
```

### Paso 2: registra el proyecto

El README da esta sintaxis para Claude Code; sustituye el parámetro por la ruta real:

```text
claude mcp add --transport stdio --scope project pluck -- pluckd --repo <repo-root>
```

Recarga el cliente si lo requiere. Pide una búsqueda de código y verifica qué herramienta utiliza antes de añadir reglas permanentes.

## Comprobación

El servidor `pluck` debe conectarse y exponer herramientas de lectura y búsqueda. Compara una función recuperada con el archivo original y comprueba una referencia conocida.

## Si algo falla

Si no encuentra símbolos, revisa la raíz indexada y los formatos soportados. Si el agente sigue leyendo archivos completos, revisa su política de recuperación; no confundas eso con un fallo del servicio en segundo plano.