Kết nối AI tool với vault

Cho Claude Code, Claude.ai, ChatGPT, Cursor hoặc VS Code tìm, mô tả, đặt và dùng secret qua remote MCP, thông qua một thiết bị của bạn luôn trực tuyến.

Remote MCP cho một AI tool chạy trên cloud truy cập secrets vault đã đồng bộ của bạn mà không cần CLI cục bộ. Tool có thể tìm secret, mô tả chúng, đặt và xoá chúng, xin quyền truy cập, và chạy một chương trình bạn đã duyệt với một secret. Nó không bao giờ nhận được giá trị secret.

Chỉ có trên staging, tiền phát hành

Máy chủ MCP là https://vault-staging.agentkit.best/mcp, chỉ có trên staging. Đây là bản tiền phát hành và không dành cho credential production. Trạng thái được theo dõi tại release gates của ak-vault.

Máy chủ thấy những gì

Máy chủ vault không lưu bản rõ và không giữ vault key nào, nhưng một lời gọi remote MCP không được mã hoá đầu-cuối: bản rõ đi qua bộ nhớ của máy chủ sau khi TLS kết thúc. Đó là giá trị mà AI tool gửi kèm lệnh set, cho tới khi máy chủ niêm phong nó hoặc chuyển tiếp nó tới thiết bị của bạn, cùng tên, metadata và output run đã redact mà thiết bị gửi về trên đường tới AI tool. Chúng không bao giờ được ghi log, lưu trữ hay đưa vào thông báo lỗi. AI tool không kiểm tra chữ ký của thiết bị, nên chúng tin máy chủ về nội dung của kết quả. Xem ADR 0002, quyết định D7.

Đăng nhập và scope

Mọi client bên dưới theo cùng một luồng. Client tìm máy chủ đăng nhập qua /.well-known/oauth-protected-resource/mcp, tự đăng ký, và mở agentkit.best trong trình duyệt. Bạn đăng nhập ở đó và duyệt quyền truy cập mà client xin. Không có API key nào cần dán. Grant kéo dài 30 ngày, sau đó client yêu cầu bạn đăng nhập lại.

Scope	Nói đơn giản	Tool
`vault-mcp:read`	Xem tên và mô tả secret của bạn, không bao giờ xem giá trị	`secrets_search`, `secrets_list`, `secrets_describe`
`vault-mcp:write`	Thêm, thay hoặc xoá secret; ghi được giá trị nhưng không bao giờ đọc lại	`secrets_set`, `secrets_delete`
`vault-mcp:use`	Xin dùng một secret, và chạy với nó các lệnh bạn đã duyệt trên chính thiết bị của bạn; giá trị chỉ tới lệnh đó, không bao giờ tới AI tool	`secrets_request`, `secrets_run`

Giữ một thiết bị trực tuyến

Các lệnh đọc, request và run được trả lời bởi một thiết bị của bạn đang giữ kết nối relay. Thiết bị đó giải mã cục bộ, áp dụng grant và approval của chính nó, rồi trả lời. Chạy lệnh này trên thiết bị đó và để nó chạy:

ak secrets sync now --watch --relay

Relay cần một bản ak có tính năng này (v3.0.0-beta.36 trở lên). Nó chỉ hoạt động cùng --watch, giữ một kết nối tới máy chủ vault bên cạnh vòng lặp sync, và cũng áp dụng các lệnh ghi đã xếp hàng khi không có thiết bị nào trực tuyến. Mỗi lời gọi máy chủ chuyển tới đều chạy trên thiết bị đó, và kết quả được gửi về kèm chữ ký bằng device key. Thiết bị không hiện prompt nào. Một máy chủ vault bị xâm nhập có thể giả mạo các lệnh ghi mà relay áp dụng, nên AI agent không được khởi chạy nó: --relay do một agent chạy sẽ thoát với mã 6. Lệnh ak secrets sync now thông thường vẫn mở cho agent.

Trạng thái. Lệnh in relay: connected, relay: reconnecting hoặc relay: stopped(<reason>). Lỗi relay không bao giờ dừng vòng lặp sync, và các lỗi khác tự kết nối lại.
Mỗi tool làm gì ở đó. search, list và describe trả về tên và trường profile từ index cục bộ và không bao giờ đọc giá trị. set và delete ghi vào store của thiết bị này và đồng bộ ngay, nhưng chỉ trên thiết bị owner hoặc editor do người dùng điều khiển và không khi đang chờ rekey; nếu không, chúng trả lời denied và không ghi gì. Lệnh ghi vào một secret có chỉnh sửa cục bộ chưa được đẩy lên, hoặc vào tên của một secret cục bộ mới chưa được đẩy lên, trả lời conflict và giữ nguyên thay đổi cục bộ; hãy thử lại sau chu kỳ sync kế tiếp. request tạo một yêu cầu duyệt cho ak secrets approve, nơi client hiện là mcp:<client id>, và trả lời pending cho tới khi bạn trả lời. run chỉ khởi chạy chương trình khi một exec grant đã pin trên thiết bị này bao phủ mọi biến (xem Chạy một chương trình với secret); nếu không, nó tạo yêu cầu và trả lời pending_approval.
Output. Output của run đã gạch bỏ các giá trị được release. Output mà chương trình đã mã hoá, tách nhỏ hoặc in một phần thì không bị bắt.
Xoá. Các lệnh xoá từ xa được tính vào guard xoá hàng loạt cùng các lần xoá của chính thiết bị. Chạy relay với --allow-mass-delete để cho một đợt lớn hơn đi qua.
Audit. Mỗi lời gọi được ghi vào audit log mã hoá của vault kèm tool, client và kết quả, không bao giờ có giá trị hay đối số.

ak secrets sync now --help liệt kê mọi flag và exit code.

Khi không có thiết bị nào trực tuyến

Đọc, request và run trả lời no_device_online.
set và delete phải nêu vault_id. Máy chủ niêm phong thao tác bằng seal key của vault và xếp hàng nó (trạng thái queued) cho tới khi một thiết bị của bạn áp dụng nó như một lần ghi đã ký bình thường. Hàng đợi chỉ để ghi: không gì đọc lại được giá trị đã xếp hàng. Nó chỉ hoạt động cho owner hoặc editor của vault, chỉ sau khi một thiết bị chủ vault đã công bố seal key, và không hoạt động khi đang chờ rekey. Hàng đợi đầy sẽ trả lời sealed_queue_full.

Máy chủ không đọc được lệnh ghi đã niêm phong, nhưng một máy chủ bị xâm nhập có thể giả mạo một lệnh. Thiết bị chỉ áp dụng lệnh ghi đã xếp hàng khi đang chạy relay, hoặc sau khi bạn bật bằng ak secrets sync enable --accept-sealed, lệnh mà AI agent không chạy được. Hãy theo dõi ak secrets sync now để phát hiện lệnh ghi niêm phong bạn không chờ đợi.

Ngân sách lời gọi theo từng AI tool và từng tài khoản, hạn chót của relay, kích thước và thời gian sống của hàng đợi do worker/src/limits.ts quy định và được công bố qua GET /v1/meta trên máy chủ vault.

Thêm máy chủ vào AI tool

Mỗi client có phần cài đặt riêng, và tên menu thay đổi giữa các bản phát hành. Nếu một bước bên dưới không còn khớp, hãy tìm phần cài đặt máy chủ MCP từ xa (HTTP) hoặc custom connector của client và nhập cùng URL.

Claude Code

claude mcp add --transport http ak-vault https://vault-staging.agentkit.best/mcp

Sau đó chạy /mcp trong một phiên Claude Code, chọn ak-vault, rồi chọn Authenticate để đăng nhập qua agentkit.best.

Claude.ai

Mở Settings → Connectors, chọn Add custom connector, và nhập https://vault-staging.agentkit.best/mcp làm URL. Chọn Connect để đăng nhập qua agentkit.best. Với gói Team hoặc Enterprise, owner có thể phải thêm connector trước.

ChatGPT

Custom MCP connector cần developer mode. Bật nó trong Settings → Apps & Connectors → Advanced settings, rồi tạo một connector với URL https://vault-staging.agentkit.best/mcp và xác thực OAuth. ChatGPT mở agentkit.best để đăng nhập.

Cursor

Thêm máy chủ vào .cursor/mcp.json trong một project, hoặc vào ~/.cursor/mcp.json cho mọi project:

{
  "mcpServers": {
    "ak-vault": {
      "url": "https://vault-staging.agentkit.best/mcp"
    }
  }
}

Cursor liệt kê máy chủ trong phần cài đặt MCP; chọn lời nhắc đăng nhập của nó để xác thực qua agentkit.best.

VS Code

Thêm máy chủ vào .vscode/mcp.json trong workspace:

{
  "servers": {
    "ak-vault": {
      "type": "http",
      "url": "https://vault-staging.agentkit.best/mcp"
    }
  }
}

Khởi động máy chủ từ file đó hoặc bằng lệnh MCP: List Servers. VS Code yêu cầu bạn đăng nhập qua agentkit.best, và các tool xuất hiện trong agent mode của Copilot Chat.

Ngắt kết nối

Trong tài khoản AgentKit, mở Connected apps và ngắt kết nối AgentKit Vault (AI tools). Yêu cầu tiếp theo dùng grant đó sẽ bị từ chối. Chỉ xoá máy chủ khỏi client thì không kết thúc grant.

Để một thiết bị ngừng trả lời lời gọi, hãy dừng lệnh --watch --relay trên thiết bị đó.

Kết nối AI tool với vault

On this page