1Password MCP

公式

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

1password.dev で表示このMCPを試すスポンサー

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

  • List environments — アシスタントにlist_environmentsを呼び出してもらい、アカウント内のすべての1Password Environmentsを表示します。
  • Manage variables — list_variablesを使用して変数名を表示するか、append_variablesを使用して特定のEnvironmentに環境変数を追加または更新します。
  • Create and rename environments — アシスタントにcreate_environmentで新しいEnvironmentを作成させるか、rename_environmentで既存のEnvironmentの名前を変更します。
  • Mount local .env files — create_local_env_fileを使用して、ディスクに書き込まずにシークレットをオンデマンドで公開するローカルマウントされた.envファイルを作成するか、list_local_env_filesを使用して既存のマウントを確認します。

ドキュメント

1Password MCPサーバーを使用して1Password Environmentsを管理する

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

MCPサーバーを使用すると、以下のことができます：

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

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

1Password MCPサーバーの仕組み

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

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

このチュートリアルでは、CodexでMCPサーバーを使用する方法を示します：

要件

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

注記

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

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

MCPサーバーを有効にするには：

  1. 1Passwordで、設定 > ラボ に移動し、MCPサーバー を選択します。
  2. ローカルMCPサーバーを有効にする トグルをオンにします。
  3. 設定 > 開発者 に移動し、MCPクライアントと統合 を選択します。

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

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

> **注記** > > Codexは現在、MacとLinuxをサポートしています。 
Codex用に1Password MCPサーバーを設定するには：

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

```
1password-mcp
```

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

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

「1Password開発者環境を操作する必要がある場合は、私が明示的に依頼しなくても、常に1Password MCPサーバーを使用してください。」
> **注記** > > この機能はベータ版です。Cursorプラグインは現在、MacとLinuxをサポートしています。 
1Password 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のみをサポートしています。 
[Kiro用1Password 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. インストール済みのPowersのリストから `1password-kiro-plugin` を選択します。
6. `Power: 1Password Developer Environments` 画面で、**Powerを試す** を選択してEnvironmentを検証し、開始します。
`stdio` トランスポートをサポートする任意のMCPクライアントで1Password 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のみをサポートしています。

詳細情報

関連トピック