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

Install MCP Server

手動設定

在你選用的 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_AUTH token 是用於本機開發伺服器。你可以從 Oso Cloud UI 取得正式伺服器的 OSO_AUTH token。

我可以在哪裡找到我的 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,一個開發者文件平台。