Oso Cloud MCP Server

आधिकारिक

Understand, develop, and debug authorization policies in Oso Cloud.

osohq.com पर देखें

दस्तावेज़

Oso MCP सर्वर

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

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

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

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

कनेक्ट करें

Claude Desktop (DXT)

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

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 पर संपर्क करने में संकोच न करें!