MCP چیست؟

در API روشا: /mcp

MCP کوتاه‌شدهٔ Model Context Protocol است. این پروتکل را شرکت Anthropic در سال ۲۰۲۴ به‌صورت باز منتشر کرد و امروز کلاینت‌های بسیاری از آن پشتیبانی می‌کنند، از جمله Claude، Cursor و ابزارهای OpenAI و Google.

چطور کار می‌کند؟

سرور MCP فهرستی از «ابزار» با نام، توضیح و ورودی اعلام می‌کند. مدل هنگام پاسخ تصمیم می‌گیرد کدام ابزار را صدا بزند. کلاینت درخواست را به سرور می‌فرستد و نتیجه را به مدل برمی‌گرداند.

چرا برای دادهٔ بازار مهم است؟

مدل زبانی دادهٔ روز بازار را نمی‌داند و اگر بدون ابزار دربارهٔ قیمت بپرسید، ممکن است عدد بسازد. با MCP، عدد از منبع داده می‌آید و شما می‌بینید کدام ابزار صدا زده شده است. لازم هم نیست برای هر پرسش کد بنویسید.

سرور MCP روشا

نشانی سرور https://poolick.ir/mcp است، با انتقال streamable HTTP و همان کلید API در سرآیند Authorization. راه‌اندازی در Claude Code:

claude mcp add --transport http rosha https://poolick.ir/mcp \
  --header "Authorization: Bearer $ROSHA_KEY"

سرور ۱۲ ابزار دارد، از جمله search_instruments، get_daily_history، get_client_type_history، get_index_history و get_fund_history. این ابزارها همان دادهٔ REST API را می‌دهند.

چه چیزهایی را باید بدانم؟

• پلن. پلن شما باید خانوادهٔ mcp را داشته باشد. پلن رایگان آن را دارد.
• مصرف. هر درخواست HTTP به /mcp یک درخواست از سقف کلید کم می‌کند و یک گفت‌وگو چند درخواست می‌فرستد.
• اندازهٔ پاسخ. هر ابزار حداکثر ۵۰۰ ردیف برمی‌گرداند تا در حافظهٔ مدل جا شود. برای برداشت انبوه، REST API را به کار ببرید.
• پوشش. برای ریز معاملات و مقادیر زیرصندوق‌ها ابزار MCP وجود ندارد.
• OAuth. سرور تا آبان ۱۴۰۵ فقط کلید در سرآیند را می‌پذیرد و OAuth ندارد.

پاسخ دستیار توصیهٔ سرمایه‌گذاری نیست؛ روشا فقط داده را می‌رساند. تنظیم هر کلاینت در راه‌اندازی در هر دستیار، فهرست ابزارها در مرجع ابزارها و راهنمای گام‌به‌گام در اتصال Claude، ChatGPT و Gemini به بورس تهران است.