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
手动配置
在你选择的 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 server 启动并运行,你就可以向你的 LLM 提出任何与授权相关的问题,并观察它使用可用的工具。目前,我们提供以下读取工具:
- 获取你的策略
- 获取所有事实
- 运行
authorize查询 - 通过模式匹配查询你的事实
- 运行策略测试
我们还提供以下写入工具,仅限用于本地开发服务器:
- 更新你的策略
- 添加事实
- 删除事实
- 清除所有数据
尝试发送以下任意消息:
- 为我的授权策略绘制一张 mermaid 图
<actor>对<resource>拥有哪些权限?- 例如:“Alice 对 Project XYZ 拥有哪些权限?”
- 为什么
<actor>没有权限对<action><resource>执行操作?
反馈
我们正在积极改进开发者体验,非常欢迎你对 Oso MCP Server 以及 Oso Cloud 更广泛的开发体验提出任何反馈。请随时在 Slack 上联系我们!
本文档构建并托管于 Mintlify,一个开发者文档平台。