Oso Cloud MCP Server
官方理解、開發及除錯 Oso Cloud 中的授權政策。
你可以用 Oso Cloud MCP 做什麼?
- 檢查您的政策 — 請助理擷取您目前的授權政策,以便您檢視其結構。
- 檢視已儲存的事實 — 讓助理列出您 Oso Cloud 資料中的所有事實,以查看存在哪些關係與屬性。
- 執行授權檢查 — 詢問某個行為者是否對某項資源具有特定權限,並取得最終的判定結果。
- 依模式查詢事實 — 請助理使用模式比對來搜尋您的事實,以找出特定的關係。
- 偵錯非預期的判定 — 詢問為何某個行為者對某項資源的某個動作缺少權限,以追查原因。
- 執行政策測試 — 讓助理執行您的政策測試,以檢查行為是否符合預期。
- 在開發伺服器上編輯政策與資料 — 連線至本機開發伺服器時,更新政策、新增或刪除事實,或清除資料。
文件
Oso MCP Server
透過我們的 MCP server,將你本機的 LLM 設定與 Oso Cloud API 整合。
使用 MCP Server 來:
- 更深入理解你的 policy
- 使用自然語言詢問與授權相關的問題
- 偵錯為何某個授權決策與你的預期不符
[!WARNING]
本指南假設你已經安裝並設定好 CLI。
連線
Claude Desktop (DXT)
還沒安裝 CLI,或不想手動新增設定嗎?別擔心——下載下列 DXT 檔案並按兩下,即可自動將 Oso MCP Server 安裝到 Claude Desktop 或其他支援 DXT 的 AI 用戶端。
curl -O https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt
驗證 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
你也可以指定 DXT 版本:
curl -O https://d2nl1ljmg8n1q8.cloudfront.net/0.33.2/oso-cloud-mcp.dxt
注意:目前沒有 DXT 版本 <0.33.0
以下安裝方式假設你已經安裝並設定好 CLI(版本 >=0.33.0)。
Cursor
手動設定
在你選用的 LLM 用戶端中,將下列內容加入你的 MCP 設定檔,即可讓它對本機開發伺服器執行:
{
"mcpServers": {
"oso": {
"command": "oso-cloud",
"args": ["experimental", "mcp"],
"env": {
"OSO_URL": "http://localhost:8080",
"OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
}
}
}
}
- 你可以選擇省略
OSO_URL環境變數,或將其設為https://cloud.osohq.com,以便對正式環境伺服器執行。 - 所提供的
OSO_AUTHtoken 是用於本機開發伺服器。你可以從 Oso Cloud UI 取得正式伺服器的OSO_AUTHtoken。
我可以在哪裡找到我的 MCP 設定檔?
以下是一些常見用戶端的指南:
使用方式
[!WARNING]
此伺服器主要用於搭配開發伺服器以協助開發。對正式環境使用時請格外謹慎。
當你的 MCP 伺服器啟動並執行後,你可以向你的 LLM 詢問任何與授權相關的問題,並觀察它使用可用的工具。目前我們提供以下讀取工具:
- 取得你的 policy
- 取得所有 facts
- 執行
authorize查詢 - 以模式比對查詢你的 facts
- 執行 policy 測試
我們也提供以下寫入工具,僅限用於本機開發伺服器:
- 更新你的 policy
- 新增 facts
- 刪除 facts
- 清除所有資料
試著傳送下列任一訊息:
- 繪製我的授權 policy 的 mermaid 圖表
<actor>對<resource>有哪些權限?- 例如:「Alice 對 Project XYZ 有哪些權限?」
- 為什麼
<actor>沒有<resource><action>的權限?
意見回饋
我們正積極改善開發者體驗,非常歡迎你對 Oso MCP Server 以及 Oso Cloud 整體開發體驗提供任何意見回饋。請不吝在 Slack 上與我們聯絡!
本文件建置並託管於 Mintlify,一個開發者文件平台。