1Password MCP

oficial

El servidor MCP de 1Password crea un puente que permite a clientes MCP como Codex y Kiro gestionar tus Entornos de 1Password con indicaciones de autorización seguras.

Ver en 1password.dev

¿Qué puedes hacer con 1Password MCP?

  • Listar entornos — Pídele a tu asistente que liste todos los Entornos de 1Password en tu cuenta mediante list_environments.
  • Crear o renombrar entornos — Indica a tu asistente que cree un nuevo Entorno o renombre uno existente usando create_environment o rename_environment.
  • Gestionar variables — Haz que tu asistente agregue o actualice variables en un Entorno, o liste los nombres de las variables, mediante append_variables o list_variables.
  • Montar archivos .env locales — Pídele a tu asistente que cree un archivo .env montado localmente para acceso bajo demanda a secretos, o que liste los montajes existentes, usando create_local_env_file o list_local_env_files.

Documentación

Servidor MCP de Entornos de 1Password

Conecta clientes MCP a Entornos de 1Password con avisos de autorización seguros, sin devolver secretos al agente.

El Servidor MCP de Entornos de 1Password permite que clientes MCP como Claude Code , Codex , Cursor y Kiro gestionen de forma segura tus Entornos de 1Password. El servidor solo puede ver los nombres de variables y Entornos, y nunca devuelve los secretos almacenados en tus Entornos, que permanecen seguros en 1Password.

Puedes usar el servidor MCP para:

  • Crear, listar y renombrar Entornos.
  • Listar los nombres de las variables almacenadas en un Entorno.
  • Añadir variables a un Entorno.
  • Crear archivos .env montados localmente que hacen que tus secretos estén disponibles bajo demanda sin escribirlos en el disco.
  • Listar archivos .env montados localmente.

Más información sobre el enfoque de 1Password para servidores MCP.

Cómo funciona el Servidor MCP de Entornos de 1Password

El Servidor MCP de Entornos de 1Password se ejecuta localmente en tu computadora como parte de la aplicación de escritorio de 1Password. Cuando tu cliente MCP se conecta al servidor o usa una herramienta que requiere aprobación por Entorno, la aplicación de 1Password muestra un aviso de autorización seguro. Si apruebas, el cliente puede usar la herramienta aprobada con el Entorno nuevamente sin que se te pregunte hasta que 1Password se bloquee.

Por diseño, el servidor no puede devolver valores secretos almacenados en 1Password al cliente, incluso si un agente los solicita.

Este tutorial muestra cómo usar el servidor MCP para Codex:

Requisitos

Antes de poder usar el servidor MCP, necesitarás:

Nota

Los administradores de 1Password Enterprise Password Manager pueden activar y desactivar la función del servidor MCP. Para hacerlo, inicia sesión en tu cuenta en 1Password.com, luego ve a Políticas > Permisos de agentes y activa o desactiva la opción Servidor MCP local según sea necesario.

Paso 1: Activa el acceso al servidor MCP

En 1Password, ve a Configuración > Desarrollador y selecciona Integrar con clientes MCP.

Paso 2: Configura tu cliente MCP

A continuación, deberás configurar 1Password como un servidor MCP local dentro de tu cliente MCP.

Para configurar el servidor MCP de 1Password, instala el [plugin de 1Password para Claude Code](/environments/claude-plugin). El plugin registra la configuración MCP por ti, junto con un hook local de validación de archivos `.env` y una habilidad de agente que le da a Claude Code un flujo de trabajo completo de configuración de Entornos.

1. Abre tu terminal, ve al directorio de tu proyecto y luego ingresa `claude` para iniciar una sesión de Claude Code.

2. Añade el marketplace de 1Password:

   ```shell theme={null}
   /plugin marketplace add 1Password/1password-claude-plugin
   ```

3. Instala el plugin:

   ```shell theme={null}
   /plugin install 1password@1password
   ```

4. Reinicia Claude Code y luego ingresa `/mcp` para confirmar que el servidor de 1Password está conectado.

Más información sobre [el plugin de 1Password para Claude Code](/environments/claude-plugin).
> **Nota** > > Codex actualmente es compatible con Mac y Linux. 
Para configurar el Servidor MCP de Entornos de 1Password para Codex:

1. En Codex, ve a **Servidores MCP** y selecciona **+ Añadir servidor**. Asegúrate de que el interruptor esté activado.
2. En el campo **Comando para iniciar**, ingresa:

```
1password-mcp
```

A continuación, actualiza tu archivo `AGENTS.md` para indicar a Codex que use explícitamente el servidor MCP sin necesidad de preguntar.

Para hacer esto, ve a **Personalización** y completa el campo **Instrucciones personalizadas**. Por ejemplo, añade la instrucción:

"Usa siempre el Servidor MCP de Entornos de 1Password si necesitas trabajar con los entornos de desarrollador de 1Password sin que yo tenga que pedírtelo explícitamente."

Para configurar el Servidor MCP de Entornos de 1Password, instala el [plugin de 1Password para Cursor](/environments/cursor-plugin). El plugin registra la configuración MCP por ti, junto con un hook local de validación de archivos `.env` y una habilidad de agente que le da a Cursor Agent un flujo de trabajo completo de configuración de Entornos.

1. Abre Cursor y navega a la ventana de **Agentes de Cursor**.
2. En la barra lateral izquierda, selecciona **Personalizar**.
3. Selecciona **Plugins** en el menú superior.
4. Busca **1Password** y luego selecciona **Añadir**.
5. Reinicia Cursor y luego ve a **Configuración** > **Herramientas y MCP** para confirmar que el servidor de 1Password está conectado.

Más información sobre [el plugin de 1Password para Cursor](/environments/cursor-plugin).
> **Nota** > > Esta función está en versión beta. El plugin de Kiro actualmente es compatible con Mac y Linux. 
Para configurar el [Servidor MCP de Entornos de 1Password para Kiro](https://github.com/1Password/1password-kiro-plugin), puedes instalar el plugin desde el Kiro Power Marketplace o desde GitHub.

#### Opción 1: Instalar desde el Kiro Power Marketplace

1. Busca "1Password Developer Environments" en [kiro.dev/powers](https://kiro.dev/powers).
2. Selecciona **Añadir a Kiro** para abrir la página de instalación en Kiro.
3. Selecciona **+Instalar** para instalar el Power.
4. Selecciona **Probar power** para validar tu Entorno y comenzar.

#### Opción 2: Instalar desde GitHub

1. Selecciona **Powers** en la Barra de actividades, o abre la Paleta de comandos y busca **Powers: Enfocar en vista instalada**.
2. Selecciona **Añadir Power personalizado**.
3. Selecciona **Importar Power desde GitHub** en las opciones del menú.
4. Pega la URL del repositorio: `https://github.com/1Password/1password-kiro-plugin`
5. Selecciona `1password-kiro-plugin` de la lista de Powers instalados.
6. Desde la pantalla `Power: 1Password Developer Environments`, selecciona **Probar power** para validar tu Entorno y comenzar.
Para configurar manualmente el Servidor MCP de Entornos de 1Password con cualquier cliente MCP que admita transporte `stdio`, añade el comando `1password-mcp` al archivo de configuración de tu cliente MCP. 
Si tu cliente usa un archivo de configuración MCP JSON:

```json theme={null}
{
  "mcpServers": {
    "1password": {
      "command": "1password-mcp"
    }
  }
}
```

Si tu cliente usa un archivo de configuración TOML:

```toml theme={null}
[mcp_servers.1password]
command = "1password-mcp"
```

Luego reinicia tu cliente.

Paso 3: Pide a tu cliente que gestione un Entorno

Después de conectar el servidor MCP, puedes pedir a tu cliente que realice tareas como:

  • "Lista mis Entornos de 1Password"
  • "Crea un montaje .env local aquí"
  • "Muéstrame los nombres de variables en mi entorno de proyecto"
  • "Añade una variable para mi clave API de OpenAI"
  • "Crea un nuevo Entorno llamado mi-proyecto"

Advertencia

Asegúrate de rotar cualquier secreto que importes a 1Password y que anteriormente estuviera almacenado en texto plano en tu código o archivos .env. Mover los secretos de tu proyecto a 1Password los asegura de ahora en adelante, pero no mitiga exposiciones pasadas, como en tu historial de Git o en la memoria de tu agente de codificación.

Herramientas disponibles

Las siguientes herramientas están expuestas a los clientes MCP. La primera vez que un cliente llama a una herramienta para interactuar con un Entorno específico, 1Password puede pedirte que lo apruebes.

HerramientaDescripción
append_variablesAñade o actualiza variables de entorno en un Entorno de 1Password. Asegúrate de rotar cualquier secreto que anteriormente estuviera almacenado en texto plano en tu código o archivos .env.
authenticateAutentícate con la aplicación de escritorio de 1Password para acceder a las herramientas de Entornos de 1Password.
create_environmentCrea un nuevo Entorno de 1Password en una cuenta especificada. Asegúrate de rotar cualquier secreto que anteriormente estuviera almacenado en texto plano en tu código o archivos .env.
rename_environmentRenombra un Entorno de 1Password en una cuenta especificada.
create_local_env_fileCrea un archivo .env montado localmente para un Entorno de 1Password que hace que tus secretos estén disponibles bajo demanda sin escribirlos en el disco.
list_environmentsSolo lectura. Lista todos los Entornos de 1Password en una cuenta especificada.
list_variablesSolo lectura. Recupera una lista de nombres de variables de entorno almacenadas en un Entorno de 1Password.
list_local_env_filesSolo lectura. Lista todos los archivos .env montados localmente desde un Entorno de 1Password. Los archivos .env locales actualmente solo son compatibles con Mac y Linux.

Más información

Temas relacionados