Integraciones de IDE

Korva trae integraciones first-class para ocho editores vía Model Context Protocol. Un solo comando — korva setup — auto-configura cualquiera de ellos. Las mismas herramientas Vault se exponen en todos lados; solo el formato del archivo de config cambia.

Actualizado: 2026-04-30

Korva trae integraciones first-class para ocho editores. Ejecuta un solo comando:

korva setup --all

…y cada editor soportado en tu máquina queda cableado automáticamente. Para elegir uno específico:

korva setup claude-code
korva setup cursor
korva setup vscode
korva setup copilot
korva setup windsurf
korva setup codex
korva setup opencode
korva setup gemini

korva setup es idempotente — seguro de ejecutar múltiples veces. Nunca duplica entradas y nunca sobrescribe claves no relacionadas en tu config.

Matriz de cobertura

Editor	Estado	Archivo(s) de config	Comando de setup
Claude Code	✅ Estable	`.mcp.json`, `CLAUDE.md`	`korva setup claude-code`
Cursor	✅ Estable	`.cursorrules`, `mcp.json`	`korva setup cursor`
VS Code (con MCP)	✅ Estable	`settings.json` (combinado)	`korva setup vscode`
GitHub Copilot	✅ Estable	`.github/copilot-instructions.md`	`korva setup copilot`
Windsurf	✅ Estable	`global_rules.md`, `mcp_config.json`	`korva setup windsurf`
OpenAI Codex	✅ Estable	`.codex-plugin.json`	`korva setup codex`
OpenCode	✅ Estable	`opencode.json`	`korva setup opencode`
Gemini CLI	✅ Estable	`gemini-extension.json`, `GEMINI.md`	`korva setup gemini`

La config MCP estándar

Cada IDE que soporta MCP nativamente recibe el mismo bloque mínimo:

{
  "mcpServers": {
    "korva-vault": {
      "type": "stdio",
      "command": "korva-vault",
      "args": ["mcp"],
      "env": { "KORVA_MCP_PROFILE": "agent" }
    }
  }
}

korva-vault se distribuye como un único binario — sin node_modules, sin venv de Python, sin Docker. El servidor MCP es el mismo proceso Go que sirve HTTP en :7437.

Ciclo de vida universal de sesión

Cada IDE sigue el mismo workflow:

Lee BEHAVIOR.md en la raíz del repo (cuatro principios universales: pensar antes de codear, simplicidad primero, cambios quirúrgicos, ejecución orientada al objetivo).
Llama a vault_context al inicio de la sesión con project, prompt y file_paths.
Aplica los auto_skills retornados silenciosamente como guidance autoritativa.
Antes de decisiones de arquitectura: vault_hint (10× más barato que vault_search).
Para discovery completo: vault_search.
Tras trabajo significativo: vault_save con un type (decision, pattern, bugfix, learning, refactor).
Para outputs largos a la memoria: vault_compress con mode=full.
Al cerrar: vault_session_end con un resumen.

Smart Skill Auto-Loader (funciona en cada IDE)

Cuando vault_context recibe prompt + file_paths, el Vault:

Detecta el proyecto activo.
Consulta la BD del equipo por skills marcados con auto_load=1.
Puntúa cada skill: patrón de archivo (45 %) + keywords (30 %) + project (15 %) + tags (10 %).
Devuelve los mejores matches inline con cuerpo completo y la razón del match.

Diferenciadores por IDE

Editor	Qué tiene de distinto
Claude Code	`.mcp.json` separado, `CLAUDE.md` detallado con el workflow universal
Cursor	Combina reglas en `.cursorrules` con config MCP en `mcp.json`
Copilot	Instrucciones vía `github.copilot.chat.codeGeneration.instructions` apuntando a `BEHAVIOR.md` y `CLAUDE.md`
VS Code	Config combinado: Copilot + MCP + `korva.vault.endpoint` explícito
Windsurf	`global_rules.md` + `mcp_config.json`
Codex	Plugin único (`.codex-plugin.json`) con `hooks.session_start` llamando a `korva-vault hooks session-start`
OpenCode	Validado por JSON Schema, `instructions` como array
Gemini	`contextFiles: ["GEMINI.md"]` para auto-carga + fórmula de scorer explícita

Variables de entorno comunes

Variable	Valores	Propósito
`KORVA_MCP_PROFILE`	`agent` / `readonly` / `admin`	Perfil de permisos de las tools expuestas
`KORVA_OUTPUT_MODE`	`off` / `lite` / `full` / `ultra`	Compresión por defecto para `vault_compress`
`KORVA_SESSION_TOKEN`	auto	Auto-cargado desde `~/.korva/session.token` si no se define

Solución de problemas

Si korva setup <ide> dice “editor not found”, instala el IDE primero o pasa la ruta al binario explícitamente. Si el IDE recoge la config pero las tools nunca se disparan, la causa más común es que el Vault no esté corriendo:

korva vault start
korva doctor

Ver Solución de problemas para más.

Conceptos de Vault — qué es lo que realmente exponen estas integraciones
Referencia de herramientas MCP