MCP 経由で 1Password Connect を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → 1Password Connect をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

1Password Connect + Gemini

セルフホストの 1Password Connect サーバーを通じた 1Password の保管庫とアイテム：保管庫とアイテムの一覧、秘密の値と添付ファイルを含むアイテムの読み取り、生成パスワード付きアイテムの作成、JSON Patch による更新、サーバーのリクエストログの参照。削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

ONEPASSWORD_CONNECT_URL, ONEPASSWORD_CONNECT_TOKEN

ステップ 1 — 認証情報を取得

設定は約 15 分で、デプロイ済みの 1Password Connect サーバーが必要です。これは 1Password が Secrets Automation のために自社インフラ内で動かすセルフホストの REST API です。

1. 1Password.com で Developer、Directory を開き、Infrastructure Secrets Management の Other を選んで Create a Connect server を選択します（または op connect server create <name> --vaults <vault> を実行します）。1password-credentials.json ファイルと最初のアクセストークンを 1Password に保存します。Connect がアクセスできるのは付与された共有保管庫だけで、個人用やプライベートの保管庫には決してアクセスしません。
2. サーバーをデプロイします。https://github.com/1Password/connect の connect-api と connect-sync コンテナを、Docker Compose、Kubernetes、または Helm チャートで動かします。既定ではポート 8080 で待ち受けます。
3. 最初のトークンを使うか、AI 専用のトークンを発行します: Developer、Connect servers、サーバーを選択、New Token（または op connect token create <name> --server <server> --vault <vault>）。AI に見せる保管庫だけを付与してください。トークンの保管庫は後から変更できないため、変える場合は取り消して新しいトークンを発行します。有効期限は 30、90、180 日から設定できます。
4. ONEPASSWORD_CONNECT_URL に、AnythingMCP から到達できるサーバーのアドレスを /v1 と末尾のスラッシュなしで設定し（例: https://op-connect.example.com、http://10.0.0.5:8080）、トークン（eyJ で始まる JWT。Bearer は付けません）を ONEPASSWORD_CONNECT_TOKEN に貼り付けます。
5. コネクタをインストールし、onepassword_connect_list_vaults を実行します。トークンを確認し、アクセスできる保管庫を一覧表示します。

Connect サーバーの置き場所: AnythingMCP Cloud では、Connect サーバーに公開 HTTPS アドレスが必要です。セルフホストの AnythingMCP では、送信先ガードが既定でプライベートアドレス空間をブロックするため、プライベートネットワークや IP 上のサーバーには、そのホストを SSRF_ALLOWED_HOSTS で許可して初めて到達できます。

AI は秘密の値を見ます。次のツールはシークレットを平文で返します:

• onepassword_connect_get_item: アイテムのパスワード、API キー、TOTP シード、メモ、その他の非表示フィールドを fields[].value に返します。
• onepassword_connect_get_file_content: 添付ファイル（証明書、鍵ファイル、文書）の中身を最大 4 MB まで返します。
• onepassword_connect_create_item と onepassword_connect_update_item: 秘密の値や生成されたパスワードを含む、アイテム全体を返します。

これらの値は AI モデルとチャットに渡ります。一覧ツール（onepassword_connect_list_vaults、onepassword_connect_list_items、onepassword_connect_list_files）、onepassword_connect_get_vault、onepassword_connect_get_file はメタデータだけを返します。トークンには AI に見せる保管庫だけを付与し、AI に名前だけで作業させたい場合は、ワークスペース管理者に onepassword_connect_get_item と onepassword_connect_get_file_content をオフにしてもらいます。AI は、あなたが求めない限り回答でシークレットを繰り返しません。

シークレットを探す: onepassword_connect_list_vaults（name eq "Production" のようなフィルター）、次に onepassword_connect_list_items でタイトル、カテゴリ、タグ、URL、バージョン、日付を確認し（フィルター title eq "Stripe API" や tag eq "prod"）、値そのものが必要なときだけ onepassword_connect_get_item を使います。ファイル: 名前とサイズは onepassword_connect_list_files か onepassword_connect_get_file で、ダウンロードは onepassword_connect_get_file_content で行います。

書き込める内容: onepassword_connect_create_item はカテゴリ、タイトル、フィールドを指定して作成します。generate: true と recipe を持つフィールドには、1Password がランダムな値を生成します。onepassword_connect_update_item は JSON Patch（RFC 6902: add、remove、replace）でアイテムの一部を変更します。対象は /title、/favorite、/tags、/urls、/fields（フィールドの追加）、/fields/<field id>、/fields/<field id>/value で、パス / はアイテム全体を置き換えます。AI は先に onepassword_connect_get_item でフィールド ID を読み取ります。1Password は前のバージョンをアイテムの履歴に残します。

サーバーの確認: onepassword_connect_list_activity はサーバーが処理したリクエストを新しい順に一覧表示します（READ、CREATE、UPDATE、DELETE と SUCCESS または DENY、トークンとアイテムごと）。onepassword_connect_get_health はサーバー、同期サービス、アカウント接続が正常かどうかを示し、サーバーの問題とトークンの問題を切り分けられます。

インストール時はオフ: onepassword_connect_delete_item。元に戻せず、Connect 経由でそのシークレットを読むアプリケーションはすぐに見つけられなくなるため、チームが必要なときにワークスペース管理者がオンにします。

データ形式: 保管庫とアイテムの ID は 26 文字の小文字英字と数字です。フィールドには id、label、type（STRING、CONCEALED、EMAIL、URL、TOTP、DATE、MONTH_YEAR、MENU）、purpose（USERNAME、PASSWORD、NOTES）、value、section があり、パスワードフィールドには entropy も付きます。日付は ISO 8601 です。

ページング: 一覧は 1 回の応答でコレクション全体を返します。ページングするのは onepassword_connect_list_activity だけで、limit（既定 50）と offset を使い、合計を content-range ヘッダー（1-50/1134）で示します。

よくあるエラー: 401 はトークンの誤りや取り消し、または別の Connect サーバー用のトークンです。403 vault ... is not in scope は、その保管庫がトークンに付与されていないか、書き込みが許可されていないことを示します。404 は保管庫、アイテム、ファイルが存在しないことを示し、すべての呼び出しで 404 になる場合は ONEPASSWORD_CONNECT_URL が Connect API のアドレスではありません。書き込み時の 400 は無効なフィールドやカテゴリを示します。413 はファイルが大きすぎて返せないことを示します。接続エラーは通常、AnythingMCP から ONEPASSWORD_CONNECT_URL に到達できないことを意味します。詳しくは onepassword_connect_get_health とサーバーログで確認できます。

このコネクタは個人用やプライベートの保管庫、トークンに付与されていない保管庫にはアクセスせず、インストール時に有効なツールではアイテムを削除せず、Connect サーバーやトークンを作成せず、アカウントのサインインイベントや監査イベントも読みません（それは 1Password Events コネクタの役割です）。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が 1Password Connect のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「AI がアクセスできる保管庫はどれで、それぞれにアイテムは何件ありますか？」
• 「Production 保管庫の Stripe API アイテムを探して、キーは表示せずに最終更新日時を教えてください。」
• 「DevOps 保管庫に、ユーザー名 app と生成パスワードで staging データベース用の Login アイテムを作成してください。」
• 「Infrastructure 保管庫の Mail relay アイテムにタグ rotated を追加してください。」
• 「今日 Connect 経由でアイテムを読んだトークンはどれで、拒否されたリクエストはありましたか？」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続