Oso Cloud MCP Server
公式Oso Cloudにおける認可ポリシーの理解、開発、デバッグを行います。
Oso Cloud MCPで何ができますか?
- ポリシーを確認する — アシスタントに現在の認可ポリシーを取得させ、その構造を確認できます。
- 保存されたファクトを確認する — アシスタントに Oso Cloud データ内のすべてのファクトを一覧表示させ、どのようなリレーションシップや属性が存在するかを確認できます。
- 認可チェックを実行する — アクターがリソースに対して特定の権限を持っているかを尋ね、その結果の判定を取得できます。
- パターンでファクトをクエリする — アシスタントにパターンマッチングを使ってファクトを検索させ、特定のリレーションシップを見つけられます。
- 予期しない判定をデバッグする — アクターがリソース上のアクションに対して権限を持たない理由を尋ね、原因を追跡できます。
- ポリシーテストを実行する — アシスタントにポリシーテストを実行させ、期待値に対する動作を確認できます。
- 開発サーバー上のポリシーとデータを編集する — ローカル開発サーバーに接続している場合、ポリシーの更新、ファクトの追加や削除、データのクリアを行えます。
ドキュメント
Oso MCP Server
MCPサーバーを通じて、ローカルの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
注: <0.33.0 のDXTバージョンはありません
以下のインストール方法は、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_AUTHトークンはローカル開発サーバー用です。ライブサーバー用のOSO_AUTHトークンはOso Cloud UIから取得できます。
MCP設定ファイルはどこにありますか?
一般的なクライアント向けのガイドを以下に示します。
使用方法
[!WARNING]
このサーバーは主に開発を支援するために開発サーバーと共に使用することを目的としています。ライブ環境に対して使用する場合は、特に注意してください。
MCPサーバーが起動して実行されると、LLMに認可に関するあらゆる質問をして、利用可能なツールを使用する様子を確認できます。現在、以下の読み取りツールを公開しています。
- ポリシーの取得
- すべてのファクトの取得
authorizeクエリの実行- パターンマッチングによるファクトのクエリ
- ポリシーテストの実行
また、ローカル開発サーバーでの使用に限定した、以下の書き込みツールも公開しています。
- ポリシーの更新
- ファクトの追加
- ファクトの削除
- すべてのデータのクリア
次のようなメッセージを送ってみてください。
- 私の認可ポリシーのmermaid図を描いて
<actor>は<resource>に対してどのような権限を持っていますか?- 例: 「AliceはProject XYZに対してどのような権限を持っていますか?」
- なぜ
<actor>は<action><resource>への権限を持っていないのですか?
フィードバック
私たちは開発者体験の改善に積極的に取り組んでおり、Oso MCP ServerおよびOso Cloudでのより広範な開発体験に関するすべてのフィードバックを歓迎します。Slackでお気軽にご連絡ください!
このドキュメントは、開発者向けドキュメントプラットフォームであるMintlify上で構築およびホストされています。