Oso Cloud MCP Server

resmi

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

Oso Cloud MCP ile neler yapabilirsiniz?

  • Politikanızı inceleyin — Mevcut yetkilendirme politikanızın nasıl yapılandırıldığını gözden geçirebilmeniz için asistanınızdan politikayı getirmesini isteyin.
  • Saklanan olguları gözden geçirin — Asistanınızdan Oso Cloud verilerinizdeki tüm olguları listeleyerek hangi ilişkilerin ve özniteliklerin var olduğunu görmesini sağlayın.
  • Yetkilendirme kontrolleri çalıştırın — Bir aktörün bir kaynak üzerinde belirli bir izne sahip olup olmadığını sorun ve ortaya çıkan kararı alın.
  • Olguları desene göre sorgulayın — Asistanınızdan belirli ilişkileri bulmak için desen eşleştirme kullanarak olgularınızda arama yapmasını isteyin.
  • Beklenmeyen kararlarda hata ayıklayın — Nedeni izlemek için bir aktörün bir kaynak üzerindeki bir eylem için neden izne sahip olmadığını sorun.
  • Politika testlerini çalıştırın — Asistanınızdan davranışı beklentilere göre kontrol etmek için politika testlerinizi yürütmesini isteyin.
  • Geliştirme sunucularında politika ve verileri düzenleyin — Yerel bir geliştirme sunucusuna bağlıyken politikayı güncelleyin, olgu ekleyin veya silin ya da verileri temizleyin.

Dokümantasyon

Oso MCP Sunucusu

MCP sunucumuz aracılığıyla yerel LLM kurulumunuzu Oso Cloud API'leriyle entegre edin.

MCP Sunucusunu şunlar için kullanın:

  • politikanız hakkında daha iyi bir anlayış geliştirmek
  • yetkilendirmeyle ilgili soruları doğal dil kullanarak sormak
  • bir yetkilendirme kararının neden beklediğinizle eşleşmediğini hata ayıklamak

[!WARNING]

Bu kılavuz, CLI aracını zaten kurduğunuzu ve yapılandırdığınızı 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 DXT dosyalarını kabul eden diğer AI istemcilerine otomatik olarak kurmak 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

DXT sürümünü de belirtebilirsiniz:

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

Not: <0.33.0 için DXT sürümü yoktur

Aşağıdaki kurulum yöntemleri, CLI aracını (sürüm >=0.33.0) zaten kurduğunuzu ve yapılandırdığınızı varsayar.

Cursor

Install MCP Server

Manuel

Tercih ettiğiniz LLM istemcisinde, yerel bir 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 üzerinden alabilirsiniz.

MCP yapılandırma dosyamı nerede bulabilirim?

İşte bazı yaygın istemciler için kılavuzlar:

Kullanım

[!WARNING]

Bu sunucu öncelikli olarak 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 geldikten sonra, LLM'inize yetkilendirmeyle ilgili herhangi bir soru sorabilir ve mevcut araçları nasıl kullandığını izleyebilirsiniz. Şu anda şu okuma araçlarını sunuyoruz:

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

Ayrıca yalnızca yerel geliştirme sunucularıyla kullanımla sınırlandırılmış şu yazma araçlarını da sunuyoruz:

  • Politikanızı güncelle
  • Olgu ekle
  • Olgu sil
  • Tüm verileri temizle

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 ile Oso Cloud'daki daha geniş geliştirme deneyimi hakkındaki tüm geri bildirimlerinizi memnuniyetle karşılarız. Lütfen Slack üzerinden bize ulaşmaktan çekinmeyin!

Bu dokümantasyon, bir geliştirici dokümantasyon platformu olan Mintlify üzerinde oluşturulmuş ve barındırılmaktadır.