1Password MCP

officiel

Le serveur 1Password MCP crée un pont qui permet aux clients MCP tels que Codex et Kiro de gérer vos environnements 1Password avec des invites d'autorisation sécurisées.

Voir sur 1password.dev

Que pouvez-vous faire avec 1Password MCP ?

  • Lister les environnements — Demandez à votre assistant de lister tous les environnements 1Password de votre compte via list_environments.
  • Créer ou renommer des environnements — Demandez à votre assistant de créer un nouvel environnement ou d’en renommer un existant à l’aide de create_environment ou rename_environment.
  • Gérer les variables — Demandez à votre assistant d’ajouter ou de mettre à jour des variables dans un environnement, ou de lister les noms de variables, via append_variables ou list_variables.
  • Monter des fichiers .env locaux — Demandez à votre assistant de créer un fichier .env monté localement pour un accès à la demande aux secrets, ou de lister les montages existants, en utilisant create_local_env_file ou list_local_env_files.

Documentation

Serveur MCP 1Password Environments

Connectez les clients MCP à 1Password Environments avec des invites d'autorisation sécurisées, sans renvoyer les secrets à l'agent.

Le serveur MCP 1Password Environments permet aux clients MCP tels que Claude Code , Codex , Cursor et Kiro de gérer en toute sécurité vos 1Password Environments. Le serveur ne peut voir que les noms de variables et d'Environments, et ne renvoie jamais les secrets stockés dans vos Environments, qui restent en sécurité dans 1Password.

Vous pouvez utiliser le serveur MCP pour :

  • Créer, lister et renommer des Environments.
  • Lister les noms des variables stockées dans un Environment.
  • Ajouter des variables à un Environment.
  • Créer des fichiers .env montés localement qui rendent vos secrets disponibles à la demande sans les écrire sur le disque.
  • Lister les fichiers .env montés localement.

En savoir plus sur l'approche de 1Password concernant les serveurs MCP.

Comment fonctionne le serveur MCP 1Password Environments

Le serveur MCP 1Password Environments s'exécute localement sur votre ordinateur dans le cadre de l'application de bureau 1Password. Lorsque votre client MCP se connecte au serveur ou utilise un outil nécessitant une approbation par Environment, l'application 1Password affiche une invite d'autorisation sécurisée. Si vous approuvez, le client peut utiliser l'outil approuvé avec l'Environment à nouveau sans vous demander jusqu'à ce que 1Password se verrouille.

Par conception, le serveur ne peut pas renvoyer les valeurs secrètes stockées dans 1Password au client, même si un agent les demande.

Cette démonstration montre comment utiliser le serveur MCP avec Codex :

Prérequis

Avant de pouvoir utiliser le serveur MCP, vous devrez :

Remarque

Les administrateurs de 1Password Enterprise Password Manager peuvent activer ou désactiver la fonctionnalité serveur MCP. Pour ce faire, connectez-vous à votre compte sur 1Password.com, puis accédez à Politiques > Autorisations agentiques et activez ou désactivez l'option Serveur MCP local selon vos besoins.

Étape 1 : Activer l'accès au serveur MCP

Dans 1Password, accédez à Paramètres > Développeur, puis sélectionnez Intégrer aux clients MCP.

Étape 2 : Configurer votre client MCP

Ensuite, vous devrez configurer 1Password comme serveur MCP local dans votre client MCP.

Pour configurer le serveur MCP 1Password, installez le [plugin 1Password pour Claude Code](/environments/claude-plugin). Le plugin enregistre la configuration MCP pour vous, ainsi qu'un hook de validation de fichier `.env` local et une compétence d'agent qui donne à Claude Code un flux de travail complet de configuration des Environments.

1. Ouvrez votre terminal, accédez à votre répertoire de projet, puis saisissez `claude` pour démarrer une session Claude Code.

2. Ajoutez la place de marché 1Password :

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

3. Installez le plugin :

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

4. Redémarrez Claude Code, puis saisissez `/mcp` pour confirmer que le serveur 1Password est connecté.

En savoir plus sur [le plugin 1Password pour Claude Code](/environments/claude-plugin).
> **Remarque** > > Codex prend actuellement en charge Mac et Linux. 
Pour configurer le serveur MCP 1Password Environments pour Codex :

1. Dans Codex, accédez à **Serveurs MCP** et sélectionnez **+ Ajouter un serveur**. Assurez-vous que l'interrupteur est activé.
2. Dans le champ **Commande à lancer**, saisissez :

```
1password-mcp
```

Ensuite, mettez à jour votre fichier `AGENTS.md` pour demander à Codex d'utiliser explicitement le serveur MCP sans avoir à demander.

Pour ce faire, accédez à **Personnalisation** et remplissez le champ **Instructions personnalisées**. Par exemple, ajoutez l'instruction :

« Utilisez toujours le serveur MCP 1Password Environments si vous devez travailler avec les environnements de développement 1Password sans que j'aie à le demander explicitement. »

Pour configurer le serveur MCP 1Password Environments, installez le [plugin 1Password pour Cursor](/environments/cursor-plugin). Le plugin enregistre la configuration MCP pour vous, ainsi qu'un hook de validation de fichier `.env` local et une compétence d'agent qui donne à Cursor Agent un flux de travail complet de configuration des Environments.

1. Ouvrez Cursor et accédez à la fenêtre **Cursor Agents**.
2. Dans la barre latérale gauche, sélectionnez **Personnaliser**.
3. Sélectionnez **Plugins** dans le menu supérieur.
4. Recherchez **1Password** puis sélectionnez **Ajouter**.
5. Redémarrez Cursor, puis accédez à **Paramètres** > **Outils et MCP** pour confirmer que le serveur 1Password est connecté.

En savoir plus sur [le plugin 1Password pour Cursor](/environments/cursor-plugin).
> **Remarque** > > Cette fonctionnalité est en version bêta. Le plugin Kiro prend actuellement en charge Mac et Linux. 
Pour configurer le [serveur MCP 1Password Environments pour Kiro](https://github.com/1Password/1password-kiro-plugin), vous pouvez soit installer le plugin depuis le Kiro Power Marketplace, soit depuis GitHub.

#### Option 1 : Installer depuis le Kiro Power Marketplace

1. Recherchez « 1Password Developer Environments » sur [kiro.dev/powers](https://kiro.dev/powers).
2. Sélectionnez **Ajouter à Kiro** pour ouvrir la page d'installation dans Kiro.
3. Sélectionnez **+Installer** pour installer le Power.
4. Sélectionnez **Essayer le power** pour valider votre Environment et commencer.

#### Option 2 : Installer depuis GitHub

1. Sélectionnez **Powers** dans la barre d'activité, ou ouvrez la palette de commandes et recherchez **Powers : Focus sur la vue installée**.
2. Sélectionnez **Ajouter un Power personnalisé**.
3. Sélectionnez **Importer un Power depuis GitHub** dans les options du menu.
4. Collez l'URL du dépôt : `https://github.com/1Password/1password-kiro-plugin`
5. Sélectionnez `1password-kiro-plugin` dans la liste des Powers installés.
6. Depuis l'écran `Power: 1Password Developer Environments`, sélectionnez **Essayer le power** pour valider votre Environment et commencer.
Pour configurer manuellement le serveur MCP 1Password Environments avec tout client MCP prenant en charge le transport `stdio`, ajoutez la commande `1password-mcp` au fichier de configuration de votre client MCP. 
Si votre client utilise un fichier de configuration MCP JSON :

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

Si votre client utilise un fichier de configuration TOML :

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

Redémarrez ensuite votre client.

Étape 3 : Demandez à votre client de gérer un Environment

Après avoir connecté le serveur MCP, vous pouvez demander à votre client d'effectuer des tâches comme :

  • « Lister mes 1Password Environments »
  • « Créer un montage .env local ici »
  • « Afficher les noms de variables dans mon environnement de projet »
  • « Ajouter une variable pour ma clé API OpenAI »
  • « Créer un nouvel Environment appelé mon-projet »

Avertissement

Assurez-vous de faire pivoter les secrets que vous importez dans 1Password et qui étaient auparavant stockés en texte brut dans votre codebase ou vos fichiers .env. Déplacer les secrets de votre projet vers 1Password les sécurise à l'avenir, mais n'atténue pas les expositions passées, comme dans votre historique Git ou la mémoire de votre agent de codage.

Outils disponibles

Les outils suivants sont exposés aux clients MCP. La première fois qu'un client appelle un outil pour interagir avec un Environment spécifique, 1Password peut vous demander d'approuver.

OutilDescription
append_variablesAjouter ou mettre à jour des variables d'environnement dans un 1Password Environment. Assurez-vous de faire pivoter les secrets qui étaient auparavant stockés en texte brut dans votre codebase ou vos fichiers .env.
authenticateS'authentifier auprès de l'application de bureau 1Password pour accéder aux outils 1Password Environment.
create_environmentCréer un nouveau 1Password Environment dans un compte spécifié. Assurez-vous de faire pivoter les secrets qui étaient auparavant stockés en texte brut dans votre codebase ou vos fichiers .env.
rename_environmentRenommer un 1Password Environment dans un compte spécifié.
create_local_env_fileCréer un fichier .env monté localement pour un 1Password Environment qui rend vos secrets disponibles à la demande sans les écrire sur le disque.
list_environmentsLecture seule. Lister tous les 1Password Environments dans un compte spécifié.
list_variablesLecture seule. Récupérer une liste des noms de variables d'environnement stockées dans un 1Password Environment.
list_local_env_filesLecture seule. Lister tous les fichiers .env montés localement depuis un 1Password Environment. Les fichiers .env locaux ne prennent actuellement en charge que Mac et Linux.

En savoir plus

Sujets connexes