Oso Cloud MCP Server

आधिकारिक

Oso Cloud में प्राधिकरण नीतियों को समझें, विकसित करें और डीबग करें।

Oso Cloud MCP के साथ आप क्या कर सकते हैं?

  • अपनी नीति का निरीक्षण करें — सहायक से अपनी मौजूदा प्राधिकरण नीति प्राप्त करने को कहें, ताकि आप उसकी संरचना की समीक्षा कर सकें।
  • संग्रहीत तथ्यों की समीक्षा करें — सहायक से अपने Oso Cloud डेटा के सभी तथ्य सूचीबद्ध करने को कहें, ताकि आप देख सकें कि कौन-से संबंध और विशेषताएँ मौजूद हैं।
  • प्राधिकरण जाँच चलाएँ — पूछें कि क्या किसी कर्ता को किसी संसाधन पर कोई विशिष्ट अनुमति है, और निर्णय का परिणाम प्राप्त करें।
  • पैटर्न के आधार पर तथ्य खोजें — विशिष्ट संबंध खोजने के लिए सहायक से पैटर्न मिलान का उपयोग करके अपने तथ्यों में खोज करने को कहें।
  • अनपेक्षित निर्णयों की जाँच करें — कारण जानने के लिए पूछें कि किसी कर्ता को किसी संसाधन पर कोई कार्रवाई करने की अनुमति क्यों नहीं है।
  • नीति परीक्षण चलाएँ — अपेक्षित व्यवहार की जाँच करने के लिए सहायक से अपने नीति परीक्षण चलाने को कहें।
  • डेव सर्वर पर नीति और डेटा संपादित करें — स्थानीय डेव सर्वर से कनेक्ट होने पर नीति अपडेट करें, तथ्य जोड़ें या हटाएँ, अथवा डेटा साफ़ करें।

दस्तावेज़

Oso MCP Server

हमारे MCP सर्वर के ज़रिए अपने स्थानीय LLM सेटअप को Oso Cloud APIs के साथ एकीकृत करें।

MCP Server का उपयोग करें:

  • अपनी नीति को बेहतर ढंग से समझने के लिए
  • प्राधिकरण से जुड़े सवाल प्राकृतिक भाषा में पूछने के लिए
  • यह पता लगाने के लिए कि प्राधिकरण का कोई निर्णय आपकी अपेक्षा से मेल क्यों नहीं खाता

[!WARNING]

इस गाइड में माना गया है कि आपने CLI पहले ही इंस्टॉल और सेट अप कर लिया है।

कनेक्ट करें

Claude Desktop (DXT)

क्या आपने CLI इंस्टॉल नहीं किया है या कॉन्फ़िगरेशन को मैन्युअल रूप से जोड़ना नहीं चाहते? कोई बात नहीं—नीचे दी गई DXT फ़ाइल डाउनलोड करें और Oso MCP Server को Claude Desktop या DXTs स्वीकार करने वाले अन्य AI क्लाइंट में अपने-आप इंस्टॉल करने के लिए उस पर डबल-क्लिक करें।

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

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

आप DXT संस्करण भी निर्दिष्ट कर सकते हैं:

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

ध्यान दें: कोई DXT संस्करण नहीं हैं <0.33.0

इंस्टॉलेशन के निम्नलिखित तरीकों में माना गया है कि आपने CLI (संस्करण >=0.33.0) पहले ही इंस्टॉल और सेट अप कर लिया है।

Cursor

Install MCP Server

मैन्युअल

अपनी पसंद के LLM क्लाइंट में, स्थानीय dev server पर चलाने के लिए अपनी MCP कॉन्फ़िगरेशन फ़ाइल में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "oso": {
      "command": "oso-cloud",
      "args": ["experimental", "mcp"],
      "env": {
        "OSO_URL": "http://localhost:8080",
        "OSO_AUTH": "e_0123456789_12345_osotesttoken01xiIn"
      }
    }
  }
}
  • यदि आप इसे लाइव प्रोडक्शन सर्वर पर चलाना चाहते हैं, तो वैकल्पिक रूप से OSO_URL environment variable को छोड़ सकते हैं या इसे https://cloud.osohq.com पर सेट कर सकते हैं।
  • दिया गया OSO_AUTH टोकन स्थानीय dev server के लिए है। लाइव सर्वर का OSO_AUTH टोकन आप Oso Cloud UI से प्राप्त कर सकते हैं।

मेरी MCP कॉन्फ़िगरेशन फ़ाइल कहाँ मिलेगी?

यहाँ कुछ आम क्लाइंट के लिए गाइड दी गई हैं:

उपयोग

[!WARNING]

यह सर्वर मुख्य रूप से विकास में सहायता के लिए dev servers के साथ उपयोग हेतु बनाया गया है। लाइव वातावरण में इसका उपयोग करते समय अतिरिक्त सावधानी बरतें।

MCP server चालू होने के बाद, आप अपने LLM से प्राधिकरण से जुड़े कोई भी सवाल पूछ सकते हैं और देख सकते हैं कि वह उपलब्ध टूल का उपयोग कैसे करता है। फ़िलहाल, हम ये रीड टूल उपलब्ध कराते हैं:

  • अपनी नीति प्राप्त करें
  • सभी facts प्राप्त करें
  • authorize क्वेरी चलाएँ
  • पैटर्न मिलान के साथ अपने facts की क्वेरी करें
  • नीति परीक्षण चलाएँ

हम निम्नलिखित राइट टूल भी उपलब्ध कराते हैं, जिनका उपयोग केवल स्थानीय dev servers तक सीमित है:

  • अपनी नीति अपडेट करें
  • facts जोड़ें
  • facts हटाएँ
  • सभी डेटा साफ़ करें

इनमें से कोई भी संदेश भेजकर देखें:

  • मेरी प्राधिकरण नीति का mermaid आरेख बनाएँ
  • <actor> के पास <resource> पर कौन-सी अनुमतियाँ हैं?
    • उदाहरण: "Alice के पास Project XYZ पर कौन-सी अनुमतियाँ हैं?"
  • <actor> को <action> <resource> की अनुमति क्यों नहीं है?

प्रतिक्रिया

हम डेवलपर अनुभव को बेहतर बनाने के लिए लगातार काम कर रहे हैं। Oso MCP Server और Oso Cloud के साथ विकास के व्यापक अनुभव पर आपकी प्रतिक्रिया का हम स्वागत करेंगे। कृपया Slack पर संपर्क करने में संकोच न करें!

यह दस्तावेज़ डेवलपर दस्तावेज़ीकरण प्लेटफ़ॉर्म Mintlify पर बनाया और होस्ट किया गया है।