Cómo conectar 1Password Connect a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → 1Password Connect, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

1Password Connect + Gemini

Bóvedas y elementos de 1Password a través de tu servidor 1Password Connect autoalojado: listar bóvedas y elementos, leer elementos con sus valores secretos y archivos adjuntos, crear elementos con contraseñas generadas, modificarlos con JSON Patch y leer el registro de peticiones del servidor. Borrar está desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ONEPASSWORD_CONNECT_URL, ONEPASSWORD_CONNECT_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 15 minutos y necesita un servidor 1Password Connect desplegado, la REST API autoalojada que 1Password ejecuta en tu propia infraestructura para Secrets Automation.

1. En 1Password.com abre Developer, Directory, selecciona Other en Infrastructure Secrets Management y Create a Connect server (o ejecuta op connect server create <name> --vaults <vault>). Guarda el archivo 1password-credentials.json y el primer access token en 1Password. Connect solo llega a las bóvedas compartidas que se le conceden, nunca a bóvedas personales o privadas.
2. Despliega el servidor: los contenedores connect-api y connect-sync de https://github.com/1Password/connect, con Docker Compose, Kubernetes o el chart de Helm. Por defecto escucha en el puerto 8080.
3. Usa el primer token o emite uno solo para la IA: Developer, Connect servers, elige el servidor, New Token (o op connect token create <name> --server <server> --vault <vault>). Concede solo las bóvedas que la IA debe ver. Las bóvedas de un token no se pueden cambiar después; revócalo y emite uno nuevo. Se puede fijar una caducidad de 30, 90 o 180 días.
4. Pon en ONEPASSWORD_CONNECT_URL la dirección del servidor tal como la alcanza AnythingMCP, sin /v1 y sin barra final (por ejemplo https://op-connect.example.com o http://10.0.0.5:8080), y pega el token (un JWT que empieza por eyJ, sin Bearer) en ONEPASSWORD_CONNECT_TOKEN.
5. Instala el conector y ejecuta onepassword_connect_list_vaults: confirma el token y lista las bóvedas a las que llega.

Dónde corre el servidor Connect: en AnythingMCP Cloud el servidor Connect necesita una dirección HTTPS pública. Un AnythingMCP autoalojado solo llega a un servidor en una red o IP privada cuando ese host está permitido en SSRF_ALLOWED_HOSTS, porque la protección de salida bloquea por defecto los rangos de direcciones privadas.

La IA ve valores secretos. Estas herramientas devuelven secretos en texto plano:

• onepassword_connect_get_item: las contraseñas, claves de API, semillas TOTP, notas y demás campos ocultos del elemento, en fields[].value.
• onepassword_connect_get_file_content: el contenido de un archivo adjunto (certificados, archivos de claves, documentos), hasta 4 MB.
• onepassword_connect_create_item y onepassword_connect_update_item: responden con el elemento completo, incluidos los valores secretos y cualquier contraseña generada.

Estos valores llegan al modelo de IA y al chat. Las herramientas de lista (onepassword_connect_list_vaults, onepassword_connect_list_items, onepassword_connect_list_files), onepassword_connect_get_vault y onepassword_connect_get_file devuelven solo metadatos. Concede al token solo las bóvedas que la IA debe ver, y pide a un administrador del espacio de trabajo que desactive onepassword_connect_get_item y onepassword_connect_get_file_content si la IA debe trabajar solo con nombres. La IA no repite un secreto en una respuesta salvo que lo pidas.

Encontrar un secreto: onepassword_connect_list_vaults (filtro como name eq "Production"), luego onepassword_connect_list_items con título, categoría, etiquetas, URL, versión y fechas (filtro title eq "Stripe API" o tag eq "prod"), y luego onepassword_connect_get_item solo cuando hace falta el valor mismo. Archivos: onepassword_connect_list_files u onepassword_connect_get_file para nombres y tamaños, onepassword_connect_get_file_content para descargar uno.

Qué escribe: onepassword_connect_create_item con categoría, título y campos; un campo con generate: true y un recipe recibe de 1Password un valor aleatorio. onepassword_connect_update_item cambia parte de un elemento con JSON Patch (RFC 6902: add, remove, replace) en /title, /favorite, /tags, /urls, /fields (para añadir un campo), /fields/<field id> o /fields/<field id>/value; la ruta / sustituye el elemento entero. La IA lee antes los id de los campos con onepassword_connect_get_item. 1Password conserva la versión anterior en el historial del elemento.

Comprobaciones del servidor: onepassword_connect_list_activity lista las peticiones que atendió el servidor, de la más reciente a la más antigua: READ, CREATE, UPDATE o DELETE con SUCCESS o DENY, por token y elemento. onepassword_connect_get_health muestra si el servidor, su servicio de sincronización y la conexión con la cuenta están sanos, y así distingue un problema del servidor de uno del token.

Desactivadas al instalar: onepassword_connect_delete_item. No se puede deshacer, y las aplicaciones que leen el secreto a través de Connect dejan de encontrarlo al instante, así que un administrador del espacio de trabajo la activa cuando el equipo la necesita.

Formatos de datos: los id de bóvedas y elementos son 26 letras minúsculas y dígitos. Un campo tiene id, label, type (STRING, CONCEALED, EMAIL, URL, TOTP, DATE, MONTH_YEAR, MENU), purpose (USERNAME, PASSWORD, NOTES), value y section; los campos de contraseña llevan además entropy. Las fechas son ISO 8601.

Paginación: las listas devuelven toda la colección en una respuesta. Solo onepassword_connect_list_activity pagina, con limit (50 por defecto) y offset, e indica el total en la cabecera content-range (1-50/1134).

Errores comunes: 401 significa un token incorrecto o revocado, o emitido para otro servidor Connect. 403 vault ... is not in scope significa que al token no se le concedió esa bóveda o que no puede escribir en ella. 404 significa que la bóveda, el elemento o el archivo no existen; 404 en cada llamada significa que ONEPASSWORD_CONNECT_URL no es la dirección de la Connect API. 400 en una escritura indica el campo o la categoría no válidos. 413 significa que un archivo es demasiado grande para devolverlo. Los errores de conexión suelen significar que AnythingMCP no alcanza ONEPASSWORD_CONNECT_URL; onepassword_connect_get_health y los logs del servidor dan más detalle.

El conector no llega a bóvedas personales o privadas ni a bóvedas no concedidas al token, no borra elementos con las herramientas activas al instalar, no crea servidores ni tokens de Connect y no lee los eventos de inicio de sesión y auditoría de la cuenta (para eso está el conector 1Password Events).

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de 1Password Connect.

Herramientas disponibles

Ejemplos de prompts

• "¿A qué bóvedas llega la IA, y cuántos elementos hay en cada una?"
• "Busca el elemento Stripe API en la bóveda Production y dime cuándo se modificó por última vez, sin mostrar la clave."
• "Crea en la bóveda DevOps un elemento Login para la base de datos de staging, con usuario app y una contraseña generada."
• "Añade la etiqueta rotated al elemento Mail relay de la bóveda Infrastructure."
• "¿Qué tokens leyeron elementos a través de Connect hoy, y se denegó alguna petición?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot