سێرڤەری MCP

پەیوەستبوون چی بۆ یاریدەدەرەکەت دەکڕێت

یاریدەدەرێک کە ژماردن بە بۆچوون دەکات، ڕێک ئەوەندە جار هەڵەیە کە گرنگ بێت. کە لێرە پەیوەست بکرێت، بیرکارییەکە دەداتە بزوێنەرێکی ڕاستەقینە و وەڵامێکی ژماردراو دەگەڕێنێتەوە لە جیاتی وەڵامێکی گونجاو — چڕکردنەوە و لکاندن، هاوکێشە جیاکارییەکان، ئەلجەبرا، ئامار، وێنەکێشان.

پەیوەندییەکە پێش ئەوەی هیچ ژماردنێک خەرج بکرێت ڕاستی دەربارەی خۆی بە بریکارەکەت دەڵێت: check_support وەڵام دەداتەوە ئایا فەنکشنێک هەیە، get_capabilities ئەو سنوورانە ڕادەگەیەنێت کە بەڕاستی کاردەکەن، و plan_computation ئامانجێک دەگۆڕێت بۆ ڕێگایەکی کارا لەگەڵ ڕەچەتەی پشکنراوی هاوپێچ. بریکارێک بەردەوام دەبێت لە بانگکردنی ئامرازێک کە پێشوەخت دەڵێت چی ناتوانێت بیکات.

لەسەر هەموو پلانێک کراوەیە، بە بێبەرامبەرەکەشەوە، و هەموو پەیوەندییەکە یەک URL ە. ئەوەی پلانێکی پارەدراو دەیکڕێت بودجەی ژماردن و ڕێژەیە — هەرگیز دەستپێگەیشتن نییە.

تۆکنێک دروست بکە   چوونەژوورەوە

خاڵەکانی کۆتایی

گواستنەوەکە بێدۆخە: هیچ ناسنامەیەکی دانیشتنی پرۆتۆکۆل دەرناکات، بۆیە GET و DELETE لەسەر /mcp بە 405 وەڵام دەداتەوە، بە ئەنقەست. ئەمە جیاوازە لەو session_id ی ئارەزوومەندانەی کە ئامرازە هەڵسەنگێنەرەکان وەریدەگرن — بڕوانە ئامرازەکان — کە بەڵگەیەکی ئامرازە خۆت هەڵیدەبژێریت، نەک شتێک کە گواستنەوەکە بیدات.

دوو ڕێگە بۆ چوونەژوورەوە

زۆربەی کڵایەنتەکان ئەمەت بۆ دەکەن. کڵایەنتەکەت لە خوارەوە هەڵبژێرە و شوێن ئەو ڕێگایە بکەوە کە پیشانت دەدات — پێویستت بە هەردووکیان نییە.

OAuth داوای چی دەکات

لە پشتەوە ئەمە ڕێڕەوێکی ستانداردی OAuth 2.1 ە لەگەڵ PKCE، کە دەدۆزرێتەوە لە /.well-known/oauth-protected-resource و /.well-known/oauth-authorization-server (هەروەها لە ژێر /.well-known/openid-configurationدا وەڵام دەدرێتەوە، کە هەندێک کڵایەنت سەرەتا تاقی دەکەنەوە). کڵایەنتێک بە سێ شێوە دەتوانێت خۆی بناسێنێت — بەڵگەنامەی مێتاداتای ناسنامەی کڵایەنت، تۆمارکردنی داینامیک، یان ناسنامە و نهێنیی کڵایەنتێک کە لە خوارەوە تۆماری دەکەیت — و ئەو کڵایەنتانەی هەر یەکێکیان پشتگیری دەکەن، خۆیان دەیدۆزنەوە.

ڕێکخستنی کڵایەنت

claude mcp add --transport http qurak https://qurak.com/mcp \
  --header "Authorization: Bearer qk_..."

{
  "mcpServers": {
    "qurak": {
      "type": "http",
      "url": "https://qurak.com/mcp",
      "headers": { "Authorization": "Bearer qk_..." }
    }
  }
}

{
  "servers": {
    "qurak": {
      "type": "http",
      "url": "https://qurak.com/mcp",
      "headers": { "Authorization": "Bearer ${input:qurak-token}" }
    }
  },
  "inputs": [
    { "id": "qurak-token", "type": "promptString",
      "description": "Qurak Bearer token", "password": true }
  ]
}

https://qurak.com/mcp

ئامرازەکان

پاراستنی دۆخ لە نێوان بانگەکاندا

evaluate و plot بێدۆخن مەگەر session_idێک بنێریت. بە یەکێکیانەوە، پێناسەکان دەگوازرێنەوە — a = 10 لە بانگێکدا، پاشان a + 5 لە بانگی دواتردا بە هەمان ناسنامە، دەبێتە 15. دانیشتنەکان تایبەتن بە هەژمارەکەت، بۆیە دوو هەژمار کە هەمان ناسنامە بەکاردەهێنن هەرگیز گۆڕاوەکانی یەکتری نابینن. دوای 30 خولەک بێکاری فڕێدەدرێن، کاتێک هەڵسەنگاندنێکی ناویان کاتی تەواو دەبێت (بزوێنەرەکە ناتوانرێت بوەستێنرێت، بۆیە دانیشتنەکەش لەگەڵی دەڕوات)، یان کاتێک بانگی clear_session.

سنوورەکان و هەڵەکان

بودجەی ژماردن و سنووری ڕێژە شوێن پلانەکەت دەکەون — بڕوانە پلانەکان، یان بانگی get_capabilities بکە لە خودی پەیوەندییەکەوە بۆ ژمارە کارپێکراوەکان. تێپەڕاندنی هەر یەکێکیان وەک ئەنجامی ئامرازێک دەگەڕێتەوە کە تێیدا isError دانراوە، نەک وەک هەڵەی گواستنەوە، بۆیە ئاژانسەکەت دەتوانێت نامەکە بخوێنێتەوە و خۆی بگونجێنێت. هەمان شت بۆ هەڵەی ڕێزمان، تەواوبوونی کات، یان شکستێک لە ناو بزوێنەرەکەدا ڕاستە: ئەوانە وەڵامن، و پەیوەندییەکە کراوە دەمێنێتەوە.

check_support پێت دەڵێت چی بەردەستە بەبێ خەرجکردنی هەڵسەنگاندنێک. timeout_ms ڕێگە بە بانگێک دەدات داوای بودجەیەکی کورتتر بکات لەوەی پلانەکە ڕێگەی پێدەدات — سوودبەخشە بۆ شکستهێنانی خێرا لەسەر دەربڕینێک کە چاوەڕێ دەکەیت هەرزان بێت. بۆ خودی بودجەی پلانەکە گیرۆدە دەکرێت، بۆیە ناتوانێت کاتی زیاتر لەوەی هەتە بکڕێت. فەنکشنەکانی فایل، پرۆسێس و تۆڕ بلۆککراون.