Oso Cloud MCP Server

आधिकारिक

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

osohq.com पर देखें

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

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

दस्तावेज़

Oso MCP सर्वर

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

MCP सर्वर का उपयोग करें:

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

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

कनेक्ट करें

Claude Desktop (DXT)

क्या CLI इंस्टॉल नहीं है या मैन्युअल रूप से कॉन्फ़िगरेशन नहीं जोड़ना चाहते? कोई चिंता नहीं - निम्नलिखित DXT फ़ाइल डाउनलोड करें और Oso MCP सर्वर को 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

नोट: <0.33.0 कोई DXT संस्करण नहीं हैं

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

Cursor

Install MCP Server

मैन्युअल

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

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

मुझे अपनी MCP कॉन्फ़िग फ़ाइल कहाँ मिल सकती है?

यहाँ कुछ सामान्य क्लाइंट के लिए गाइड हैं:

उपयोग

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

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

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

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

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

निम्नलिखित में से कोई भी संदेश भेजने का प्रयास करें:

  • मेरी प्राधिकरण नीति का एक मरमेड आरेख बनाएँ
  • <actor> के पास <resource> पर क्या अनुमतियाँ हैं?
    • उदाहरण के लिए "ऐलिस के पास प्रोजेक्ट XYZ पर क्या अनुमतियाँ हैं?"
  • <actor> के पास <action> <resource> की अनुमति क्यों नहीं है?

प्रतिक्रिया

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