1Password MCP

公式

1Password MCPサーバーは、CodexやKiroなどのMCPクライアントが、安全な認証プロンプトを使用して1Password環境を管理できるようにするブリッジを作成します。

1password.dev で表示

1Password MCPで何ができますか？

  • 環境の一覧表示 — アシスタントに、list_environments を使用してアカウント内のすべての1Password環境を一覧表示するよう依頼します。
  • 環境の作成または名前変更 — アシスタントに、create_environment または rename_environment を使用して新しい環境を作成したり、既存の環境の名前を変更したりするよう指示します。
  • 変数の管理 — アシスタントに、append_variables または list_variables を使用して、環境内の変数を追加・更新したり、変数名を一覧表示したりしてもらいます。
  • ローカル .env ファイルのマウント — アシスタントに、create_local_env_file または list_local_env_files を使用して、オンデマンドのシークレットアクセス用にローカルマウントされた .env ファイルを作成したり、既存のマウントを一覧表示したりするよう依頼します。

ドキュメント

1Password Environments MCP サーバー

安全な認可プロンプトを使用して MCP クライアントを 1Password Environments に接続し、シークレットをエージェントに返すことなく管理できます。

1Password Environments MCP サーバーを使用すると、Claude Code 、Codex 、Cursor 、Kiro などの MCP クライアントが、1Password Environments を安全に管理できます。このサーバーは変数名と Environment 名のみを参照でき、Environment に保存されているシークレットを返すことはありません。シークレットは 1Password 内に安全に保持されます。

MCP サーバーを使用すると、次のことができます:

  • Environment の作成、一覧表示、名前の変更。
  • Environment に保存されている変数名の一覧表示。
  • Environment への変数の追加。
  • シークレットをディスクに書き込まずにオンデマンドで利用できるようにするローカルマウントされた .env ファイルの作成。
  • ローカルマウントされた .env ファイルの一覧表示。

MCP サーバーに対する 1Password のアプローチについて詳しく学ぶ。

1Password Environments MCP サーバーの仕組み

1Password Environments MCP サーバーは、1Password デスクトップアプリの一部としてコンピューター上でローカルに実行されます。MCP クライアントがサーバーに接続するか、Environment ごとの承認が必要なツールを使用すると、1Password アプリは安全な認可プロンプトを表示します。承認すると、クライアントは 1Password がロックされるまで、再度プロンプトを表示されることなく、承認されたツールをその Environment で使用できます。

設計上、サーバーは 1Password に保存されているシークレット値をクライアントに返すことはできません。エージェントが要求した場合でも同様です。

このウォークスルーでは、Codex で MCP サーバーを使用する方法を示します:

要件

MCP サーバーを使用する前に、以下が必要です:

注記

1Password Enterprise Password Manager の管理者は、MCP サーバー機能をオン/オフにできます。これを行うには、1Password.com でアカウントにサインインし、ポリシー > エージェント権限 に移動して、ローカル MCP サーバー オプションを必要に応じてオンまたはオフにします。

ステップ 1: MCP サーバーへのアクセスを有効にする

1Password で、設定 > 開発者 に移動し、MCP クライアントと統合 を選択します。

ステップ 2: MCP クライアントを設定する

次に、MCP クライアント内で 1Password をローカル MCP サーバーとして設定する必要があります。

1Password MCP サーバーを設定するには、[Claude Code 用 1Password プラグイン](/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 サーバーが接続されていることを確認します。

[Claude Code 用 1Password プラグイン](/environments/claude-plugin)について詳しく学ぶ。
> **注記** > > Codex は現在 Mac と Linux をサポートしています。 
Codex 用に 1Password Environments MCP サーバーを設定するには:

1. Codex で、**MCP サーバー** に移動し、**+ サーバーを追加** を選択します。トグルがオンになっていることを確認します。
2. **起動コマンド** フィールドに、次のように入力します:

```
1password-mcp
```

次に、`AGENTS.md` ファイルを更新して、Codex が確認を求めずに明示的に MCP サーバーを使用するように指示します。

これを行うには、**パーソナライゼーション** に移動し、**カスタム指示** フィールドに入力します。たとえば、次の指示を追加します:

「私が明示的に依頼しなくても、1Password 開発者環境を操作する必要がある場合は、常に 1Password Environments MCP サーバーを使用してください。」

1Password Environments MCP サーバーを設定するには、[Cursor 用 1Password プラグイン](/environments/cursor-plugin)をインストールします。このプラグインは、MCP 設定とともに、ローカルの `.env` ファイル検証フックと、Cursor Agent に完全な Environments セットアップワークフローを提供するエージェントスキルを登録します。

1. Cursor を開き、**Cursor Agents** ウィンドウに移動します。
2. 左側のサイドバーで、**カスタマイズ** を選択します。
3. 上部メニューで **プラグイン** を選択します。
4. **1Password** を検索して、**追加** を選択します。
5. Cursor を再起動し、**設定** > **ツール & MCP** に移動して 1Password サーバーが接続されていることを確認します。

[Cursor 用 1Password プラグイン](/environments/cursor-plugin)について詳しく学ぶ。
> **注記** > > この機能はベータ版です。Kiro プラグインは現在 Mac と Linux をサポートしています。 
[Kiro 用 1Password Environments MCP サーバー](https://github.com/1Password/1password-kiro-plugin)を設定するには、Kiro Power Marketplace または GitHub からプラグインをインストールできます。

#### オプション 1: Kiro Power Marketplace からインストール

1. [kiro.dev/powers](https://kiro.dev/powers) で「1Password Developer Environments」を検索します。
2. **Kiro に追加** を選択して、Kiro でインストールページを開きます。
3. **+インストール** を選択して Power をインストールします。
4. **Power を試す** を選択して Environment を検証し、開始します。

#### オプション 2: GitHub からインストール

1. アクティビティバーで **Powers** を選択するか、コマンドパレットを開いて **Powers: インストール済みビューにフォーカス** を検索します。
2. **カスタム Power を追加** を選択します。
3. メニューオプションから **GitHub から Power をインポート** を選択します。
4. リポジトリ URL を貼り付けます: `https://github.com/1Password/1password-kiro-plugin`
5. インストール済みの Power のリストから `1password-kiro-plugin` を選択します。
6. `Power: 1Password Developer Environments` 画面から、**Power を試す** を選択して Environment を検証し、開始します。
`stdio` トランスポートをサポートする任意の MCP クライアントで 1Password Environments MCP サーバーを手動で設定するには、MCP クライアントの設定ファイルに `1password-mcp` コマンドを追加します。 
クライアントが JSON MCP 設定ファイルを使用する場合:

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

クライアントが TOML 設定ファイルを使用する場合:

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

その後、クライアントを再起動します。

ステップ 3: クライアントに Environment の管理を依頼する

MCP サーバーを接続したら、クライアントに次のようなタスクを依頼できます:

  • 「1Password Environments を一覧表示して」
  • 「ここにローカルの .env マウントを作成して」
  • 「プロジェクト環境の変数名を表示して」
  • 「OpenAI API キーの変数を追加して」
  • 「my-project という新しい Environment を作成して」

警告

コードベースまたは .env ファイルにプレーンテキストで以前保存されていたシークレットを 1Password にインポートする場合は、必ずローテーションしてください。プロジェクトのシークレットを 1Password に移動すると、今後は保護されますが、Git 履歴やコーディングエージェントのメモリなど、過去の露出を軽減することはできません。

利用可能なツール

次のツールが MCP クライアントに公開されています。クライアントが特定の Environment と対話するためにツールを初めて呼び出すとき、1Password が承認を求めるプロンプトを表示する場合があります。

ツール説明
append_variables1Password Environment の環境変数を追加または更新します。コードベースまたは .env ファイルにプレーンテキストで以前保存されていたシークレットは、必ずローテーションしてください。
authenticate1Password デスクトップアプリで認証して、1Password Environment ツールにアクセスします。
create_environment指定されたアカウントに新しい 1Password Environment を作成します。コードベースまたは .env ファイルにプレーンテキストで以前保存されていたシークレットは、必ずローテーションしてください。
rename_environment指定されたアカウントの 1Password Environment の名前を変更します。
create_local_env_fileシークレットをディスクに書き込まずにオンデマンドで利用できるようにする、1Password Environment 用のローカルマウントされた .env ファイルを作成します。
list_environments読み取り専用。 指定されたアカウントのすべての 1Password Environments を一覧表示します。
list_variables読み取り専用。 1Password Environment に保存されている環境変数名のリストを取得します。
list_local_env_files読み取り専用。 1Password Environment からローカルマウントされたすべての .env ファイルを一覧表示します。ローカル .env ファイルは現在 Mac と Linux のみをサポートしています。

詳細情報

関連トピック