MCP Integration

پروتکل متن مدل (MCP) یک استاندارد باز از Anthropic است که به دستیارهای هوش مصنوعی (Claude، Cursor، Windsurf و غیره) اجازه می‌دهد به سرویس‌های خارجی متصل شوند و ابزارهای واقعی را فراخوانی کنند. Datronis یکی از توانمندترین سرورهای عمومی MCP در حوزه جست‌وجوی شغل را ارائه می‌دهد: هر هوش مصنوعی سازگار با MCP می‌تواند به‌صورت رایگان شغل‌های واقعی را جست‌وجو کند، اخبار را مرور کند، شرکت‌ها را بررسی کند و آمار زنده پلتفرم را پرسش‌گری کند — و با یک توکن دسترسی شخصی، می‌تواند فقط از طریق یک گفتگو یک رزومه کامل بسازد یا به‌روزرسانی کند، درخواست شغل ارسال کند و وضعیت درخواست‌ها را بررسی کند، همه از طرف شما و بدون نوشتن حتی یک خط کد یکپارچه‌سازی.

سرور MCP یک نقطه پایانی HTTP واحد است. هر سه متد HTTP توسط این پروتکل استفاده می‌شوند:

https://api.datronis.com/api/mcp

موارد زیر را به فایل پیکربندی Claude Desktop خود اضافه کنید. در macOS این فایل در مسیر ~/Library/Application Support/Claude/claude_desktop_config.json قرار دارد.

{
  "mcpServers": {
    "datronis": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.datronis.com/api/mcp"
      ]
    }
  }
}

این ویرایشگرها به‌صورت بومی از سرورهای MCP مبتنی بر HTTP پشتیبانی می‌کنند. آدرس سرور را در پنل تنظیمات MCP ویرایشگر خود وارد کنید:

{
  "mcpServers": {
    "datronis": {
      "url": "https://api.datronis.com/api/mcp",
      "type": "http"
    }
  }
}

شش ابزار اول در زیر عمومی هستند (نیازی به کلید API نیست) — هوش مصنوعی می‌تواند بر اساس درخواست شما به‌طور خودکار آن‌ها را فراخوانی کند. پنج ابزار باقی‌مانده به یک توکن دسترسی شخصی نیاز دارند (بخش بعدی را ببینید) زیرا روی حساب شما عمل می‌کنند: ارسال درخواست‌ها، خواندن رزومه‌های شما، بررسی تاریخچه درخواست‌هایتان، و پیش‌نویس یا ویرایش مقالات خبری.

یازده ابزار به هر کلاینت MCP (Claude، ChatGPT، Gemini، Cursor و…) اجازه می‌دهند دقیقاً مانند اپلیکیشن وب با فلش‌کارت‌های Memo شما کار کنند — همان بررسی‌های مالکیت، تشخیص تکراری، برنامه تکرار زمان‌بندی‌شده و تقویم فعالیت. این ابزارها به یک توکن دسترسی شخصی با دامنه memo نیاز دارند (که در پیکربندی استاندارد گنجانده شده است). برای ابزارهای خواندنی timezone را ارسال کنید (مثلاً Europe/Berlin) تا «امروز سررسید» دقیقاً *امروز* شما باشد.

انتشار اخبار از طریق MCP از یک روند ثابت و غیرقابل دور زدن پیروی می‌کند: پیش‌نویس به انگلیسی، طبقه‌بندی، و تنها پس از آن تصمیم‌گیری درباره انتشار یا زبان‌های دیگری که باید در آن‌ها منتشر شود.

• مرحله ۱ — پیش‌نویس انگلیسی — draft_news همیشه ابتدا نسخه انگلیسی مقاله را ایجاد می‌کند، صرف‌نظر از اینکه در نهایت می‌خواهید در چه زبان‌هایی منتشر شود. طبقه‌بندی و هرگونه بازبینی هر دو بر اساس این نسخه انگلیسی به‌عنوان منبع اصلی انجام می‌شوند.
• مرحله ۲ — طبقه‌بندی خودکار — یک طبقه‌بند ایمنی هوش مصنوعی مقاله را می‌خواند و یا «green» (بدون‌جنجال — علم، فناوری، تجارت، ورزش، سرگرمی، فرهنگ، سلامت، سبک زندگی) یا «flagged» (سیاست حزبی، انتخابات، جنگ یا درگیری، خشونت گرافیکی، سخن نفرت‌پراکنانه، اطلاعات نادرست، یا هر موضوعی که احتمالاً برای مخاطب عام جنجالی یا اختلاف‌برانگیز به نظر برسد) را برمی‌گرداند.
• اگر green باشد — مقاله فوراً به انگلیسی منتشر می‌شود و همچنین به هر زبانی که در target_locales فهرست کرده‌اید ترجمه و منتشر می‌شود.
• اگر flagged باشد — مقاله ایجاد می‌شود اما منتشرنشده باقی می‌ماند. فراخوانی ابزار دلیل طبقه‌بند را برمی‌گرداند. هیچ چیزی که بتوانید به draft_news ارسال کنید آن را از اینجا مجبور به انتشار نمی‌کند — هیچ پرچم نادیده‌گیری‌ای وجود ندارد.
• مرحله ۳ — بازبینی و ارسال مجدد (اختیاری) — resubmit_news را با همان news_id و عنوان/متن بازبینی‌شده فراخوانی کنید. این کار یک طبقه‌بندی کاملاً جدید روی بازبینی انجام می‌دهد و به‌عنوان تلاشی مستقل از نسخه اصلی ثبت می‌شود. اگر بازبینی اکنون green باشد، منتشر می‌شود؛ اگر همچنان flagged باشد، منتشرنشده باقی می‌ماند و می‌تواند دوباره ارسال شود.
• مالکیت — فقط حسابی که api_key آن ابتدا draft_news را برای یک مقاله خاص فراخوانی کرده می‌تواند resubmit_news را روی آن فراخوانی کند. یک api_key متفاوت (حتی معتبر) رد می‌شود.
• زبان‌ها اختیاری هستند — حذف target_locales فقط به انگلیسی منتشر می‌شود. کدهای زبان دو حرفی مورد نظر خود را ارسال کنید (مثلاً ["de", "ru"]) تا در همان فراخوانی به آن زبان‌ها نیز ترجمه و منتشر شود.
• نویسندگی منعطف — content_format را روی markdown بگذارید برای سرتیتر، جدول، فهرست، لینک، تصویر و بلوک‌های کد، یا روی html برای HTML غنی، کلاس‌ها و CSS درون‌خطی. Markdown پیش از ذخیره‌سازی، ترجمه و نمایه‌سازی در سمت بک‌اند به HTML پایدار تبدیل می‌شود.

apply_to_job، list_my_resumes، create_resume، update_resume، get_my_applications، draft_news، resubmit_news، submit_news_translation، یازده ابزار فلش‌کارت *_memo_* و تمام ابزارهای admin_* روی حساب Datronis شما عمل می‌کنند، بنابراین باید بدانند شما چه کسی هستید. یک توکن دسترسی شخصی از تنظیمات حساب خود ایجاد کنید، سپس آن را یا به‌صورت هدر HTTP Authorization: Bearer (ترجیحی) یا به‌عنوان آرگومان api_key در فراخوانی ابزار ارسال کنید.

• گام ۱ — در حالی که وارد شده‌اید به /app/api-keys/ بروید و روی «کلید جدید» کلیک کنید.
• گام ۲ — کلید تولیدشده (که با dtk_ شروع می‌شود) را کپی کنید — فقط یک‌بار نشان داده می‌شود.
• گام ۳ (ترجیحی) — کلاینت MCP خود را طوری پیکربندی کنید که در هر درخواست Authorization: Bearer dtk_... را به‌عنوان هدر HTTP ارسال کند.
• گام ۳ (جایگزین) — اگر کلاینت شما نمی‌تواند هدرهای دلخواه تنظیم کند، آن را به‌جای آن به‌عنوان api_key در درخواست یا فراخوانی ابزار ارسال کنید، مثلاً «با استفاده از api_key dtk_... برای شغل X درخواست بده».
• لغو — هر زمان می‌توانید از همان صفحه یک کلید را لغو کنید؛ بدون توجه به اینکه با چه روشی ارسال شده، بلافاصله از کار می‌افتد.

سرور MCP همچنین یک منبع قابل‌خواندن ارائه می‌دهد — مستندات نمای کلی پلتفرم — که دستیارهای هوش مصنوعی می‌توانند پیش از فراخوانی ابزارها آن را بخوانند تا پلتفرم را درک کنند:

platform://docs/overview

سرور از ترابرد HTTP قابل پخش جاری استفاده می‌کند (مشخصات MCP ۲۰۲۵-۰۳-۲۶):

• گام ۱ — کلاینت POST /api/mcp را همراه با یک پیام initialize ارسال می‌کند (بدون هدر شناسه نشست). هر درخواست، از جمله همین اولین درخواست، باید Accept: application/json, text/event-stream را ارسال کند — سرور هر چیز دیگری را با 406 Not Acceptable رد می‌کند.
• گام ۲ — سرور یک نشست می‌سازد و هدر Mcp-Session-Id را برمی‌گرداند.
• گام ۳ — کلاینت یک پیام notifications/initialized (همراه با هدر Mcp-Session-Id) ارسال می‌کند تا تبادل دست را تأیید کند — گام بعدی صحیح طبق مشخصات، که کلاینت‌های خوش‌رفتار MCP آن را انتظار دارند، حتی اگر این سرور در حال حاضر آن را الزامی نکند.
• گام ۴ — تمام فراخوانی‌های ابزار بعدی هدر Mcp-Session-Id را شامل می‌شوند.
• گام ۵ — کلاینت می‌تواند یک جریان SSE با GET /api/mcp برای اعلان‌هایی که سرور آغاز می‌کند باز کند.
• گام ۶ — کلاینت پس از پایان کار، DELETE /api/mcp را ارسال می‌کند تا نشست را ببندد.
• انقضای خودکار — نشست‌ها پس از ۳۰ دقیقه بی‌فعالیتی به‌طور خودکار منقضی می‌شوند.

# Step 1: Initialize a session
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -D - \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# Note the Mcp-Session-Id in the response headers, then:

# Step 2: Confirm initialization (expected: 202 Accepted, empty body)
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# Step 3: List available tools
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Step 4: Call search_jobs
curl -X POST https://api.datronis.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <your-session-id>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":3,"params":{"name":"search_jobs","arguments":{"q":"React","remote_type":"REMOTE","limit":5}}}'

پارامتر locale در get_news و get_categories عددی از ۱ تا ۲۴ را می‌پذیرد. draft_news/resubmit_news در عوض از کدهای دو حرفی (مانند «de»، «ru») در target_locales استفاده می‌کنند — همان کدهایی که در این جدول نشان داده شده‌اند.

پس از اتصال، این درخواست‌های زبان طبیعی را در هر هوش مصنوعی آگاه از MCP آزمایش کنید:

• «شغل‌های توسعه‌دهنده ارشد ریکت دورکار را در اروپا پیدا کن»
• «آخرین مقالات خبری تکنولوژی به انگلیسی چه هستند؟»
• «شرکت‌های فین‌تک فعال در استخدام در لندن را جست‌وجو کن»
• «چند شغل و شرکت در پلتفرم وجود دارد؟»
• «جزئیات شغل با اسلاگ 'senior-frontend-engineer-acme-corp' را بگیر»
• «تمام دسته‌بندی‌های خبری موجود را فهرست کن»
• «با استفاده از حساب Datronis من (api_key dtk_...) برای شغل senior-frontend-engineer-acme-corp درخواست بده»
• «رزومه‌های من در Datronis را فهرست کن و بگو کدام‌یک پیش‌فرض من است»
• «از پیش‌زمینه من یک رزومه Datronis بساز: ۴ سال مهندس بک‌اند در Acme (۲۰۲۱ تا کنون)، کارشناسی علوم کامپیوتر از TU Berlin، مهارت قوی در Go و PostgreSQL (api_key dtk_...)»
• «نقش شغلی جدیدم در Globex را از ژانویه امسال به رزومه Datronis من اضافه کن، بدون اینکه به چیز دیگری در آن دست بزنی»
• «وضعیت درخواست‌های شغلی من در Datronis را بررسی کن»
• «یک مقاله خبری در Datronis درباره [موضوع] پیش‌نویس کن و آن را به انگلیسی و آلمانی منتشر کن (api_key dtk_...)»
• «آخرین فراخوانی draft_news من flagged شد — این یک نسخه بازبینی‌شده و بی‌طرف است، آن را تحت news_id ۱۲۳ دوباره ارسال کن»
• «کدام مقالات منتشرشده در Datronis هنوز ترجمه فینیش ندارند؟»
• «news_id ۱۰۱ را به فینیش ترجمه کن و با api_key من منتشرش کن»