СэхэгэSOCIAL MCP GATEWAY
Зааварэхлэх заавар
НИЙТИЙН ЗААВАР

MCP client-аа холбох

Холболтын протокол, гарцын хаяг, нэвтрэлт, шаардлагатай хамгийн бага эрх болон хуулж ашиглах тохиргоо.

ТОХИРГООНЫ ТУСЛАХ

Таны холболтын тохиргоо

Гарцын хаяг болон эхлэх эрхүүдээ сонгоно. Бодит түлхүүрийг MCP эрх хэсэгт үүсгэнэ.

Зөвхөн холболтын мэдээлэл бэлтгэнэ. Энэ туслах сүлжээний хүсэлт илгээхгүй, таны token-ийг авахгүй.

CLIENT-ДАА НЭМЭХ
Transport: Streamable HTTP
Endpoint: https://staging.api.sehege.com/gateway/mcp
Authorization: Bearer YOUR_MCP_TOKEN

Credential scopes: connections:read, usage:read, docs:read

Streamable HTTP ашиглах

Гарцын хаяг: production-д https://api.sehege.com/gateway/mcp, staging-д https://staging.api.sehege.com/gateway/mcp (дотоод хөгжүүлэлт: http://localhost:8100/mcp). Алсын client нийтэд хандах боломжтой HTTPS хаягийг ашиглана; localhost нь үргэлж client ажиллаж буй төхөөрөмжийг заана.

Нэвтрэх хоёр арга бий, аль нь тохирох нь client-ээс хамаарна: client-ээс шууд нэвтрэх (OAuth) эсвэл Сэхэгийн MCP түлхүүрийг bearer header-ээр илгээх. OAuth нь нэвтэрсэн хүний орон зайн үүрэг, зөвшөөрсөн scope-оор хязгаарлагдана. Хадгалсан MCP bearer түлхүүр нь эзэмшиж буй хүний одоогийн үүргээр биш, өөрийн орон зай, scope-оор хязгаарлагдана. Аль нь ч үйлдлийг зөвшөөрөхгүй.

MCP холболтын протоколын тодорхойлолт↗

Client-ээс нэвтрэх (Grok, ChatGPT, Cursor, Claude web)

Client OAuth client ID асуувал social-mcp-mcp-client-ийг secret-гүйгээр оруулна. Сэхэгийн түлхүүрийг хэзээ ч URL эсвэл чатад бүү оруул.

  1. Client-ийн connector эсвэл MCP тохиргоонд custom/remote MCP сервер нэмээд зөвхөн гарцын хаягийг оруулна. Client ID, secret, header талбаруудыг хоосон үлдээнэ.
  2. Connect дарна. Client Сэхэгийн нэвтрэх үйлчилгээнд өөрийгөө бүртгүүлж, хөтөч дээр Сэхэгийн нэвтрэх хуудсыг нээнэ; workspace-ээ эзэмшдэг бүртгэлээрээ нэвтэрнэ.
  3. Зөвшөөрлийн дэлгэцийг шалгана: client-ийн хүссэн Сэхэгийн эрхүүд (жишээ нь docs:read, connections:read, content:read, operations:prepare) жагсаана. Зөвшөөрвөл холболт дуусна; татгалзвал client ямар ч хандалт авахгүй.
  4. Client одоо Сэхэгийн хэрэгслүүдийг жагсаана. Хандалт нь таны workspace-ийн үүрэг болон зөвшөөрсөн эрхээр хязгаарлагдах бөгөөд client-ийн connector тохиргооноос эсвэл Сэхэгийн бүртгэлийн тохиргооноос application-ийг хасаж цуцалж болно.

Түлхүүрийг bearer header-ээр ашиглах (Claude Desktop, скрипт, өөрийн agent)

Authorization header тохируулах боломжтой client-д Credentials хэсэгт үүсгэсэн Сэхэгийн MCP түлхүүрийг ашиглана. Дараах утгуудыг client-ийн алсын MCP серверийн тохиргоонд оруулна; эдгээр нь холболтын мэдээлэл бөгөөд нийтлэг JSON файл биш.

ХОЛБОЛТЫН МЭДЭЭЛЭЛ
Transport: Streamable HTTP
Endpoint: https://staging.api.sehege.com/gateway/mcp
Authorization: Bearer smcp_YOUR_MCP_TOKEN

Client болон орон зай бүрд тусдаа түлхүүр үүсгэх

MCP эрх хэсэгт шаардлагатай хамгийн бага эрх болон 30, 60 эсвэл 90 хоногийн хугацааг сонгоно. Token-оо client-ийн нууц мэдээллийн санд хадгална. Token болон хөгжүүлэгчийн аппын нууц түлхүүрийг яриа эсвэл бусадтай хуваалцдаг тохиргооны файлд бүү оруулаарай.

Түлхүүр нь үүсгэсэн ажлын орон зайдаа харьяалагдана. Хөтөч дээр орон зай солих нь өмнө үүсгэсэн MCP түлхүүрийг өөрчлөхгүй. Түлхүүрийг цуцалбал client түүнийг ашиглах боломжгүй болно; social хаягийн холболтыг салгах нь тусдаа үйлдэл юм.

Зөвхөн хэрэгтэй эрхээ сонгох

custom:read нь тохируулсан GET/HEAD API хэрэгслийг ажиллуулна. custom:write нь POST/PUT/PATCH/DELETE хүсэлтийг хүний зөвшөөрөлд бэлтгэнэ. Эдгээрийг тусад нь сонгох ба credential-ийн орон зайн идэвхтэй custom API бүрд үйлчилнэ. API нууц түлхүүрийг client-д өгөхгүй.

Холболт болон заавартай танилцахын тулд connections:read, usage:read, docs:read эрхээр эхэлнэ. Медиа оруулах, жагсаах, устгах шаардлагатай client-д л media:write нэмнэ. operations:prepare нь дэмжигдсэн үйлдэл бэлтгэх, төлөвийг унших болон жагсаах эрх олгоно. operations:execute нь зөвшөөрөгдсөн үйлдлийг дараалалд оруулах, хүлээгдэж буй үйлдлийг цуцлах эрхтэй; үйлдлийг зөвшөөрөх эрх олгохгүй.

content:read нь content.list_own, content.get_own, comments.list-ийг; analytics:read нь analytics.get_aggregate-ийг нээнэ. Дуудлага бүр холболтын боломж supported (adapter байгаа, permission олгогдсон, owner асаасан) байхыг шаардаж, зөвхөн амжилттай үед credit хасна. Сервер хэрэгслийн жагсаалтыг эрхээр шүүж, дуудлага бүрд эрхийг дахин шалгана.

Холболтоо шалгах

  1. Холбогдоод client-ийн хэрэгсэл илрүүлэх хэсгийг ашиглана.
  2. docs.list-ийг locale=mn тохиргоотой дуудна. Буцаасан slug-аар docs.get-ийг мөн locale=mn тохиргоотой дуудна.
  3. connections.list болон usage.get-ийг дуудна. Холболтын жагсаалт хоосон бол энэ орон зайд идэвхтэй холболт буцаагаагүй гэсэн үг; нэвтрэлт амжилтгүй гэсэн үг биш.
  4. Хэрэгсэл харагдахгүй байвал түлхүүрийн эрхийг шалгана. OIDC-оор нэвтэрсэн client-д хэрэглэгчийн үүргийн хязгаарлалт мөн үйлчилнэ. 401 алдаа гарвал token болон хугацааг шалгана; 403 нь түлхүүр эсвэл орон зайн эрх хүрэлцэхгүй байгааг илэрхийлж болно.