Oso Cloud MCP Server
ทางการทำความเข้าใจ พัฒนา และแก้ไขนโยบายการอนุญาตใน Oso Cloud
คุณทำอะไรได้บ้างด้วย Oso Cloud MCP?
- ตรวจสอบนโยบายของคุณ — ขอให้ผู้ช่วยดึงนโยบายการอนุญาตปัจจุบันของคุณเพื่อให้คุณตรวจสอบโครงสร้างของนโยบายได้
- ตรวจสอบข้อเท็จจริงที่จัดเก็บไว้ — ให้ผู้ช่วยแสดงรายการข้อเท็จจริงทั้งหมดในข้อมูล Oso Cloud ของคุณเพื่อดูว่ามีความสัมพันธ์และแอตทริบิวต์ใดบ้าง
- เรียกใช้การตรวจสอบการอนุญาต — ถามว่าผู้กระทำมีสิทธิ์ที่กำหนดบนทรัพยากรหรือไม่ และรับผลการตัดสินที่ได้
- สืบค้นข้อเท็จจริงตามรูปแบบ — ขอให้ผู้ช่วยค้นหาข้อเท็จจริงของคุณโดยใช้การจับคู่รูปแบบเพื่อค้นหาความสัมพันธ์ที่เฉพาะเจาะจง
- แก้ไขการตัดสินที่ไม่คาดคิด — ถามว่าทำไมผู้กระทำจึงไม่มีสิทธิ์สำหรับการกระทำบนทรัพยากรเพื่อติดตามสาเหตุ
- เรียกใช้การทดสอบนโยบาย — ให้ผู้ช่วยดำเนินการทดสอบนโยบายของคุณเพื่อตรวจสอบพฤติกรรมเทียบกับความคาดหวัง
- แก้ไขนโยบายและข้อมูลบนเซิร์ฟเวอร์สำหรับพัฒนา — อัปเดตนโยบาย เพิ่มหรือลบข้อเท็จจริง หรือล้างข้อมูลเมื่อเชื่อมต่อกับเซิร์ฟเวอร์สำหรับพัฒนาในเครื่อง
เอกสาร
Oso MCP Server
เชื่อมต่อการตั้งค่า LLM ภายในเครื่องของคุณกับ Oso Cloud APIs ผ่าน MCP server ของเรา
ใช้ MCP Server เพื่อ:
- ทำความเข้าใจนโยบาย (policy) ของคุณได้ดียิ่งขึ้น
- ใช้ภาษาธรรมชาติในการถามคำถามที่เกี่ยวข้องกับการอนุญาต (authorization)
- แก้ไขข้อบกพร่องว่าทำไมการตัดสินใจอนุญาตจึงไม่ตรงกับที่คุณคาดหวัง
[!WARNING]
คู่มือนี้ถือว่าคุณได้ติดตั้งและตั้งค่า CLI เรียบร้อยแล้ว
เชื่อมต่อ
Claude Desktop (DXT)
ยังไม่ได้ติดตั้ง CLI หรือไม่ต้องการเพิ่มการกำหนดค่าด้วยตนเอง? ไม่ต้องกังวล - ดาวน์โหลดไฟล์ DXT ด้านล่างแล้วดับเบิลคลิกเพื่อติดตั้ง Oso MCP Server ลงใน Claude Desktop หรือไคลเอนต์ AI อื่นๆ ที่รองรับ DXTs โดยอัตโนมัติ
curl -O https://d2nl1ljmg8n1q8.cloudfront.net/latest/oso-cloud-mcp.dxt
ตรวจสอบ SHA256 checksum:
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
ด้วยตนเอง
ในไคลเอนต์ LLM ที่คุณเลือก ให้เพิ่มสิ่งต่อไปนี้ลงในไฟล์กำหนดค่า MCP ของคุณเพื่อรันกับ local dev server:
{
"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หากคุณต้องการรันกับ live production server - โทเค็น
OSO_AUTHที่ให้มานั้นสำหรับ local dev server คุณสามารถรับโทเค็นOSO_AUTHสำหรับ live server ของคุณได้จาก Oso Cloud UI
ฉันจะหาไฟล์กำหนดค่า MCP ของฉันได้ที่ไหน?
นี่คือคู่มือสำหรับไคลเอนต์ที่พบบ่อย:
การใช้งาน
[!WARNING]
เซิร์ฟเวอร์นี้มีจุดประสงค์หลักเพื่อใช้กับ dev server เพื่อช่วยในการพัฒนา โปรดใช้ความระมัดระวังเป็นพิเศษเมื่อใช้กับสภาพแวดล้อมจริง (live environment)
เมื่อ MCP server ของคุณทำงานแล้ว คุณสามารถถามคำถามที่เกี่ยวข้องกับการอนุญาตใดๆ กับ LLM ของคุณและดูมันใช้เครื่องมือที่มีอยู่ ปัจจุบันเราเปิดเผยเครื่องมือสำหรับอ่านเพื่อ:
- รับนโยบาย (policy) ของคุณ
- รับข้อเท็จจริง (facts) ทั้งหมด
- รันคิวรี
authorize - คิวรีข้อเท็จจริงของคุณด้วยการจับคู่รูปแบบ (pattern matching)
- รันการทดสอบนโยบาย (policy tests)
เรายังเปิดเผยเครื่องมือสำหรับเขียนต่อไปนี้ ซึ่งจำกัดให้ใช้ได้เฉพาะกับ local dev server เท่านั้น:
- อัปเดตนโยบาย (policy) ของคุณ
- เพิ่มข้อเท็จจริง (facts)
- ลบข้อเท็จจริง (facts)
- ล้างข้อมูลทั้งหมด
ลองส่งข้อความใดข้อความหนึ่งต่อไปนี้:
- วาดไดอะแกรม mermaid ของนโยบายการอนุญาตของฉัน
<actor>มีสิทธิ์อะไรบน<resource>?- เช่น "Alice มีสิทธิ์อะไรบน Project XYZ?"
- ทำไม
<actor>จึงไม่มีสิทธิ์<action><resource>?
ข้อเสนอแนะ
เรากำลังพัฒนาและปรับปรุงประสบการณ์สำหรับนักพัฒนาอย่างต่อเนื่อง และยินดีรับข้อเสนอแนะทั้งหมดเกี่ยวกับ Oso MCP Server และประสบการณ์การพัฒนากับ Oso Cloud โดยรวม โปรดอย่าลังเลที่จะติดต่อเราผ่าน Slack!
เอกสารนี้สร้างและโฮสต์บน Mintlify ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา