Oso Cloud MCP Server

resmi

Oso Cloud'da yetkilendirme politikalarını anlayın, geliştirin ve hata ayıklayın.

osohq.com üzerinde görüntüle

Oso Cloud MCP ile neler yapabilirsiniz?

  • Yetkilendirme politikanızı alın — Mevcut politikayı almak ve kurallarını incelemek veya diyagramını çıkarmak için get_policy kullanın.
  • Belirli bir izni kontrol edin — Bir aktörün bir kaynak üzerinde bir eylem gerçekleştirip gerçekleştiremeyeceğini authorize ile sorgulayın.
  • Tüm olguları inceleyin — Oso Cloud ortamınızda depolanan her olguyu get_facts ile listeleyin.
  • Olguları desene göre sorgulayın — Belirli bir aktör, kaynak veya ilişkiyle eşleşen olguları olgu sorgulama araçlarını kullanarak bulun.
  • Politika testlerini çalıştırın — Politika davranışını doğrulamak için mevcut test paketinizi run_tests ile yürütün.
  • Yerel geliştirme verilerini değiştirin — Yerel bir geliştirme sunucusunda politikayı güncelleyin, olgu ekleyin, olgu silin veya tüm verileri temizleyin.

Dokümantasyon

Oso MCP Sunucusu

Yerel LLM kurulumunuzu MCP sunucumuz aracılığıyla Oso Cloud API'leri ile entegre edin.

MCP Sunucusunu şu amaçlarla kullanın:

  • politikanızı daha iyi anlamak
  • yetkilendirme ile ilgili soruları doğal dilde sormak
  • bir yetkilendirme kararının neden beklediğinizle eşleşmediğini hata ayıklamak

Bu kılavuz, CLI'yi zaten yüklediğinizi ve kurduğunuzu varsayar.

Bağlan

Claude Desktop (DXT)

CLI yüklü değil mi veya yapılandırmayı manuel olarak eklemek istemiyor musunuz? Endişelenmeyin - aşağıdaki DXT dosyasını indirin ve Oso MCP Sunucusunu Claude Desktop veya DXTs kabul eden diğer AI istemcilerine otomatik olarak yüklemek için çift tıklayın.

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

SHA256 sağlama toplamını doğrulayın:

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

Ayrıca DXT sürümünü de belirtebilirsiniz:

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

Not: <0.33.0 DXT sürümü yoktur

Aşağıdaki kurulum yöntemleri, CLI'yi (sürüm >=0.33.0) zaten yüklediğinizi ve kurduğunuzu varsayar.

Cursor

Install MCP Server

Manuel

Seçtiğiniz LLM istemcisinde, yerel geliştirme sunucusuna karşı çalıştırmak için MCP yapılandırma dosyanıza aşağıdakini ekleyin:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • İsteğe bağlı olarak OSO_URL ortam değişkenini atlayabilir veya canlı bir üretim sunucusuna karşı çalıştırmak istiyorsanız https://cloud.osohq.com olarak ayarlayabilirsiniz.
  • Sağlanan OSO_AUTH belirteci yerel geliştirme sunucusu içindir. Canlı sunucu OSO_AUTH belirtecinizi Oso Cloud UI'den alabilirsiniz.

MCP yapılandırma dosyamı nerede bulabilirim?

Bazı yaygın istemciler için kılavuzlar şunlardır:

Kullanım

Bu sunucu öncelikle geliştirmeye yardımcı olmak için geliştirme sunucularıyla kullanılmak üzere tasarlanmıştır. Canlı bir ortama karşı kullanırken lütfen ekstra dikkatli olun.

MCP sunucunuz çalışır duruma geldiğinde, LLM'nize yetkilendirme ile ilgili herhangi bir soru sorabilir ve mevcut araçları nasıl kullandığını izleyebilirsiniz. Şu anda, aşağıdakiler için okuma araçları sunuyoruz:

  • Politikanızı alın
  • Tüm olguları alın
  • Bir authorize sorgusu çalıştırın
  • Desen eşleştirme ile olgularınızı sorgulayın
  • Politika testlerini çalıştırın

Ayrıca, yalnızca yerel geliştirme sunucularıyla kullanılmak üzere kısıtlanmış aşağıdaki yazma araçlarını da sunuyoruz:

  • Politikanızı güncelleyin
  • Olgu ekleyin
  • Olguları silin
  • Tüm verileri temizleyin

Aşağıdaki mesajlardan herhangi birini göndermeyi deneyin:

  • Yetkilendirme politikamın bir mermaid diyagramını çiz
  • <actor> kullanıcısının <resource> üzerinde hangi izinleri var?
    • örn. "Alice'in Project XYZ üzerinde hangi izinleri var?"
  • <actor> neden <action> <resource> iznine sahip değil?

Geri Bildirim

Geliştirici deneyimi üzerinde aktif olarak çalışıyoruz ve Oso MCP Sunucusu ve Oso Cloud ile daha geniş geliştirme deneyimi hakkındaki tüm geri bildirimlerinizi takdir ediyoruz. Lütfen Slack üzerinden bize ulaşmaktan çekinmeyin!