Oso Cloud MCP Server
chính thứcHiểu, phát triển và gỡ lỗi các chính sách ủy quyền trong Oso Cloud.
Bạn có thể làm gì với Oso Cloud MCP?
- Kiểm tra chính sách của bạn — Yêu cầu trợ lý truy xuất chính sách ủy quyền hiện tại của bạn để bạn có thể xem xét cách nó được cấu trúc.
- Xem lại các dữ kiện đã lưu trữ — Yêu cầu trợ lý liệt kê tất cả các dữ kiện trong dữ liệu Oso Cloud của bạn để xem những mối quan hệ và thuộc tính nào tồn tại.
- Chạy kiểm tra ủy quyền — Hỏi liệu một tác nhân có quyền cụ thể trên một tài nguyên hay không, và nhận quyết định kết quả.
- Truy vấn dữ kiện theo mẫu — Yêu cầu trợ lý tìm kiếm các dữ kiện của bạn bằng cách sử dụng khớp mẫu để tìm các mối quan hệ cụ thể.
- Gỡ lỗi các quyết định bất ngờ — Hỏi tại sao một tác nhân thiếu quyền cho một hành động trên một tài nguyên để truy tìm nguyên nhân.
- Chạy kiểm thử chính sách — Yêu cầu trợ lý thực thi các kiểm thử chính sách của bạn để kiểm tra hành vi so với kỳ vọng.
- Chỉnh sửa chính sách và dữ liệu trên máy chủ dev — Cập nhật chính sách, thêm hoặc xóa dữ kiện, hoặc xóa dữ liệu khi được kết nối với máy chủ dev cục bộ.
Tài liệu
Oso MCP Server
Tích hợp thiết lập LLM cục bộ của bạn với Oso Cloud APIs thông qua MCP server của chúng tôi.
Sử dụng MCP Server để:
- phát triển hiểu biết tốt hơn về policy của bạn
- sử dụng ngôn ngữ tự nhiên để đặt các câu hỏi liên quan đến phân quyền
- gỡ lỗi tại sao một quyết định phân quyền không khớp với những gì bạn mong đợi
[!WARNING]
Hướng dẫn này giả định bạn đã cài đặt và thiết lập CLI.
Kết nối
Claude Desktop (DXT)
Chưa cài đặt CLI hoặc không muốn thêm cấu hình thủ công? Đừng lo - hãy tải xuống tệp DXT sau và nhấp đúp để tự động cài đặt Oso MCP Server vào Claude Desktop hoặc các ứng dụng AI khác chấp nhận DXTs.
curl -O https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt
Xác minh checksum SHA256:
MacOS:
curl -sL https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt.sha256 | shasum -a 256 -c
Linux:
curl -sL https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt.sha256 | sha256sum -c
Bạn cũng có thể chỉ định phiên bản DXT:
curl -O https://d2nl1ljmg8n1q8.cloudfront.net/0.33.2/oso-cloud-mcp.dxt
Lưu ý: Không có phiên bản DXT <0.33.0
Các phương thức cài đặt sau đây giả định bạn đã cài đặt và thiết lập CLI (phiên bản >=0.33.0).
Cursor
Thủ công
Trong ứng dụng LLM bạn chọn, thêm nội dung sau vào tệp cấu hình MCP của bạn để chạy nó với local dev server:
{
"mcpServers": {
"oso": {
"command": "oso-cloud",
"args": ["experimental", "mcp"],
"env": {
"OSO_URL": "http://localhost:8080",
"OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
}
}
}
}
- Bạn có thể tùy chọn bỏ qua biến môi trường
OSO_URLhoặc đặt nó thànhhttps://cloud.osohq.comnếu bạn muốn chạy nó với một production server đang hoạt động. - Token
OSO_AUTHđược cung cấp dành cho local dev server. Bạn có thể lấy tokenOSO_AUTHcủa live server từ Oso Cloud UI.
Tôi có thể tìm tệp cấu hình MCP của mình ở đâu?
Dưới đây là hướng dẫn cho một số ứng dụng phổ biến:
Cách sử dụng
[!WARNING]
Server này chủ yếu dành cho việc sử dụng với dev server để hỗ trợ phát triển. Vui lòng cẩn thận hơn khi sử dụng với môi trường live.
Khi MCP server của bạn đã chạy, bạn có thể hỏi LLM của mình bất kỳ câu hỏi nào liên quan đến phân quyền và xem nó sử dụng các công cụ có sẵn. Hiện tại, chúng tôi cung cấp các công cụ đọc để:
- Lấy policy của bạn
- Lấy tất cả facts
- Chạy truy vấn
authorize - Truy vấn facts của bạn bằng pattern matching
- Chạy policy tests
Chúng tôi cũng cung cấp các công cụ ghi sau, chỉ được giới hạn sử dụng với local dev server:
- Cập nhật policy của bạn
- Thêm facts
- Xóa facts
- Xóa tất cả dữ liệu
Hãy thử gửi bất kỳ tin nhắn nào sau đây:
- Vẽ sơ đồ mermaid về policy phân quyền của tôi
<actor>có những quyền gì trên<resource>?- ví dụ: "Alice có những quyền gì trên Project XYZ?"
- Tại sao
<actor>không có quyền<action><resource>?
Phản hồi
Chúng tôi đang tích cực cải tiến trải nghiệm nhà phát triển và rất mong nhận được mọi phản hồi về Oso MCP Server cũng như trải nghiệm phát triển tổng thể với Oso Cloud. Đừng ngần ngại liên hệ trên Slack!
Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.