Oso Cloud MCP Server

官方

理解、开发和调试 Oso Cloud 中的授权策略。

你可以用 Oso Cloud MCP 做什么?

  • 检查你的策略 — 让助手检索你当前的授权策略,以便你查看其结构。
  • 查看已存储的事实 — 让助手列出 Oso Cloud 数据中的所有事实,以查看存在哪些关系和属性。
  • 运行授权检查 — 询问某个主体是否对某个资源拥有给定权限,并获取结果决策。
  • 按模式查询事实 — 让助手使用模式匹配搜索你的事实,以查找特定的关系。
  • 调试意外决策 — 询问为什么某个主体对某个资源上的某个操作缺少权限,以追踪原因。
  • 运行策略测试 — 让助手执行你的策略测试,以检查行为是否符合预期。
  • 在开发服务器上编辑策略和数据 — 连接到本地开发服务器时,更新策略、添加或删除事实,或清除数据。

文档

Oso MCP Server

通过我们的 MCP server 将你的本地 LLM 环境与 Oso Cloud API 集成。

使用 MCP Server 可以:

  • 更好地理解你的策略
  • 使用自然语言提出与授权相关的问题
  • 调试为什么某个授权决策与你的预期不符

[!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 server 启动并运行,你就可以向你的 LLM 提出任何与授权相关的问题,并观察它使用可用的工具。目前,我们提供以下读取工具:

  • 获取你的策略
  • 获取所有事实
  • 运行 authorize 查询
  • 通过模式匹配查询你的事实
  • 运行策略测试

我们还提供以下写入工具,仅限用于本地开发服务器:

  • 更新你的策略
  • 添加事实
  • 删除事实
  • 清除所有数据

尝试发送以下任意消息:

  • 为我的授权策略绘制一张 mermaid 图
  • <actor> 对 <resource> 拥有哪些权限?
    • 例如:“Alice 对 Project XYZ 拥有哪些权限?”
  • 为什么 <actor> 没有权限对 <action> <resource> 执行操作?

反馈

我们正在积极改进开发者体验,非常欢迎你对 Oso MCP Server 以及 Oso Cloud 更广泛的开发体验提出任何反馈。请随时在 Slack 上联系我们!

本文档构建并托管于 Mintlify,一个开发者文档平台。