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

Install MCP Server

ด้วยตนเอง

ในไคลเอนต์ 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 ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา