سرور 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. نشست‌ها خصوصیِ حساب شمایند؛ دو حساب با یک شناسهٔ یکسان هرگز متغیرهای هم را نمی‌بینند. پس از ۳۰ دقیقه بی‌کاری، وقتی ارزیابی‌ای درونشان از مهلت بگذرد (موتور را نمی‌توان قطع کرد، پس نشست هم با آن می‌رود)، یا وقتی این را فراخوانی کنید، دور ریخته می‌شوند: clear_session.

محدودیت‌ها و خطاها

بودجهٔ محاسبه و محدودیت نرخ از طرح شما پیروی می‌کنند — نگاه کنید به طرح‌ها، یا get_capabilities را از خودِ اتصال فراخوانی کنید تا اعداد جاری را بگیرید. فراتر رفتن از هر کدام به‌صورت نتیجهٔ ابزار بازمی‌گردد با isError تنظیم‌شده، نه خطای انتقال؛ پس عاملتان می‌تواند پیام را بخواند و خود را تنظیم کند. خطای نحوی، پایان مهلت یا خرابی درون موتور هم همین‌طورند: پاسخ‌اند، و اتصال باز می‌ماند.

check_support بدون خرج کردن یک ارزیابی می‌گوید چه چیزی در دسترس است. timeout_ms به یک فراخوانی اجازه می‌دهد بودجه‌ای کوتاه‌تر از طرح بخواهد — برای شکست سریع روی عبارتی که انتظار دارید ارزان باشد کارآمد است. به بودجهٔ خود طرح محدود می‌شود، پس نمی‌تواند زمانی بیش از آنچه دارید بخرد. توابع پرونده، فرایند و شبکه مسدودند.