Oso Cloud MCP Server

公式

Oso Cloudにおける認可ポリシーの理解、開発、デバッグを行います。

osohq.com で表示

Oso Cloud MCPで何ができますか？

認可ポリシーを取得する — get_policy を使用して現在のポリシーを取得し、そのルールを確認または図示します。
特定の権限を確認する — authorize を使用して、アクターがリソースに対してアクションを実行できるかどうかを問い合わせます。
すべてのファクトを検査する — get_facts を使用して、Oso Cloud 環境に保存されているすべてのファクトを一覧表示します。
パターンでファクトをクエリする — ファクトクエリツールを使用して、特定のアクター、リソース、または関係に一致するファクトを検索します。
ポリシーテストを実行する — run_tests を使用して既存のテストスイートを実行し、ポリシーの動作を検証します。
ローカル開発データを変更する — ローカル開発サーバー上でポリシーを更新、ファクトを追加、ファクトを削除、またはすべてのデータをクリアします。

ドキュメント

Oso MCP Server

ローカルのLLMセットアップをOso Cloud APIとMCPサーバー経由で統合します。

MCPサーバーを使用して以下を実行できます:

ポリシーへの理解を深める
自然言語を使用して認可関連の質問を行う
認可の決定が期待と異なる理由をデバッグする

このガイドは、CLIが既にインストールおよびセットアップされていることを前提としています。

接続

Claude Desktop (DXT)

CLIがインストールされていない、または手動で設定を追加したくない場合でもご安心ください。以下のDXTファイルをダウンロードしてダブルクリックするだけで、Claude DesktopやDXTを受け入れる他のAIクライアントにOso MCP Serverを自動的にインストールできます。

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_AUTH トークンはローカル開発サーバー用です。本番サーバーの OSO_AUTH トークンはOso Cloud UIから取得できます。

MCP設定ファイルの場所

一般的なクライアントのガイドは以下の通りです:

使用方法

このサーバーは主に開発を支援するための開発サーバーでの使用を目的としています。本番環境に対して使用する場合は、特に注意してください。

MCPサーバーが起動して実行されたら、LLMに認可に関する質問を投げかけ、利用可能なツールを使用する様子を観察できます。現在、以下の読み取りツールを公開しています:

ポリシーの取得
全ファクトの取得
authorize クエリの実行
パターンマッチングによるファクトのクエリ
ポリシーテストの実行

また、ローカル開発サーバーでのみ使用が制限されている以下の書き込みツールも公開しています:

ポリシーの更新
ファクトの追加
ファクトの削除
全データのクリア

以下のようなメッセージを送信してみてください:

認可ポリシーのマーメイド図を描いてください
<actor> は <resource> に対してどのような権限を持っていますか？
- 例: "AliceはProject XYZに対してどのような権限を持っていますか？"
<actor> が <action> <resource> を実行する権限がないのはなぜですか？

フィードバック

私たちは開発者エクスペリエンスを積極的に改善しており、Oso MCP ServerおよびOso Cloud全体の開発エクスペリエンスに関するあらゆるフィードバックを歓迎します。Slackでお気軽にお問い合わせください！