onepassword — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для чтения и записи данных из хранилища 1Password через CLI. Агент может достать учётные данные, создать новые записи или сгенерировать ссылку для шаринга.
claude mcp add --env OP_SERVICE_ACCOUNT_TOKEN=<OP_SERVICE_ACCOUNT_TOKEN> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --env SKIP_HEALTH_CHECKS=<SKIP_HEALTH_CHECKS> --env DANGEROUSLY_SKIP_ELICITATIONS=<DANGEROUSLY_SKIP_ELICITATIONS> --env OP_ELICITATION_READ=<OP_ELICITATION_READ> --transport stdio onepassword -- npx -y onepassword-mcp-serverЧто делает onepassword
Сервер работает через CLI 1Password (op) и требует сервисный аккаунт для авторизации. Читает список хранилищ, ищет записи по тегам, достаёт метаданные и полные поля логинов, API-ключей, защищённых заметок. Создаёт новые записи — логины, secure notes, API credentials — и генерирует временные ссылки на существующие элементы.
По умолчанию запрос полей с секретами (onepassword_get_item) требует подтверждения пользователя через elicitation-промпт. Для записей без чувствительных данных есть onepassword_get_item_metadata, который возвращает заголовки, имена полей, теги и название хранилища без запроса доступа. Создание новых записей работает без подтверждения: эти инструменты только добавляют данные, не перезаписывают и не удаляют. Отдельные записи можно внести в белый список через OP_WHITELISTED_ITEMS — по заголовку или ID — и читать их без промпта.
Без CLI op в PATH и токена сервисного аккаунта в OP_SERVICE_ACCOUNT_TOKEN сервер не запустится. Переменная ENABLED_TOOLGROUPS ограничивает набор инструментов: readonly оставляет только чтение, readonly,write включает всё. Сервер откажется стартовать, если не настроен elicitation (HTTP fallback URLs) и не выставлен флаг DANGEROUSLY_SKIP_ELICITATIONS=true.
Какие задачи решает
- Достать пароль или API-ключ из 1Password в процессе работы агента
- Записать новые учётные данные в хранилище без ручного копирования
- Сгенерировать временную ссылку на элемент 1Password для передачи коллеге
- Найти все записи с определённым тегом в хранилище
- Разрешить агенту только чтение хранилища, запретив создание и шаринг
Примеры запросов агенту
- Найди в 1Password логин для staging-окружения API
- Создай в хранилище Private новую запись с паролем для учётной записи [email protected]
- Сгенерируй ссылку на элемент Database Credentials, чтобы я передал её разработчику
Как установить onepassword
Командой платформы
claude mcp add --env OP_SERVICE_ACCOUNT_TOKEN=<OP_SERVICE_ACCOUNT_TOKEN> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --env SKIP_HEALTH_CHECKS=<SKIP_HEALTH_CHECKS> --env DANGEROUSLY_SKIP_ELICITATIONS=<DANGEROUSLY_SKIP_ELICITATIONS> --env OP_ELICITATION_READ=<OP_ELICITATION_READ> --transport stdio onepassword -- npx -y onepassword-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add onepassword --env OP_SERVICE_ACCOUNT_TOKEN=<OP_SERVICE_ACCOUNT_TOKEN> --env ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> --env SKIP_HEALTH_CHECKS=<SKIP_HEALTH_CHECKS> --env DANGEROUSLY_SKIP_ELICITATIONS=<DANGEROUSLY_SKIP_ELICITATIONS> --env OP_ELICITATION_READ=<OP_ELICITATION_READ> -- npx -y onepassword-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"onepassword": {
"command": "npx",
"args": [
"-y",
"onepassword-mcp-server"
],
"env": {
"OP_SERVICE_ACCOUNT_TOKEN": "<OP_SERVICE_ACCOUNT_TOKEN>",
"ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>",
"SKIP_HEALTH_CHECKS": "<SKIP_HEALTH_CHECKS>",
"DANGEROUSLY_SKIP_ELICITATIONS": "<DANGEROUSLY_SKIP_ELICITATIONS>",
"OP_ELICITATION_READ": "<OP_ELICITATION_READ>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"onepassword": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"onepassword-mcp-server"
],
"env": {
"OP_SERVICE_ACCOUNT_TOKEN": "<OP_SERVICE_ACCOUNT_TOKEN>",
"ENABLED_TOOLGROUPS": "<ENABLED_TOOLGROUPS>",
"SKIP_HEALTH_CHECKS": "<SKIP_HEALTH_CHECKS>",
"DANGEROUSLY_SKIP_ELICITATIONS": "<DANGEROUSLY_SKIP_ELICITATIONS>",
"OP_ELICITATION_READ": "<OP_ELICITATION_READ>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e OP_SERVICE_ACCOUNT_TOKEN=<OP_SERVICE_ACCOUNT_TOKEN> -e ENABLED_TOOLGROUPS=<ENABLED_TOOLGROUPS> -e SKIP_HEALTH_CHECKS=<SKIP_HEALTH_CHECKS> -e DANGEROUSLY_SKIP_ELICITATIONS=<DANGEROUSLY_SKIP_ELICITATIONS> -e OP_ELICITATION_READ=<OP_ELICITATION_READ> onepassword npx -y onepassword-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о onepassword
Как установить onepassword в Claude Code?
Выполни claude mcp add onepassword -e OP_SERVICE_ACCOUNT_TOKEN=<OP_SERVICE_ACCOUNT_TOKEN> -- npx -y onepassword-mcp-server, подставив токен сервисного аккаунта 1Password вместо плейсхолдера.
Что делает onepassword?
Даёт агенту доступ к хранилищу 1Password: читает логины, API-ключи и secure notes, создаёт новые записи, генерирует временные ссылки для шаринга. По умолчанию запрашивает подтверждение перед раскрытием секретов.
Что нужно для работы onepassword?
CLI op должен быть установлен и доступен в PATH, а токен сервисного аккаунта 1Password — передан в переменной окружения OP_SERVICE_ACCOUNT_TOKEN. Без них сервер не запустится.
