1Password MCP

официальный

Сервер 1Password MCP создает мост, который позволяет MCP-клиентам, таким как Codex и Kiro, управлять вашими средами 1Password с помощью защищенных запросов авторизации.

Смотреть на 1password.dev

Что можно делать с 1Password MCP?

Список окружений — Попросите вашего ассистента вывести список всех окружений 1Password в вашей учетной записи через list_environments.
Просмотр имен переменных — Получите имена переменных, хранящихся в окружении, не раскрывая секретные значения, с помощью list_variables.
Добавление или обновление переменных — Добавляйте или изменяйте переменные окружения в окружении 1Password с помощью append_variables.
Создание и переименование окружений — Настраивайте новые окружения или переименовывайте существующие с помощью create_environment и rename_environment.
Монтирование локальных файлов .env — Создавайте локально смонтированные файлы .env, которые обеспечивают доступ к секретам по запросу без записи на диск, через create_local_env_file.

Документация

1Password Environments MCP Server

Подключайте MCP-клиенты к 1Password Environments с безопасными запросами авторизации, не возвращая секреты агенту.

Сервер 1Password Environments MCP Server позволяет MCP-клиентам, таким как Claude Code , Codex , Cursor и Kiro , безопасно управлять вашими 1Password Environments. Сервер видит только имена переменных и Environments и никогда не возвращает секреты, хранящиеся в ваших Environments, которые остаются в безопасности в 1Password.

Вы можете использовать MCP-сервер для:

Создания, перечисления и переименования Environments.
Просмотра имен переменных, хранящихся в Environment.
Добавления переменных в Environment.
Создания локально смонтированных .env файлов, которые делают ваши секреты доступными по запросу без записи на диск.
Просмотра списка локально смонтированных .env файлов.

Узнайте больше о подходе 1Password к MCP-серверам.

Как работает 1Password Environments MCP Server

Сервер 1Password Environments MCP Server запускается локально на вашем компьютере как часть настольного приложения 1Password. Когда ваш MCP-клиент подключается к серверу или использует инструмент, требующий одобрения для каждого Environment, приложение 1Password показывает безопасный запрос авторизации. Если вы одобрите, клиент сможет использовать одобренный инструмент с Environment снова без запроса, пока 1Password не заблокируется.

По замыслу сервер не может возвращать значения секретов, хранящихся в 1Password, клиенту, даже если агент запрашивает их.

Это пошаговое руководство показывает, как использовать MCP-сервер для Codex:

Требования

Прежде чем использовать MCP-сервер, вам потребуется:

Зарегистрироваться в 1Password.
Установить настольное приложение 1Password.
Создать 1Password Environment.
Иметь MCP-клиент, поддерживающий транспорт stdio. Удаленные MCP-клиенты в настоящее время не поддерживаются.

Примечание

Администраторы 1Password Enterprise Password Manager могут включать и отключать функцию MCP-сервера. Для этого войдите в свою учетную запись на 1Password.com, затем перейдите в Политики > Разрешения агентов и включите или отключите параметр Локальный MCP-сервер по мере необходимости.

Шаг 1: Включите доступ к MCP-серверу

Чтобы включить MCP-сервер:

В 1Password перейдите в Настройки > Лаборатория, затем выберите MCP Server.
Включите переключатель Включить локальный MCP-сервер.
Перейдите в Настройки > Разработчик и выберите Интеграция с MCP-клиентами.

Шаг 2: Настройте ваш MCP-клиент

Затем вам нужно настроить 1Password как локальный MCP-сервер в вашем MCP-клиенте.

Чтобы настроить 1Password MCP-сервер, установите [плагин 1Password для Claude Code](/environments/claude-plugin). Плагин регистрирует конфигурацию MCP за вас, а также локальный хук проверки `.env` файлов и навык агента, который дает Claude Code полный рабочий процесс настройки Environments.

1. Откройте терминал, перейдите в каталог вашего проекта, затем введите `claude`, чтобы начать сеанс Claude Code.

2. Добавьте маркетплейс 1Password:

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

3. Установите плагин:

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

4. Перезапустите Claude Code, затем введите `/mcp`, чтобы подтвердить, что сервер 1Password подключен.

Узнайте больше о [плагине 1Password для Claude Code](/environments/claude-plugin).

> **Примечание** > > Codex в настоящее время поддерживает Mac и Linux.

Чтобы настроить 1Password Environments MCP Server для Codex:

1. В Codex перейдите в **MCP-серверы** и выберите **+ Добавить сервер**. Убедитесь, что переключатель включен.
2. В поле **Команда для запуска** введите:

```
1password-mcp
```

Затем обновите файл `AGENTS.md`, чтобы указать Codex явно использовать MCP-сервер без необходимости спрашивать.

Для этого перейдите в **Персонализация** и заполните поле **Пользовательские инструкции**. Например, добавьте инструкцию:

«Всегда используйте 1Password Environments MCP Server, если вам нужно работать с средами разработчика 1Password, без необходимости явно спрашивать меня».

Чтобы настроить 1Password Environments MCP Server, установите [плагин 1Password для Cursor](/environments/cursor-plugin). Плагин регистрирует конфигурацию MCP за вас, а также локальный хук проверки `.env` файлов и навык агента, который дает Cursor Agent полный рабочий процесс настройки Environments.

1. Откройте Cursor и перейдите в окно **Cursor Agents**.
2. На левой боковой панели выберите **Настроить**.
3. Выберите **Плагины** в верхнем меню.
4. Найдите **1Password**, затем выберите **Добавить**.
5. Перезапустите Cursor, затем перейдите в **Настройки** > **Инструменты и MCP**, чтобы подтвердить, что сервер 1Password подключен.

Узнайте больше о [плагине 1Password для Cursor](/environments/cursor-plugin).

> **Примечание** > > Эта функция находится в бета-версии. Плагин Kiro в настоящее время поддерживает Mac и Linux.

Чтобы настроить [1Password Environments MCP Server для Kiro](https://github.com/1Password/1password-kiro-plugin), вы можете установить плагин из Kiro Power Marketplace или из GitHub.

#### Вариант 1: Установка из Kiro Power Marketplace

1. Найдите «1Password Developer Environments» на [kiro.dev/powers](https://kiro.dev/powers).
2. Выберите **Добавить в Kiro**, чтобы открыть страницу установки в Kiro.
3. Выберите **+Установить**, чтобы установить Power.
4. Выберите **Попробовать power**, чтобы проверить ваш Environment и начать работу.

#### Вариант 2: Установка из GitHub

1. Выберите **Powers** на панели действий или откройте палитру команд и найдите **Powers: Focus on Installed view**.
2. Выберите **Добавить пользовательский Power**.
3. Выберите **Импортировать Power из GitHub** в параметрах меню.
4. Вставьте URL-адрес репозитория: `https://github.com/1Password/1password-kiro-plugin`
5. Выберите `1password-kiro-plugin` из списка установленных Powers.
6. На экране `Power: 1Password Developer Environments` выберите **Попробовать power**, чтобы проверить ваш Environment и начать работу.

Чтобы вручную настроить 1Password Environments MCP Server с любым MCP-клиентом, поддерживающим транспорт `stdio`, добавьте команду `1password-mcp` в файл конфигурации вашего MCP-клиента.

Если ваш клиент использует файл конфигурации MCP в формате JSON:

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

Если ваш клиент использует файл конфигурации TOML:

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

Затем перезапустите клиент.

Шаг 3: Попросите клиента управлять Environment

После подключения MCP-сервера вы можете попросить клиента выполнять такие задачи, как:

«Перечислить мои 1Password Environments»
«Создать локальный .env mount здесь»
«Показать имена переменных в моем project environment»
«Добавить переменную для моего ключа API OpenAI»
«Создать новый Environment с именем my-project»

Предупреждение

Обязательно ротируйте любые секреты, которые вы импортируете в 1Password и которые ранее хранились в открытом виде в вашей кодовой базе или .env файлах. Перенос секретов проекта в 1Password защищает их в будущем, но не устраняет прошлые утечки, например, в истории Git или памяти вашего агента кодирования.

Доступные инструменты

Следующие инструменты доступны MCP-клиентам. При первом вызове клиентом инструмента для взаимодействия с конкретным Environment 1Password может запросить ваше одобрение.

Инструмент	Описание
`append_variables`	Добавить или обновить переменные окружения в 1Password Environment. Обязательно ротируйте любые секреты, которые ранее хранились в открытом виде в вашей кодовой базе или .env файлах.
`authenticate`	Аутентификация с настольным приложением 1Password для доступа к инструментам 1Password Environment.
`create_environment`	Создать новый 1Password Environment в указанной учетной записи. Обязательно ротируйте любые секреты, которые ранее хранились в открытом виде в вашей кодовой базе или .env файлах.
`rename_environment`	Переименовать 1Password Environment в указанной учетной записи.
`create_local_env_file`	Создать локально смонтированный `.env` файл для 1Password Environment, который делает ваши секреты доступными по запросу без записи на диск.
`list_environments`	Только чтение. Перечислить все 1Password Environments в указанной учетной записи.
`list_variables`	Только чтение. Получить список имен переменных окружения, хранящихся в 1Password Environment.
`list_local_env_files`	Только чтение. Перечислить все локально смонтированные `.env` файлы из 1Password Environment. Локальные .env файлы в настоящее время поддерживают только Mac и Linux.

Узнать больше

1Password Environments
Использование агентского хука 1Password для проверки локальных .env файлов из 1Password Environments
Использование плагина 1Password для Claude Code для управления Environments и проверки локальных .env файлов
Использование плагина 1Password для Cursor для управления Environments и проверки локальных .env файлов
Начало работы с 1Password Developer
Управление политиками команды в 1Password Business: Общий доступ и разрешения
Рабочий процесс: Безопасный доступ ИИ

Связанные темы

Использование Cursor с 1Password Environments
Использование Claude Code с 1Password Environments
Безопасные секреты для ИИ-агентов и инструментов