Oso Cloud MCP Server

Server MCP Oso

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

Gunakan Server MCP untuk:

• mengembangkan pemahaman yang lebih baik tentang kebijakan Anda
• menggunakan bahasa alami untuk mengajukan pertanyaan terkait otorisasi
• men-debug mengapa keputusan otorisasi tidak sesuai dengan yang Anda harapkan

Panduan ini mengasumsikan Anda telah menginstal dan menyiapkan CLI.

Hubungkan

Claude Desktop (DXT)

Belum menginstal CLI atau tidak ingin menambahkan konfigurasi secara manual? Jangan khawatir - unduh file DXT berikut dan klik dua kali untuk menginstal Server MCP Oso 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 yang berikut ini ke file konfigurasi MCP Anda 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 secara opsional menghilangkan variabel lingkungan OSO_URL atau mengaturnya ke https://cloud.osohq.com jika Anda ingin menjalankannya terhadap server produksi langsung.
• Token OSO_AUTH yang disediakan adalah untuk server dev lokal. Anda dapat memperoleh token OSO_AUTH server langsung Anda dari UI Oso Cloud.

Di mana saya dapat menemukan file konfigurasi MCP saya?

Berikut adalah panduan untuk beberapa klien umum:

• Claude Desktop
• Cursor
• VS Code Copilot
• Kiro

Penggunaan

Server ini terutama ditujukan untuk digunakan dengan server dev untuk membantu pengembangan. Harap berhati-hati saat menggunakannya terhadap lingkungan langsung.

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

• Mendapatkan kebijakan Anda
• Mendapatkan semua fakta
• Menjalankan kueri authorize
• Menanyakan fakta Anda dengan pencocokan pola
• Menjalankan tes kebijakan

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

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

Coba kirim salah satu pesan berikut:

• Gambarkan diagram mermaid dari kebijakan otorisasi saya
• Izin apa yang dimiliki <actor> pada <resource>?
  • mis. "Izin apa yang dimiliki Alice pada Proyek XYZ?"
• Mengapa <actor> tidak memiliki izin untuk <action> <resource>?

Umpan Balik

Kami secara aktif mengiterasi pengalaman pengembang dan akan menghargai semua umpan balik tentang Server MCP Oso dan pengalaman pengembangan yang lebih luas dengan Oso Cloud. Jangan ragu untuk menghubungi kami di Slack!