Conectar Claude y otros agentes de IA

Qué necesitas

• PassSumo instalado en /Applications, en macOS 27 o posterior.
• Una base de datos. El acceso de agentes se configura por base de datos.
• Un cliente MCP: Claude Code, Cursor, Codex, Claude Desktop o cualquier cliente que pueda iniciar un servidor local por stdio.

Paso 1. Activa el acceso de agentes para una base de datos

1. Abre y desbloquea la base de datos en PassSumo.
2. Abre los ajustes (Cmd+,) y ve a Acceso de agentes (Agent access).
3. Activa Permitir acceso de lectura a agentes de IA (Allow AI agent read access). Está desactivado hasta que lo hagas.
4. En Carpetas permitidas, marca las carpetas que el agente puede ver. Una entrada fuera de ellas se devuelve como not_found, como si no existiera.
5. Elige una Duración del permiso. Un permiso siempre termina solo pasado ese tiempo.

Una base de datos que nunca tuvo el acceso de agentes activado debe desbloquearse una vez en PassSumo, con el ajuste activado, antes de que un agente pueda pedirla.

Si usas la interfaz en español, los nombres pueden diferir de los citados; entre paréntesis van los originales en inglés.

Paso 2. Instala psumo con un enlace simbólico

El programa psumo está dentro de la app, en /Applications/PassSumo.app/Contents/MacOS/psumo. Apunta tus herramientas a un enlace simbólico a él, no al paquete de la app, para que la configuración sobreviva a cambios de ubicación y actualizaciones. Ejecuta:

mkdir -p ~/.local/bin && ln -sf /Applications/PassSumo.app/Contents/MacOS/psumo ~/.local/bin/psumo

En Ajustes → Acceso de agentes aparece la misma línea con tus rutas reales y un botón Copiar comando de instalación.

No copies el archivo. PassSumo comprueba la firma de código del programa que se conecta, y un psumo copiado no la supera (unverified_peer). Un enlace simbólico apunta al binario real y funciona.

Comprueba que responde (PassSumo debe estar en ejecución):

~/.local/bin/psumo ping

Imprime pong.

Paso 3. Añade PassSumo a tu cliente

Claude Code

Registra el servidor una vez:

claude mcp add psumo -- ~/.local/bin/psumo mcp

El intérprete de comandos expande ~ antes de que Claude Code guarde el comando. En Ajustes → Acceso de agentes también hay un botón Copiar comando MCP con tu ruta real.

Claude Desktop

Añade un servidor al archivo de configuración de Claude Desktop (claude_desktop_config.json), con la ruta absoluta del enlace simbólico y mcp como único argumento:

{
  "mcpServers": {
    "psumo": {
      "command": "/Users/YOUR-NAME/.local/bin/psumo",
      "args": ["mcp"]
    }
  }
}

Sustituye YOUR-NAME por tu nombre de usuario de macOS y reinicia Claude Desktop.

Cualquier otro cliente MCP

PassSumo habla MCP por stdio, un mensaje JSON por línea, y no imprime nada más en la salida estándar. Configura tu cliente para que inicie este comando:

/Users/YOUR-NAME/.local/bin/psumo mcp

No hacen falta variables de entorno ni opciones adicionales; mcp no admite argumentos.

Paso 4. Aprueba la primera solicitud

Pide una contraseña a tu agente. PassSumo muestra una solicitud de aprobación con el nombre de la base de datos y el motivo (reason) que dio el agente; toda llamada debe llevar uno. Pulsa Permitir… y confirma con Touch ID o la contraseña de tu Mac.

Si PassSumo no está en ejecución, psumo lo inicia en segundo plano. No hace falta añadir un tiempo límite por parte del agente: PassSumo termina por sí mismo una solicitud sin respuesta.

Paso 5. Pruébalo desde Terminal

Puedes probar todo el recorrido sin un agente. Busca una entrada (solo metadatos, sin secretos):

~/.local/bin/psumo find Test

Sustituye Test por parte del título de una entrada. El primer valor de cada línea es el id de la entrada. Luego revela un campo:

~/.local/bin/psumo reveal <id> --field password

Un campo se imprime tal cual; varios campos se imprimen como JSON.

Qué puede y qué no puede hacer el agente

• Cuatro herramientas: list_databases, list_groups, find_entries y reveal_entry. Cada llamada necesita un reason, que ves al aprobar.
• Buscar devuelve solo metadatos. find_entries da títulos e ids, nunca valores secretos.
• Revelar devuelve el secreto. reveal_entry devuelve los campos que se nombran: username, password, totp, url, notes o custom:<nombre>. Los valores se devuelven al agente.
• Lectura por defecto. En cada aprobación, en el Mac, la persona elige Read o Read and write. Escribir solo significa añadir una entrada nueva en una carpeta permitida (add_entry). Ninguna herramienta cambia, mueve ni borra una entrada existente.
• Solo carpetas permitidas. Todo lo demás es invisible para el agente.

Duración y revocación del acceso

• Un permiso dura el tiempo que elegiste, las solicitudes posteriores no lo amplían, y también termina cuando PassSumo se cierra. Un bloqueo normal no lo termina; usa el comando de menú indicado abajo.
• En Ajustes → Acceso de agentes, Revocar termina el permiso actual, Terminar sesión termina uno de los listados y Revocar todos termina todos.
• El comando Bloquear y revocar el acceso del agente del menú Archivo bloquea la base de datos y termina su permiso en un solo paso.
• Desactivar Permitir acceso de lectura a agentes de IA detiene las nuevas solicitudes para esa base de datos.

Solución de problemas

• app_not_running o db_not_open — PassSumo no está en ejecución o la base de datos no está abierta. Ábrela con

  open -a PassSumo "<ruta al archivo .psum>"

  y reintenta. Los agentes deben usar la ruta que se les da y nunca buscar bases de datos en el disco.
• disabled — el acceso de agentes está desactivado para esa base de datos. Actívalo en Ajustes → Acceso de agentes.
• not_found — la entrada está fuera de las carpetas permitidas o el id es incorrecto.
• denied — la solicitud fue rechazada.
• timeout — nadie respondió a tiempo. Vuelve a pedirlo.
• unverified_peer — psumo es una copia, no un enlace simbólico a la app. Vuelve a ejecutar el comando de instalación del paso 2.
• El enlace apunta a una ubicación antigua tras mover la app — ejecuta de nuevo el comando de instalación para reapuntarlo.

¿Sigues atascado? El formulario de comentarios llega a la persona que escribe el código. Las preguntas habituales están en las preguntas frecuentes.