1Password MCP

ทางการ

เซิร์ฟเวอร์ 1Password MCP สร้างสะพานเชื่อมที่ช่วยให้ไคลเอนต์ MCP เช่น Codex และ Kiro สามารถจัดการสภาพแวดล้อม 1Password ของคุณด้วยการแจ้งเตือนการอนุญาตที่ปลอดภัย

ดูบน 1password.dev

คุณทำอะไรได้บ้างด้วย 1Password MCP?

  • รายการสภาพแวดล้อม — ขอให้ผู้ช่วยของคุณแสดงรายการสภาพแวดล้อม 1Password ทั้งหมดในบัญชีของคุณผ่าน list_environments
  • ดูชื่อตัวแปร — ดึงชื่อของตัวแปรที่จัดเก็บไว้ในสภาพแวดล้อมโดยไม่เปิดเผยค่าลับโดยใช้ list_variables
  • เพิ่มหรืออัปเดตตัวแปร — เพิ่มหรือแก้ไขตัวแปรสภาพแวดล้อมในสภาพแวดล้อม 1Password ด้วย append_variables
  • สร้างและเปลี่ยนชื่อสภาพแวดล้อม — ตั้งค่าสภาพแวดล้อมใหม่หรือเปลี่ยนชื่อสภาพแวดล้อมที่มีอยู่โดยใช้ create_environment และ rename_environment
  • เมานต์ไฟล์ .env ในเครื่อง — สร้างไฟล์ .env ที่เมานต์ในเครื่องซึ่งให้การเข้าถึงความลับตามความต้องการโดยไม่ต้องเขียนลงดิสก์ผ่าน create_local_env_file

เอกสาร

1Password Environments MCP Server

เชื่อมต่อ MCP clients เข้ากับ 1Password Environments พร้อมพร้อมท์การอนุญาตที่ปลอดภัย โดยไม่ส่งคืน secrets กลับไปยัง agent

1Password Environments MCP Server ช่วยให้ MCP clients เช่น Claude Code , Codex , Cursor และ Kiro จัดการ 1Password Environments ของคุณได้อย่างปลอดภัย เซิร์ฟเวอร์สามารถมองเห็นได้เฉพาะชื่อตัวแปรและชื่อ Environment เท่านั้น และไม่ส่งคืน secrets ที่เก็บอยู่ใน Environments ของคุณ ซึ่งยังคงปลอดภัยใน 1Password

คุณสามารถใช้ MCP server เพื่อ:

  • สร้าง ดูรายการ และเปลี่ยนชื่อ Environments
  • ดูรายชื่อตัวแปรที่เก็บอยู่ใน Environment
  • เพิ่มตัวแปรลงใน Environment
  • สร้าง ไฟล์ .env ที่ mount ในเครื่อง ที่ทำให้ secrets ของคุณพร้อมใช้งานตามต้องการโดยไม่ต้องเขียนลงดิสก์
  • ดูรายการไฟล์ .env ที่ mount ในเครื่อง

เรียนรู้เพิ่มเติมเกี่ยวกับแนวทางของ 1Password ต่อ MCP servers

วิธีทำงานของ 1Password Environments MCP Server

1Password Environments MCP Server ทำงานในเครื่องบนคอมพิวเตอร์ของคุณโดยเป็นส่วนหนึ่งของแอปเดสก์ท็อป 1Password เมื่อ MCP client ของคุณเชื่อมต่อกับเซิร์ฟเวอร์หรือใช้ tool ที่ต้องได้รับการอนุมัติต่อ Environment แอป 1Password จะแสดงพร้อมท์การอนุญาตที่ปลอดภัย หากคุณอนุมัติ client จะสามารถใช้ tool ที่ได้รับการอนุมัติกับ Environment นั้นได้อีกครั้งโดยไม่ต้องถามคุณจนกว่า 1Password จะล็อก

โดยการออกแบบ เซิร์ฟเวอร์ไม่สามารถส่งคืนค่า secrets ที่เก็บอยู่ใน 1Password กลับไปยัง client ได้ แม้ว่า agent จะร้องขอ

คำแนะนำนี้แสดงวิธีใช้ MCP server สำหรับ Codex:

ข้อกำหนด

ก่อนที่คุณจะใช้ MCP server ได้ คุณจะต้อง:

หมายเหตุ

ผู้ดูแลระบบ 1Password Enterprise Password Manager สามารถเปิดและปิดฟีเจอร์ MCP server ได้ โดย ลงชื่อเข้าใช้ บัญชีของคุณบน 1Password.com จากนั้นไปที่ Policies > Agentic permissions และเปิดหรือปิดตัวเลือก Local MCP server ตามต้องการ

ขั้นตอนที่ 1: เปิดการเข้าถึง MCP server

วิธีเปิด MCP server:

  1. ใน 1Password ไปที่ Settings > Labs จากนั้นเลือก MCP Server
  2. เปิดสวิตช์ Enable local MCP server
  3. ไปที่ Settings > Developer และเลือก Integrate with MCP clients

ขั้นตอนที่ 2: กำหนดค่า MCP client ของคุณ

ถัดไป คุณจะต้องกำหนดค่า 1Password เป็น local MCP server ภายใน MCP client ของคุณ

วิธีกำหนดค่า 1Password MCP server ให้ติดตั้ง [ปลั๊กอิน 1Password สำหรับ Claude Code](/environments/claude-plugin) ปลั๊กอินจะลงทะเบียนการกำหนดค่า MCP ให้คุณ พร้อมกับ hook สำหรับตรวจสอบไฟล์ `.env` ในเครื่อง และ agent skill ที่ให้ Claude Code มีขั้นตอนการตั้งค่า Environments อย่างครบถ้วน

1. เปิดเทอร์มินัล ไปที่ไดเรกทอรีโปรเจกต์ของคุณ จากนั้นป้อน `claude` เพื่อเริ่มเซสชัน Claude Code

2. เพิ่ม marketplace ของ 1Password:

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

3. ติดตั้งปลั๊กอิน:

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

4. รีสตาร์ท Claude Code จากนั้นป้อน `/mcp` เพื่อยืนยันว่าเซิร์ฟเวอร์ 1Password เชื่อมต่อแล้ว

เรียนรู้เพิ่มเติมเกี่ยวกับ [ปลั๊กอิน 1Password สำหรับ Claude Code](/environments/claude-plugin)
> **หมายเหตุ** > > Codex รองรับ Mac และ Linux ในขณะนี้ 
วิธีกำหนดค่า 1Password Environments MCP Server สำหรับ Codex:

1. ใน Codex ไปที่ **MCP servers** และเลือก **+ Add server** ตรวจสอบให้แน่ใจว่าเปิดสวิตช์อยู่
2. ในช่อง **Command to launch** ป้อน:

```
1password-mcp
```

ถัดไป อัปเดตไฟล์ `AGENTS.md` ของคุณเพื่อสั่งให้ Codex ใช้ MCP server อย่างชัดเจนโดยไม่ต้องถาม

โดยไปที่ **Personalization** และกรอกข้อมูลในช่อง **Custom instructions** ตัวอย่างเช่น เพิ่มคำสั่ง:

"Always use the 1Password Environments MCP Server if you need to work with the 1Password developer environments without me having to explicitly ask."

วิธีกำหนดค่า 1Password Environments MCP Server ให้ติดตั้ง [ปลั๊กอิน 1Password สำหรับ Cursor](/environments/cursor-plugin) ปลั๊กอินจะลงทะเบียนการกำหนดค่า MCP ให้คุณ พร้อมกับ hook สำหรับตรวจสอบไฟล์ `.env` ในเครื่อง และ agent skill ที่ให้ Cursor Agent มีขั้นตอนการตั้งค่า Environments อย่างครบถ้วน

1. เปิด Cursor และไปที่หน้าต่าง **Cursor Agents**
2. ในแถบด้านข้างซ้าย เลือก **Customize**
3. เลือก **Plugins** ในเมนูด้านบน
4. ค้นหา **1Password** จากนั้นเลือก **Add**
5. รีสตาร์ท Cursor จากนั้นไปที่ **Settings** > **Tools & MCP** เพื่อยืนยันว่าเซิร์ฟเวอร์ 1Password เชื่อมต่อแล้ว

เรียนรู้เพิ่มเติมเกี่ยวกับ [ปลั๊กอิน 1Password สำหรับ Cursor](/environments/cursor-plugin)
> **หมายเหตุ** > > ฟีเจอร์นี้อยู่ในช่วงเบต้า ปลั๊กอิน Kiro รองรับ Mac และ Linux ในขณะนี้ 
วิธีกำหนดค่า [1Password Environments MCP Server สำหรับ Kiro](https://github.com/1Password/1password-kiro-plugin) คุณสามารถติดตั้งปลั๊กอินจาก Kiro Power Marketplace หรือจาก GitHub

#### ตัวเลือกที่ 1: ติดตั้งจาก Kiro Power Marketplace

1. ค้นหา "1Password Developer Environments" ที่ [kiro.dev/powers](https://kiro.dev/powers)
2. เลือก **Add to Kiro** เพื่อเปิดหน้าติดตั้งใน Kiro
3. เลือก **+Install** เพื่อติดตั้ง Power
4. เลือก **Try power** เพื่อตรวจสอบ Environment ของคุณและเริ่มต้นใช้งาน

#### ตัวเลือกที่ 2: ติดตั้งจาก GitHub

1. เลือก **Powers** ใน Activity Bar หรือเปิด Command Palette และค้นหา **Powers: Focus on Installed view**
2. เลือก **Add Custom Power**
3. เลือก **Import Power from GitHub** จากตัวเลือกเมนู
4. วาง URL ของ repository: `https://github.com/1Password/1password-kiro-plugin`
5. เลือก `1password-kiro-plugin` จากรายการ Powers ที่ติดตั้ง
6. จากหน้าจอ `Power: 1Password Developer Environments` เลือก **Try power** เพื่อตรวจสอบ Environment ของคุณและเริ่มต้นใช้งาน
วิธีกำหนดค่า 1Password Environments MCP Server ด้วยตนเองกับ MCP client ใดก็ได้ที่รองรับการส่งข้อมูลแบบ `stdio` ให้เพิ่มคำสั่ง `1password-mcp` ลงในไฟล์กำหนดค่าของ MCP client ของคุณ 
หาก client ของคุณใช้ไฟล์กำหนดค่า MCP แบบ JSON:

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

หาก client ของคุณใช้ไฟล์กำหนดค่าแบบ TOML:

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

จากนั้นรีสตาร์ท client ของคุณ

ขั้นตอนที่ 3: ขอให้ client ของคุณจัดการ Environment

หลังจากที่คุณเชื่อมต่อ MCP server แล้ว คุณสามารถขอให้ client ของคุณทำงานต่างๆ เช่น:

  • "List my 1Password Environments"
  • "Create a local .env mount here"
  • "Show me the variable names in my project environment"
  • "Add a variable for my OpenAI API key"
  • "Create a new Environment called my-project"

คำเตือน

ตรวจสอบให้แน่ใจว่าได้หมุนเวียน secrets ใดๆ ที่คุณนำเข้าไปใน 1Password ซึ่งก่อนหน้านี้ถูกเก็บเป็น plaintext ใน codebase หรือไฟล์ .env ของคุณ การย้าย secrets ของโปรเจกต์ไปยัง 1Password จะรักษาความปลอดภัยต่อไปในอนาคต แต่ไม่ได้ลดความเสี่ยงจากการเปิดเผยในอดีต เช่น ใน Git history หรือหน่วยความจำของ coding agent ของคุณ

Tools ที่มีให้ใช้งาน

Tools ต่อไปนี้เปิดเผยให้กับ MCP clients ครั้งแรกที่ client เรียกใช้ tool เพื่อโต้ตอบกับ Environment เฉพาะ 1Password อาจแสดงพร้อมท์ให้คุณอนุมัติ

Toolคำอธิบาย
append_variablesเพิ่มหรืออัปเดต environment variables ใน 1Password Environment ตรวจสอบให้แน่ใจว่าได้หมุนเวียน secrets ใดๆ ที่ก่อนหน้านี้ถูกเก็บเป็น plaintext ใน codebase หรือไฟล์ .env ของคุณ
authenticateตรวจสอบสิทธิ์กับแอปเดสก์ท็อป 1Password เพื่อเข้าถึง 1Password Environment tools
create_environmentสร้าง 1Password Environment ใหม่ในบัญชีที่ระบุ ตรวจสอบให้แน่ใจว่าได้หมุนเวียน secrets ใดๆ ที่ก่อนหน้านี้ถูกเก็บเป็น plaintext ใน codebase หรือไฟล์ .env ของคุณ
rename_environmentเปลี่ยนชื่อ 1Password Environment ในบัญชีที่ระบุ
create_local_env_fileสร้าง ไฟล์ .env ที่ mount ในเครื่อง สำหรับ 1Password Environment ที่ทำให้ secrets ของคุณพร้อมใช้งานตามต้องการโดยไม่ต้องเขียนลงดิสก์
list_environmentsอ่านอย่างเดียว ดูรายการ 1Password Environments ทั้งหมดในบัญชีที่ระบุ
list_variablesอ่านอย่างเดียว ดึงรายการชื่อ environment variables ที่เก็บอยู่ใน 1Password Environment
list_local_env_filesอ่านอย่างเดียว ดูรายการไฟล์ .env ที่ mount ในเครื่องทั้งหมดจาก 1Password Environment ไฟล์ .env ในเครื่องรองรับเฉพาะ Mac และ Linux ในขณะนี้

เรียนรู้เพิ่มเติม

หัวข้อที่เกี่ยวข้อง