1Password MCP

официальный

The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.

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

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

Список ваших сред 1Password — попросите ассистента перечислить все среды, к которым у вас есть доступ, с помощью list_environments.
Создание новой среды — попросите ассистента создать именованную среду для проекта с помощью create_environment.
Список имен переменных в среде — попросите ассистента показать все имена переменных, определенные в конкретной среде, с помощью list_variables.
Добавление переменной-заполнителя — попросите ассистента добавить новое имя переменной (не раскрывая ее значение) в среду с помощью add_variable.
Монтирование локального файла .env — попросите ассистента подготовить локальное монтирование .env для внедрения секретов во время выполнения с помощью mount_env.

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

Использование сервера 1Password MCP для управления средами 1Password клиентами MCP (бета-версия)

export const Small = ({children}) => { return {children}; };

export const YouTubeVideo = ({src, title, alt}) => { return <iframe className="w-full aspect-video rounded-xl" src={src} title={alt ?? title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen> ; };

Бета-версия

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

С помощью сервера MCP вы можете:

Создавать среды.
Просматривать имена переменных среды.
Обрабатывать локальные файлы .env в рамках аутентифицированных рабочих процессов, безопасно храня учетные данные в 1Password.
Управлять секретами в средах 1Password.

Сервер MCP не считывает и не возвращает секреты MCP-клиенту. Вместо этого секреты остаются в 1Password и доступны только авторизованным процессам. В результате сервер MCP позволяет вашему агенту работать с секретами, никогда их не видя.

Подробнее о подходе 1Password к серверам MCP.

Как это работает

Ваш MCP-клиент подключается к 1Password через сервер MCP для создания и управления средой проекта. По завершении проекта MCP-клиент запрашивает у 1Password монтирование локального файла .env через FIFO-файл в памяти.

Во время выполнения 1Password внедряет необходимые переменные из вашей среды непосредственно в процесс приложения. Значения существуют в памяти только для авторизованного процесса и только до тех пор, пока процесс в них нуждается. MCP-клиент оркеструет, приложение выполняет, а 1Password выдает учетные данные.

Например, если вы попросите MCP-клиент создать среду 1Password:

Запустите задачу в MCP-клиенте: Например, попросите Codex или Kiro создать приложение и управлять им.
Ваш MCP-клиент подключается к серверу 1Password MCP: Это происходит через локальное соединение, где клиент может обнаруживать и вызывать доступные действия из инструкций, предоставляемых MCP.
1Password проверяет запросы: Сервер MCP взаимодействует с настольным приложением 1Password, которое обрабатывает идентификацию, авторизацию и безопасный доступ.
Вы подтверждаете доступ: Каждое взаимодействие требует явного подтверждения запроса авторизации пользователем 1Password, прежде чем клиент сможет продолжить.
MCP-клиент создает и управляет средой в 1Password: Клиент может создавать среды, просматривать имена переменных и управлять ими, а также подготавливать конфигурацию без доступа к самим секретам.
1Password внедряет секреты во время выполнения: Приложения запускаются с использованием секретов из 1Password, при этом сами секреты никогда не раскрываются агенту.

В этом пошаговом руководстве показано, как использовать сервер MCP для Codex:

Требования

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

Начало работы с сервером MCP

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

Прежде чем использовать сервер MCP, вам нужно включить эту функцию и настроить MCP-клиент.

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

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

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

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

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

Эта функция находится в бета-версии. Codex в настоящее время поддерживает Mac и Linux.

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

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

```
1password-mcp
```

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

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

"Всегда используй сервер 1Password MCP, если тебе нужно работать со средами разработки 1Password, без необходимости явно меня об этом просить."

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

Чтобы настроить [сервер 1Password MCP для 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**, чтобы проверить среду и начать работу.

#### Вариант 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**, чтобы проверить среду и начать работу.

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

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

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

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

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

Примеры запросов

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

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

Настольное приложение 1Password может запрашивать подтверждение при подключении MCP-клиента к серверу MCP или доступе к среде.

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

Среды 1Password (бета-версия)
Использование агентского хука 1Password для проверки локальных .env-файлов из сред 1Password
Синхронизация секретов между 1Password и AWS Secrets Manager (бета-версия)
Начало работы с 1Password Developer
Управление командными политиками в 1Password Business: Общий доступ и разрешения
Рабочий процесс: Безопасный доступ ИИ

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

Безопасный доступ ИИ
Безопасность для ИИ
Поиск и чтение документации разработчика 1Password с помощью ИИ