Oso Cloud MCP Server

resmi

Memahami, mengembangkan, dan men-debug kebijakan otorisasi di Oso Cloud.

Apa yang bisa Anda lakukan dengan Oso Cloud MCP?

  • Periksa kebijakan Anda — Minta asisten mengambil kebijakan otorisasi Anda saat ini agar Anda dapat meninjau strukturnya.
  • Tinjau fakta yang tersimpan — Minta asisten mencantumkan semua fakta di data Oso Cloud Anda untuk melihat hubungan dan atribut yang ada.
  • Jalankan pemeriksaan otorisasi — Tanyakan apakah seorang aktor memiliki izin tertentu atas suatu sumber daya, lalu dapatkan keputusan yang dihasilkan.
  • Telusuri fakta berdasarkan pola — Minta asisten menelusuri fakta Anda menggunakan pencocokan pola untuk menemukan hubungan tertentu.
  • Debug keputusan yang tidak terduga — Tanyakan mengapa seorang aktor tidak memiliki izin untuk suatu tindakan pada sumber daya guna melacak penyebabnya.
  • Jalankan pengujian kebijakan — Minta asisten menjalankan pengujian kebijakan Anda untuk memeriksa apakah perilakunya sesuai dengan ekspektasi.
  • Edit kebijakan dan data di server dev — Perbarui kebijakan, tambahkan atau hapus fakta, atau hapus data saat terhubung ke server dev lokal.

Dokumentasi

Oso MCP Server

Integrasikan penyiapan LLM lokal Anda dengan API Oso Cloud melalui server MCP kami.

Gunakan MCP Server untuk:

  • memahami kebijakan Anda dengan lebih baik
  • mengajukan pertanyaan terkait otorisasi dalam bahasa alami
  • men-debug alasan keputusan otorisasi tidak sesuai dengan yang Anda harapkan

[!WARNING]

Panduan ini mengasumsikan Anda telah menginstal dan menyiapkan CLI.

Connect

Claude Desktop (DXT)

Belum menginstal CLI atau tidak ingin menambahkan konfigurasi secara manual? Tidak masalah — unduh file DXT berikut dan klik dua kali untuk menginstal Oso MCP Server secara otomatis ke Claude Desktop atau klien AI lain yang menerima DXT.

curl -O https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt

Verifikasi checksum 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

Anda juga dapat menentukan versi DXT:

curl -O https://d2nl1ljmg8n1q8.cloudfront.net/0.33.2/oso-cloud-mcp.dxt

Catatan: Tidak ada versi DXT <0.33.0

Metode instalasi berikut mengasumsikan Anda telah menginstal dan menyiapkan CLI (versi >=0.33.0).

Cursor

Install MCP Server

Manual

Di klien LLM pilihan Anda, tambahkan konfigurasi berikut ke file konfigurasi MCP untuk menjalankannya terhadap server dev lokal:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • Anda dapat menghilangkan variabel lingkungan OSO_URL atau mengaturnya ke https://cloud.osohq.com jika ingin menjalankannya terhadap server produksi aktif.
  • Token OSO_AUTH yang disediakan digunakan untuk server dev lokal. Anda dapat memperoleh token OSO_AUTH server aktif dari Oso Cloud UI.

Di mana saya dapat menemukan file konfigurasi MCP?

Berikut panduan untuk beberapa klien umum:

Usage

[!WARNING]

Server ini terutama ditujukan untuk digunakan dengan server dev guna membantu pengembangan. Harap berhati-hati saat menggunakannya di lingkungan aktif.

Setelah MCP server Anda berjalan, Anda dapat mengajukan pertanyaan terkait otorisasi kepada LLM dan melihatnya menggunakan alat yang tersedia. Saat ini, kami menyediakan alat baca untuk:

  • Mendapatkan kebijakan Anda
  • Mendapatkan semua fakta
  • Menjalankan kueri authorize
  • Mengkueri fakta Anda dengan pencocokan pola
  • Menjalankan pengujian kebijakan

Kami juga menyediakan alat tulis berikut, yang penggunaannya dibatasi hanya untuk server dev lokal:

  • Memperbarui kebijakan Anda
  • Menambahkan fakta
  • Menghapus fakta
  • Menghapus semua data

Coba kirim salah satu pesan berikut:

  • Buat diagram mermaid untuk kebijakan otorisasi saya
  • Izin apa yang dimiliki <actor> atas <resource>?
    • misalnya, "Izin apa yang dimiliki Alice atas Project XYZ?"
  • Mengapa <actor> tidak memiliki izin untuk <action> <resource>?

Feedback

Kami terus menyempurnakan pengalaman developer dan sangat menghargai semua masukan tentang Oso MCP Server serta pengalaman pengembangan yang lebih luas dengan Oso Cloud. Jangan ragu untuk menghubungi kami di Slack!

Dokumentasi ini dibuat dan dihosting di Mintlify, platform dokumentasi developer.