1Password Connect über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → 1Password Connect klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

1Password Connect + Gemini

Tresore und Items von 1Password über deinen selbst gehosteten 1Password-Connect-Server: Tresore und Items auflisten, Items mit ihren geheimen Werten und angehängten Dateien lesen, Items mit generierten Passwörtern anlegen, sie per JSON Patch ändern und das Anfrageprotokoll des Servers lesen. Löschen ist bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ONEPASSWORD_CONNECT_URL, ONEPASSWORD_CONNECT_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 15 Minuten und braucht einen laufenden 1Password-Connect-Server, die selbst gehostete REST-API, die 1Password für Secrets Automation in deiner eigenen Infrastruktur betreibt.

1. Öffne auf 1Password.com Developer, Directory, wähle unter Infrastructure Secrets Management Other und Create a Connect server (oder führe op connect server create <name> --vaults <vault> aus). Speichere die Datei 1password-credentials.json und das erste Access Token in 1Password. Connect erreicht nur die geteilten Tresore, die ihm freigegeben wurden, nie persönliche oder private Tresore.
2. Stelle den Server bereit: die Container connect-api und connect-sync aus https://github.com/1Password/connect, mit Docker Compose, Kubernetes oder dem Helm-Chart. Standardmäßig lauscht er auf Port 8080.
3. Nutze das erste Token oder stelle eines nur für die KI aus: Developer, Connect servers, den Server wählen, New Token (oder op connect token create <name> --server <server> --vault <vault>). Gib nur die Tresore frei, die die KI sehen soll. Die Tresore eines Tokens lassen sich später nicht ändern; widerrufe es dann und stelle ein neues aus. Ein Ablauf nach 30, 90 oder 180 Tagen ist möglich.
4. Setze ONEPASSWORD_CONNECT_URL auf die Adresse des Servers, wie AnythingMCP ihn erreicht, ohne /v1 und ohne Schrägstrich am Ende (zum Beispiel https://op-connect.example.com oder http://10.0.0.5:8080), und füge das Token (ein JWT, das mit eyJ beginnt, ohne Bearer) in ONEPASSWORD_CONNECT_TOKEN ein.
5. Installiere den Connector und führe onepassword_connect_list_vaults aus: Es bestätigt das Token und listet die erreichbaren Tresore.

Wo der Connect-Server läuft: Auf AnythingMCP Cloud braucht der Connect-Server eine öffentliche HTTPS-Adresse. Ein selbst gehostetes AnythingMCP erreicht einen Server in einem privaten Netz oder unter einer privaten IP erst, wenn dieser Host über SSRF_ALLOWED_HOSTS erlaubt ist, denn der Schutz für ausgehende Verbindungen sperrt private Adressbereiche standardmäßig.

Die KI sieht geheime Werte. Diese Tools liefern Secrets im Klartext:

• onepassword_connect_get_item: die Passwörter, API-Schlüssel, TOTP-Seeds, Notizen und anderen verdeckten Felder des Items in fields[].value.
• onepassword_connect_get_file_content: den Inhalt einer angehängten Datei (Zertifikate, Schlüsseldateien, Dokumente), bis 4 MB.
• onepassword_connect_create_item und onepassword_connect_update_item: Sie antworten mit dem vollständigen Item, einschließlich geheimer Werte und eines generierten Passworts.

Diese Werte gehen an das KI-Modell und in den Chat. Die Listen-Tools (onepassword_connect_list_vaults, onepassword_connect_list_items, onepassword_connect_list_files), onepassword_connect_get_vault und onepassword_connect_get_file liefern nur Metadaten. Gib dem Token nur die Tresore frei, die die KI sehen soll, und lass einen Workspace-Admin onepassword_connect_get_item und onepassword_connect_get_file_content abschalten, wenn die KI nur mit Namen arbeiten soll. Die KI wiederholt ein Secret in einer Antwort nur, wenn du danach fragst.

Ein Secret finden: onepassword_connect_list_vaults (Filter wie name eq "Production"), dann onepassword_connect_list_items mit Titel, Kategorie, Tags, URLs, Version und Datum (Filter title eq "Stripe API" oder tag eq "prod"), dann onepassword_connect_get_item nur, wenn der Wert selbst gebraucht wird. Dateien: onepassword_connect_list_files oder onepassword_connect_get_file für Namen und Größen, onepassword_connect_get_file_content zum Herunterladen.

Was er schreibt: onepassword_connect_create_item mit Kategorie, Titel und Feldern; ein Feld mit generate: true und einem recipe bekommt von 1Password einen Zufallswert. onepassword_connect_update_item ändert einen Teil eines Items per JSON Patch (RFC 6902: add, remove, replace) auf /title, /favorite, /tags, /urls, /fields (um ein Feld hinzuzufügen), /fields/<field id> oder /fields/<field id>/value; der Pfad / ersetzt das ganze Item. Die KI liest die Feld-IDs vorher mit onepassword_connect_get_item. 1Password behält die vorherige Version im Verlauf des Items.

Server prüfen: onepassword_connect_list_activity listet die Anfragen, die der Server bearbeitet hat, die neuesten zuerst: READ, CREATE, UPDATE oder DELETE mit SUCCESS oder DENY, je Token und Item. onepassword_connect_get_health zeigt, ob der Server, sein Sync-Dienst und die Verbindung zum Konto gesund sind, und trennt so ein Serverproblem von einem Tokenproblem.

Bei der Installation deaktiviert: onepassword_connect_delete_item. Es lässt sich nicht rückgängig machen, und Anwendungen, die das Secret über Connect lesen, finden es sofort nicht mehr. Ein Workspace-Admin schaltet es ein, wenn das Team es braucht.

Datenformate: Tresor- und Item-IDs bestehen aus 26 Kleinbuchstaben und Ziffern. Ein Feld hat id, label, type (STRING, CONCEALED, EMAIL, URL, TOTP, DATE, MONTH_YEAR, MENU), purpose (USERNAME, PASSWORD, NOTES), value und section; Passwortfelder tragen zusätzlich entropy. Datumsangaben sind ISO 8601.

Blättern: Listen liefern die ganze Sammlung in einer Antwort. Nur onepassword_connect_list_activity blättert, mit limit (Standard 50) und offset, und meldet die Gesamtzahl im Header content-range (1-50/1134).

Häufige Fehler: 401 heißt falsches oder widerrufenes Token oder eines für einen anderen Connect-Server. 403 vault ... is not in scope heißt, dem Token wurde dieser Tresor nicht freigegeben oder es darf dort nicht schreiben. 404 heißt, Tresor, Item oder Datei gibt es nicht; 404 bei jedem Aufruf heißt, ONEPASSWORD_CONNECT_URL ist nicht die Adresse der Connect-API. 400 bei einem Schreibzugriff nennt das ungültige Feld oder die ungültige Kategorie. 413 heißt, eine Datei ist zu groß für die Rückgabe. Verbindungsfehler bedeuten meist, dass AnythingMCP ONEPASSWORD_CONNECT_URL nicht erreicht; onepassword_connect_get_health und die Serverlogs verraten mehr.

Der Connector erreicht keine persönlichen oder privaten Tresore und keine, die dem Token nicht freigegeben sind, löscht mit den bei der Installation aktiven Tools keine Items, legt keine Connect-Server oder Tokens an und liest keine Anmelde- und Audit-Events des Kontos (dafür gibt es den Connector 1Password Events).

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

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

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die 1Password Connect-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Tresore kann die KI erreichen, und wie viele Items liegen in jedem?“
• „Such das Item Stripe API im Tresor Production und sag mir, wann es zuletzt geändert wurde, ohne den Schlüssel zu zeigen.“
• „Leg im Tresor DevOps ein Login-Item für die Staging-Datenbank an, mit Benutzername app und einem generierten Passwort.“
• „Füge dem Item Mail relay im Tresor Infrastructure das Tag rotated hinzu.“
• „Welche Tokens haben heute über Connect Items gelesen, und wurden Anfragen abgelehnt?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden