# AGENTS.md le dice a OpenCode tus reglas. Maguyva le muestra el código.

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

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

OpenCode lee en AGENTS.md cómo trabajar y llama a servidores MCP para todo lo demás. Maguyva es un servidor MCP remoto que le da a OpenCode un mapa consultable de tu repo, con rutas de archivo y números de línea.

> Una entrada remota bajo mcp. Nada corre en local.

## Lo que necesitas saber de OpenCode

Cuatro datos propios de OpenCode.

### opencode.json

Agrega el servidor bajo `mcp` en el `opencode.json` de tu proyecto, o en `~/.config/opencode/opencode.json` para todos tus proyectos.

### type: remote

OpenCode se conecta por HTTP al endpoint de Maguyva. Nada corre en local y no necesitas Node.js.

### Una referencia a variable de entorno

OpenCode sustituye variables de entorno en su configuración, así que el encabezado queda como `Bearer {env:MAGUYVA_API_KEY}` y la clave no entra en el archivo que subes al repo.

### Limítalo por agente

Cada servidor MCP agrega definiciones de herramientas al contexto. OpenCode puede desactivar globalmente las herramientas de un servidor con un glob como `"maguyva*": false` y volver a activarlas solo para los agentes que las necesitan.

## AGENTS.md es un acuerdo de trabajo. Úsalo.

```text
> /init
# analiza el repo y escribe AGENTS.md
```

OpenCode lee `AGENTS.md` en la raíz del proyecto y `~/.config/opencode/AGENTS.md` para reglas personales. Si no hay `AGENTS.md`, recurre a `CLAUDE.md`. Úsalo para:

- Comandos de build, pruebas y lint.
- Convenciones y límites que el agente debe respetar.
- Referencias a la documentación que importa.

Un análisis en el momento de `/init` es un resumen, no un índice. No le va a decir a OpenCode quién llama a una función agregada ayer.

## Donde AGENTS.md se queda corto

Tres huecos que OpenCode llena con grep y paciencia.

### // un resumen no es un índice

AGENTS.md puede nombrar los paquetes importantes. No puede listar cada símbolo y punto de llamada, ni debería intentarlo.

### // grep encuentra cadenas, no llamadores

Una coincidencia de texto no distingue una llamada real de un comentario, un mock o un método con el mismo nombre en otra clase.

### // el archivo se desfasa

AGENTS.md es correcto el día que se escribe. El código sigue moviéndose; el archivo cambia cuando alguien se acuerda de actualizarlo.

## Maguyva como servidor MCP remoto en OpenCode

Una entrada bajo mcp le da a OpenCode:

- **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.
- **Las mismas respuestas para cualquier modelo**: OpenCode funciona con muchos proveedores de modelos. Maguyva devuelve el mismo mapa sin importar qué modelo pregunte.

> AGENTS.md le dice a OpenCode *cómo trabajar*.
> Maguyva le da a OpenCode *algo con qué trabajar*.

## Dos flujos de trabajo

Consulta el mapa desde la misma terminal.

### 01. Renombrar un tipo compartido entre paquetes

```text
opencode> renombra OrderStatus a FulfillmentStatus

dependency_search("OrderStatus", dependents)
  23 referencias en 8 paquetes
structural_search(switch_statement, "OrderStatus")
  4 switch exhaustivos

→ OpenCode edita la lista completa, switch incluidos.
[exit 0]
```

Los switch exhaustivos son justo los que una búsqueda de texto pasa por alto y el compilador detecta tarde.

### 02. Distinguir código de documentación

```text
opencode> ¿dónde se lee FEATURE_BULK_EXPORT?

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← solo docs

→ Dos rutas de código, un doc desactualizado.
[exit 0]
```

Las coincidencias exactas vuelven con sus rutas, así OpenCode distingue código de documentación antes de editar cualquiera de los dos.

## Configuración en OpenCode

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 bajo mcp en opencode.json

`opencode.json`

```json
{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

### 03. Exporta tu clave y revisa la conexión

Define `MAGUYVA_API_KEY` en la shell que inicia OpenCode. `opencode mcp list` muestra cada servidor configurado; luego haz una pregunta cuya respuesta ya conozcas.

La [documentación de MCP](https://opencode.ai/docs/mcp-servers/) de OpenCode cubre tiempos de espera, OAuth y acceso a herramientas por agente.

## Indexa un repo que ya conozcas.

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