Instalación

kovra son dos piezas:

kovra — la CLI en Rust y el vault local (esta es la herramienta core).
kovra-mcp — un paquete Python opcional que expone kovra a los agentes de IA vía MCP. Solo hace falta para usar kovra desde Claude Code (u otro cliente MCP).

Instalar la CLI

Descargá kovra para macOS (.dmg), abrilo y arrastrá kovra.app a Aplicaciones. En el primer arranque, click derecho → Abrir (el build aún no está notarizado, así que Gatekeeper pregunta una vez). La app crea su propio vault en el primer uso — sin pasos extra. La CLI kovra viene dentro de la app.

Windows está en Beta. Descargá el instalador de kovra (.msi) y ejecutalo. El instalador aún no está firmado, así que Windows SmartScreen puede advertir una vez — elegí Más información → Ejecutar de todas formas. Instala la CLI kovra y la deja en tu PATH.

El servidor MCP ya está disponible en PyPI.

Instalar el servidor MCP (opcional)

El servidor MCP permite que un agente de IA vea metadata con scope y ejecute comandos a través del wrapper de kovra, sin recibir nunca el texto plano de tus secretos sensibles. Se publica como el paquete Python kovra-mcp y provee el comando kovra-mcp.

pip install kovra-mcp
# o, aislado en tu PATH:
pipx install kovra-mcp     # o: uv tool install kovra-mcp

Normalmente no corrés kovra-mcp a mano — es un servidor stdio de MCP que lanza tu agente. kovra setup lo registra para tu proyecto. Solo confirmá que está en tu PATH:

macOS
Windows

~ % which kovra-mcp
/Users/you/.local/bin/kovra-mcp

PS> where.exe kovra-mcp
C:\Users\you\AppData\Local\Programs\Python\Python312\Scripts\kovra-mcp.exe

Andá al Quick start para inicializar tu vault, guardar tu primer secreto e inyectarlo en un proceso.

Instalación

Instalar la CLI

Instalar el servidor MCP (opcional)

Siguiente