Oso Cloud MCP Server
resmiMemahami, 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
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_URLatau mengaturnya kehttps://cloud.osohq.comjika ingin menjalankannya terhadap server produksi aktif. - Token
OSO_AUTHyang disediakan digunakan untuk server dev lokal. Anda dapat memperoleh tokenOSO_AUTHserver 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.