Para usuarios de Cline

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

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.

Empieza gratis Leer la configuración de Cline

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

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.

// archivo de configuración

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.

// transporte

Remoto, por URL

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

// clave

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.

// tipo

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.

# .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.

// workflow 01

Planear un cambio desde puntos de llamada reales

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.

// workflow 02

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

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.

// step 01

Indexa un repo en maguyva.ai

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

// step 02

Agrega Maguyva a la configuración MCP de Cline

cline_mcp_settings.json

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

// step 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.