# Cline planea antes de actuar. Dale un mapa al plan.

Canonical source: https://maguyva.ai/es/for-cline

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Cline lee archivos, ejecuta comandos y pregunta antes de cambiar cualquier cosa. Maguyva indexa todo el repo y lo devuelve vía MCP, así el modo Plan arranca desde puntos de llamada reales y no desde un listado de directorios.

> Usa .clinerules para cómo trabajar. Usa Maguyva para lo que dice el código hoy.

## Lo que necesitas saber de Cline

Cuatro datos propios de Cline.

### cline_mcp_settings.json

Ábrelo desde el ícono MCP Servers del panel de Cline: pestaña Configure y luego Configure MCP Servers. Los servidores van bajo `mcpServers`.

### Remoto, por URL

Cline se conecta al endpoint de Maguyva por Streamable HTTP. Sin procesos locales ni Node.js.

### Un encabezado literal

La clave va directamente en el encabezado `Authorization`, como en los ejemplos del propio Cline. El archivo de ajustes vive en el almacenamiento de usuario de tu editor, no en tu repo.

### streamableHttp, no SSE

Mantén `"type": "streamableHttp"` en la entrada: sin tipo, Cline asume el SSE heredado. Pon en `autoApprove` las herramientas en las que confías para saltarte su aviso de aprobación.

## Las reglas de Cline son un acuerdo de trabajo. Úsalas.

```text
# .clinerules/testing.md
- Ejecuta la suite de pruebas antes de marcar una tarea como completa.
- Pregunta antes de agregar una dependencia.
```

Las reglas del espacio de trabajo son archivos Markdown en `.clinerules/` o `.cline/rules/`; Cline también lee `AGENTS.md`, `.cursorrules` y `.windsurfrules`. Las reglas son el lugar indicado para:

- Comandos que Cline debe ejecutar.
- Barreras limitadas a una ruta con un glob en el frontmatter.
- Convenciones del equipo que ya te cansaste de repetir.

Las reglas le dicen a Cline cómo comportarse. No le dicen qué servicios leen la tabla que está por migrar.

## Donde las reglas y la lectura de archivos se quedan cortas

Tres huecos que Cline llena leyendo más archivos, una solicitud a la vez.

### // un plan hecho a partir de un listado

El modo Plan razona a partir de lo que Cline leyó hasta ahora. En un repo grande, eso es un árbol de directorios y unos pocos archivos, y el plan hereda los huecos.

### // cada lectura es un viaje de ida y vuelta

Cada archivo que Cline abre para orientarse cuesta tokens y una solicitud al modelo. Orientarse en un paquete desconocido puede consumir buena parte de la ventana de contexto antes de la primera edición.

### // la búsqueda de texto encuentra cadenas, no llamadores

“¿Quién más llama a esto?” es una pregunta de grafo. Una búsqueda de texto encuentra la cadena, pero no separa a los llamadores reales de un comentario, un mock o un método con el mismo nombre.

## Maguyva como servidor MCP en Cline

Una entrada en mcpServers le da a Cline:

- **11 herramientas sobre tu repo indexado**: búsqueda semántica, estructural (AST), de grafo y de texto, además de búsqueda de símbolos, dependientes y recuperación de archivos.
- **Respuestas con rutas de archivo y números de línea**: en 285+ lenguajes, así un plan cita archivos reales.
- **Herramientas que solo leen**: Las herramientas de Maguyva consultan el índice. Ninguna edita tus archivos.

> Las reglas de Cline le dicen *cómo trabajar*.
> Maguyva le da a Cline *un mapa para planear*.

## Dos flujos de trabajo

Planea con el mapa y después actúa.

### 01. Planear un cambio desde puntos de llamada reales

```text
cline plan> mueve la renovación de sesión al paquete auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ El plan lista tres puntos de llamada antes de que empiece el modo Act.
[exit 0]
```

El plan nombra cada archivo que va a tocar, así apruebas una lista, no una corazonada.

### 02. Encontrar la implementación real, no el fixture de prueba

```text
cline> ¿cómo calculamos el prorrateo?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← implementación
  test/billing/proration.spec.ts:7   ← fixture

→ Cline lee un archivo en lugar de seis.
[exit 0]
```

Los resultados priorizados ponen la implementación por encima del fixture que comparte su nombre.

## Configuración en Cline

Tres pasos. Nivel Free: 3 repositorios, Hasta 50 mil líneas de repo indexadas, sin tarjeta.

### 01. Indexa un repo en maguyva.ai

Elige uno que ya conozcas, así puedes evaluar las respuestas.

### 02. Agrega Maguyva a la configuración MCP de Cline

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 03. Reemplaza el marcador y haz una pregunta

Cambia `mgv_xxxx` por tu clave de API y guarda el archivo. Haz una pregunta cuya respuesta ya conozcas y luego abre el archivo citado.

La [documentación de MCP](https://docs.cline.bot/mcp/mcp-overview) de Cline cubre los servidores remotos, los tiempos de espera y la aprobación automática.

## Indexa un repo que ya conozcas.

Conecta Cline vía MCP y haz una pregunta que puedas comprobar.