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

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 トークンはローカル開発サーバー用です。ライブサーバー用の 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上で構築およびホストされています。