Подключение Claude и других ИИ-агентов

Что понадобится

• PassSumo в папке /Applications на macOS 27 или новее.
• База данных. Доступ агентов настраивается для каждой базы отдельно.
• MCP-клиент: Claude Code, Cursor, Codex, Claude Desktop или любой клиент, умеющий запускать локальный stdio-сервер.

Шаг 1. Включите доступ агентов для базы

1. Откройте базу в PassSumo и разблокируйте её.
2. Откройте настройки (Cmd+,) и перейдите в раздел Доступ агентов (Agent access).
3. Включите Разрешить ИИ-агентам чтение (Allow AI agent read access). Пока вы этого не сделали, доступ выключен.
4. В списке Разрешённые папки отметьте папки, которые агент может видеть. Запись вне них возвращается как not_found, словно её не существует.
5. Выберите Срок разрешения. Разрешение всегда заканчивается само по истечении этого времени.

База, для которой доступ агентов никогда не включали, должна быть один раз разблокирована в PassSumo при включённой настройке — только после этого агент сможет её запросить.

В русскоязычном интерфейсе названия элементов могут отличаться от приведённых; в скобках — английские оригиналы.

Шаг 2. Установите psumo через символическую ссылку

Программа psumo лежит внутри приложения: /Applications/PassSumo.app/Contents/MacOS/psumo. Направляйте инструменты на символическую ссылку на неё, а не на сам пакет приложения: так настройка переживёт перемещение и обновление приложения. Выполните:

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

В разделе «Доступ агентов» настроек показана та же строка с вашими настоящими путями и кнопка Скопировать команду установки.

Не копируйте файл. PassSumo проверяет подпись кода программы, которая к нему подключается, и скопированный psumo эту проверку не проходит (unverified_peer). Символическая ссылка ведёт к настоящему файлу и работает.

Проверьте, что он отвечает (PassSumo должен быть запущен):

~/.local/bin/psumo ping

Команда выведет pong.

Шаг 3. Добавьте PassSumo в клиент

Claude Code

Зарегистрируйте сервер один раз:

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

Оболочка раскрывает ~ до того, как Claude Code сохранит команду. В настройках («Доступ агентов») есть и кнопка Скопировать команду MCP с вашим настоящим путём.

Claude Desktop

Добавьте сервер в файл конфигурации Claude Desktop (claude_desktop_config.json), указав абсолютный путь к символической ссылке и единственный аргумент mcp:

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

Замените YOUR-NAME на имя вашего пользователя macOS и перезапустите Claude Desktop.

Любой другой MCP-клиент

PassSumo говорит по MCP через stdio, по одному JSON-сообщению в строке, и ничего другого не выводит в стандартный вывод. Настройте клиент так, чтобы он запускал эту команду:

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

Переменные окружения и дополнительные флаги не нужны; mcp не принимает аргументов.

Шаг 4. Подтвердите первый запрос

Попросите агента достать пароль. PassSumo покажет запрос на подтверждение: в нём указаны база и причина (reason), которую назвал агент; она обязательна в каждом вызове. Нажмите Разрешить… и подтвердите Touch ID или паролем Mac.

Если PassSumo не запущен, psumo запустит его в фоне. Таймаут на стороне агента добавлять не нужно: PassSumo сам завершает запрос, на который никто не ответил.

Шаг 5. Проверьте из Терминала

Весь путь можно проверить и без агента. Найдите запись (только метаданные, без секретов):

~/.local/bin/psumo find Test

Замените Test частью названия вашей записи. Первое значение в каждой строке — идентификатор записи. Затем получите одно поле:

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

Одно поле выводится как есть; несколько полей — в виде JSON.

Что агент может и чего не может

• Четыре инструмента: list_databases, list_groups, find_entries и reveal_entry. Каждому вызову нужна reason — причину вы видите при подтверждении.
• Поиск возвращает только метаданные. find_entries отдаёт названия и идентификаторы, но не секреты.
• Раскрытие возвращает секрет. reveal_entry возвращает названные поля: username, password, totp, url, notes или custom:<имя>. Значения возвращаются агенту.
• По умолчанию чтение. При каждом подтверждении, на Mac, человек выбирает Read или Read and write. Запись означает только добавление новой записи в разрешённой папке (add_entry). Инструмента, который изменяет, перемещает или удаляет существующую запись, нет.
• Только разрешённые папки. Всё остальное для агента невидимо.

Срок действия и отзыв доступа

• Разрешение действует выбранный вами срок, последующие запросы его не продлевают, и оно заканчивается также при выходе из PassSumo. Простая блокировка базы разрешение не завершает — для этого используйте команду меню ниже.
• В настройках («Доступ агентов») Отозвать завершает текущее разрешение, Завершить сеанс — одно из перечисленных, Отозвать все — все разрешения.
• Команда меню «Файл» Заблокировать и отозвать доступ агента блокирует базу и завершает её разрешение за один шаг.
• Если выключить Разрешить ИИ-агентам чтение, новые запросы к этой базе прекратятся.

Если что-то не работает

• app_not_running или db_not_open — PassSumo не запущен или база не открыта. Откройте её командой

  open -a PassSumo "<путь к файлу .psum>"

  и повторите запрос. Агенты должны использовать выданный им путь и никогда не искать базы на диске.
• disabled — доступ агентов для этой базы выключен. Включите его в настройках, в разделе «Доступ агентов».
• not_found — запись вне разрешённых папок или неверный идентификатор.
• denied — запрос отклонён.
• timeout — никто не ответил вовремя. Повторите запрос.
• unverified_peer — psumo скопирован, а не является ссылкой на файл в приложении. Выполните команду установки из шага 2 заново.
• Ссылка указывает на старое место после переноса приложения — выполните команду установки ещё раз, чтобы перенаправить её.

Не получилось? Форма обратной связи доходит до человека, который пишет код. Частые вопросы — в разделе «Вопросы и ответы».