1Password MCP

1Password Environments MCP Server

Verbinde MCP-Clients mit 1Password Environments über sichere Autorisierungsabfragen, ohne Geheimnisse an den Agenten zurückzugeben.

Der 1Password Environments MCP Server ermöglicht es MCP-Clients wie Claude Code , Codex , Cursor und Kiro , Ihre 1Password Environments sicher zu verwalten. Der Server kann nur Variablen- und Environment-Namen sehen und gibt niemals die in Ihren Environments gespeicherten Geheimnisse zurück, die sicher in 1Password bleiben.

Sie können den MCP-Server für Folgendes verwenden:

• Environments erstellen, auflisten und umbenennen.
• Die Namen der in einem Environment gespeicherten Variablen auflisten.
• Variablen zu einem Environment hinzufügen.
• Lokal gemountete .env-Dateien erstellen, die Ihre Geheimnisse bei Bedarf verfügbar machen, ohne sie auf die Festplatte zu schreiben.
• Lokal gemountete .env-Dateien auflisten.

Erfahren Sie mehr über den Ansatz von 1Password für MCP-Server.

So funktioniert der 1Password Environments MCP Server

Der 1Password Environments MCP Server läuft lokal auf Ihrem Computer als Teil der 1Password-Desktop-App. Wenn Ihr MCP-Client eine Verbindung zum Server herstellt oder ein Tool verwendet, das eine Genehmigung pro Environment erfordert, zeigt die 1Password-App eine sichere Autorisierungsabfrage an. Wenn Sie zustimmen, kann der Client das genehmigte Tool mit dem Environment erneut verwenden, ohne Sie erneut zu fragen, bis 1Password gesperrt wird.

Der Server kann per Design keine in 1Password gespeicherten Geheimniswerte an den Client zurückgeben, selbst wenn ein Agent sie anfordert.

Diese Anleitung zeigt, wie Sie den MCP-Server für Codex verwenden:

Voraussetzungen

Bevor Sie den MCP-Server verwenden können, benötigen Sie Folgendes:

• Registrieren Sie sich für 1Password.
• Installieren Sie die 1Password-Desktop-App.
• Erstellen Sie ein 1Password Environment.
• Einen MCP-Client, der stdio-Transport unterstützt. Nur Remote-MCP-Clients werden derzeit nicht unterstützt.

Hinweis

1Password Enterprise Password Manager-Administratoren können die MCP-Server-Funktion ein- und ausschalten. Melden Sie sich dazu an bei Ihrem Konto auf 1Password.com, gehen Sie dann zu Richtlinien > Agentische Berechtigungen und schalten Sie die Option Lokaler MCP-Server nach Bedarf ein oder aus.

Schritt 1: Zugriff auf den MCP-Server aktivieren

So aktivieren Sie den MCP-Server:

1. Gehen Sie in 1Password zu Einstellungen > Labore und wählen Sie dann MCP-Server.
2. Aktivieren Sie den Schalter Lokalen MCP-Server aktivieren.
3. Navigieren Sie zu Einstellungen > Entwickler und wählen Sie In MCP-Clients integrieren.

Schritt 2: Ihren MCP-Client konfigurieren

Als Nächstes müssen Sie 1Password als lokalen MCP-Server in Ihrem MCP-Client konfigurieren.

Um den 1Password MCP-Server zu konfigurieren, installieren Sie das [1Password-Plugin für Claude Code](/environments/claude-plugin). Das Plugin registriert die MCP-Konfiguration für Sie, zusammen mit einem lokalen `.env`-Dateivalidierungs-Hook und einer Agent-Fähigkeit, die Claude Code einen vollständigen Environments-Einrichtungsworkflow bietet.

1. Öffnen Sie Ihr Terminal, wechseln Sie in Ihr Projektverzeichnis und geben Sie dann `claude` ein, um eine Claude-Code-Sitzung zu starten.

2. Fügen Sie den 1Password-Marketplace hinzu:

   ```shell theme={null}
   /plugin marketplace add 1Password/1password-claude-plugin
   ```

3. Installieren Sie das Plugin:

   ```shell theme={null}
   /plugin install 1password@1password
   ```

4. Starten Sie Claude Code neu und geben Sie dann `/mcp` ein, um zu bestätigen, dass der 1Password-Server verbunden ist.

Erfahren Sie mehr über [das 1Password-Plugin für Claude Code](/environments/claude-plugin).

> **Hinweis** > > Codex unterstützt derzeit Mac und Linux.

So konfigurieren Sie den 1Password Environments MCP Server für Codex:

1. Gehen Sie in Codex zu **MCP-Server** und wählen Sie **+ Server hinzufügen**. Stellen Sie sicher, dass der Schalter aktiviert ist.
2. Geben Sie im Feld **Befehl zum Starten** Folgendes ein:

```
1password-mcp
```

Aktualisieren Sie als Nächstes Ihre `AGENTS.md`-Datei, um Codex anzuweisen, den MCP-Server explizit zu verwenden, ohne fragen zu müssen.

Gehen Sie dazu zu **Personalisierung** und füllen Sie das Feld **Benutzerdefinierte Anweisungen** aus. Fügen Sie beispielsweise die Anweisung hinzu:

„Verwenden Sie immer den 1Password Environments MCP Server, wenn Sie mit den 1Password-Entwicklerumgebungen arbeiten müssen, ohne dass ich explizit fragen muss."

Um den 1Password Environments MCP Server zu konfigurieren, installieren Sie das [1Password-Plugin für Cursor](/environments/cursor-plugin). Das Plugin registriert die MCP-Konfiguration für Sie, zusammen mit einem lokalen `.env`-Dateivalidierungs-Hook und einer Agent-Fähigkeit, die Cursor Agent einen vollständigen Environments-Einrichtungsworkflow bietet.

1. Öffnen Sie Cursor und navigieren Sie zum Fenster **Cursor Agents**.
2. Wählen Sie in der linken Seitenleiste **Anpassen**.
3. Wählen Sie **Plugins** im oberen Menü.
4. Suchen Sie nach **1Password** und wählen Sie dann **Hinzufügen**.
5. Starten Sie Cursor neu und gehen Sie dann zu **Einstellungen** > **Tools & MCP**, um zu bestätigen, dass der 1Password-Server verbunden ist.

Erfahren Sie mehr über [das 1Password-Plugin für Cursor](/environments/cursor-plugin).

> **Hinweis** > > Diese Funktion befindet sich in der Beta-Phase. Das Kiro-Plugin unterstützt derzeit Mac und Linux.

Um den [1Password Environments MCP Server für Kiro](https://github.com/1Password/1password-kiro-plugin) zu konfigurieren, können Sie das Plugin entweder aus dem Kiro Power Marketplace oder von GitHub installieren.

#### Option 1: Aus dem Kiro Power Marketplace installieren

1. Suchen Sie nach „1Password Developer Environments" auf [kiro.dev/powers](https://kiro.dev/powers).
2. Wählen Sie **Zu Kiro hinzufügen**, um die Installationsseite in Kiro zu öffnen.
3. Wählen Sie **+Installieren**, um die Power zu installieren.
4. Wählen Sie **Power testen**, um Ihr Environment zu validieren und loszulegen.

#### Option 2: Von GitHub installieren

1. Wählen Sie **Powers** in der Aktivitätsleiste oder öffnen Sie die Befehlspalette und suchen Sie nach **Powers: Fokus auf installierte Ansicht**.
2. Wählen Sie **Benutzerdefinierte Power hinzufügen**.
3. Wählen Sie **Power von GitHub importieren** aus den Menüoptionen.
4. Fügen Sie die Repository-URL ein: `https://github.com/1Password/1password-kiro-plugin`
5. Wählen Sie `1password-kiro-plugin` aus der Liste der installierten Powers.
6. Wählen Sie auf dem Bildschirm `Power: 1Password Developer Environments` die Option **Power testen**, um Ihr Environment zu validieren und loszulegen.

Um den 1Password Environments MCP Server manuell mit einem beliebigen MCP-Client zu konfigurieren, der `stdio`-Transport unterstützt, fügen Sie den `1password-mcp`-Befehl zur Konfigurationsdatei Ihres MCP-Clients hinzu.

Wenn Ihr Client eine JSON-MCP-Konfigurationsdatei verwendet:

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

Wenn Ihr Client eine TOML-Konfigurationsdatei verwendet:

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

Starten Sie dann Ihren Client neu.

Schritt 3: Bitten Sie Ihren Client, ein Environment zu verwalten

Nachdem Sie den MCP-Server verbunden haben, können Sie Ihren Client bitten, Aufgaben wie die folgenden auszuführen:

• „Liste meine 1Password Environments auf"
• „Erstelle hier einen lokalen .env-Mount"
• „Zeige mir die Variablennamen in meinem Projekt-Environment"
• „Füge eine Variable für meinen OpenAI-API-Schlüssel hinzu"
• „Erstelle ein neues Environment namens my-project"

Warnung

Stellen Sie sicher, dass Sie alle Geheimnisse rotieren, die Sie in 1Password importieren und die zuvor im Klartext in Ihrer Codebasis oder in .env-Dateien gespeichert waren. Das Verschieben Ihrer Projektgeheimnisse in 1Password sichert sie für die Zukunft, mindert jedoch keine frühere Offenlegung, z. B. in Ihrem Git-Verlauf oder im Speicher Ihres Coding-Agenten.

Verfügbare Tools

Die folgenden Tools werden MCP-Clients bereitgestellt. Wenn ein Client zum ersten Mal ein Tool aufruft, um mit einem bestimmten Environment zu interagieren, fordert 1Password Sie möglicherweise zur Genehmigung auf.

Tool	Beschreibung
append_variables	Umgebungsvariablen in einem 1Password Environment hinzufügen oder aktualisieren. Stellen Sie sicher, dass Sie alle Geheimnisse rotieren, die zuvor im Klartext in Ihrer Codebasis oder in .env-Dateien gespeichert waren.
authenticate	Authentifizieren Sie sich mit der 1Password-Desktop-App, um auf 1Password Environment-Tools zuzugreifen.
create_environment	Erstellen Sie ein neues 1Password Environment in einem angegebenen Konto. Stellen Sie sicher, dass Sie alle Geheimnisse rotieren, die zuvor im Klartext in Ihrer Codebasis oder in .env-Dateien gespeichert waren.
rename_environment	Benennen Sie ein 1Password Environment in einem angegebenen Konto um.
create_local_env_file	Erstellen Sie eine lokal gemountete .env-Datei für ein 1Password Environment, die Ihre Geheimnisse bei Bedarf verfügbar macht, ohne sie auf die Festplatte zu schreiben.
list_environments	Schreibgeschützt. Alle 1Password Environments in einem angegebenen Konto auflisten.
list_variables	Schreibgeschützt. Eine Liste der in einem 1Password Environment gespeicherten Umgebungsvariablennamen abrufen.
list_local_env_files	Schreibgeschützt. Alle lokal gemounteten .env-Dateien aus einem 1Password Environment auflisten. Lokale .env-Dateien unterstützen derzeit nur Mac und Linux.

Weitere Informationen

• 1Password Environments
• Verwenden Sie den Agent-Hook von 1Password, um lokale .env-Dateien aus 1Password Environments zu validieren
• Verwenden Sie das 1Password-Plugin für Claude Code, um Environments zu verwalten und lokale .env-Dateien zu validieren
• Verwenden Sie das 1Password-Plugin für Cursor, um Environments zu verwalten und lokale .env-Dateien zu validieren
• Erste Schritte mit 1Password Developer
• Teamrichtlinien in 1Password Business verwalten: Freigabe und Berechtigungen
• Workflow: Sicherer KI-Zugriff

Verwandte Themen

• Cursor mit 1Password Environments verwenden
• Claude Code mit 1Password Environments verwenden
• Geheimnisse für KI-Agenten und Tools sichern