MCP چیست و چطور وصل شوم؟
MCP (Model Context Protocol) استانداردی است که دستیارهای هوش مصنوعی با آن به منابع داده وصل می‌شوند. با وصل‌کردن سرور MCP روشا، سؤال خود را به فارسی می‌پرسید و دستیار خودش نماد را پیدا می‌کند، داده را از روشا می‌گیرد و جواب را از دادهٔ واقعی می‌سازد.
مشخصات اتصال
Section titled “مشخصات اتصال”| مورد | مقدار |
|---|---|
| نشانی | https://poolick.ir/mcp |
| نوع انتقال | Streamable HTTP |
| احراز هویت | همان کلید API، در سرآیند Authorization: Bearer … یا X-API-Key |
| شرط | پلن شما باید خانوادهٔ mcp را داشته باشد |
| تعداد ابزار | 12 |
تا آبان ۱۴۰۵ همهٔ پلن‌ها، از جمله رایگان، mcp را دارند. فهرست به‌روز در قیمت‌ها است.
چطور در یک خط وصل شوم؟
Section titled “چطور در یک خط وصل شوم؟”در Claude Code این فرمان سرور روشا را اضافه می‌کند. کلید از متغیر محیطی ROSHA_KEY خوانده می‌شود:
claude mcp add --transport http rosha https://poolick.ir/mcp \ --header "Authorization: Bearer $ROSHA_KEY"تنظیم Claude Desktop، Cursor، OpenAI API، Codex CLI، Gemini CLI و Gemini API در راه‌اندازی در هر دستیار است. اگر هنوز کلید ندارید، شروع سریع را ببینید.
چه چیزهایی می‌توانم بپرسم؟
Section titled “چه چیزهایی می‌توانم بپرسم؟”هر پرسشی که جوابش در سابقهٔ قیمت، آمار حقیقی و حقوقی، شاخص‌ها، تقویم معاملاتی یا دادهٔ صندوق‌ها باشد. چند نمونه:
- «ورود و خروج پول حقیقی در فولاد طی ۲۰ روز معاملاتی اخیر چطور بوده؟ روزهای خروج سنگین را مشخص کن.»
- «بازده یک‌ماههٔ پنج صندوق سهامی بزرگ را با بازده شاخص کل در همین بازه مقایسه کن.»
- «قیمت تعدیل‌شدهٔ خودرو از ابتدای ۱۴۰۴ را بگیر و بیشترین افت از قله را حساب کن.»
- «ترکیب دارایی صندوق عیار در سه ماه اخیر چه تغییری کرده است؟»
- «میانگین حجم معاملات فولاد در ۳۰ روز معاملاتی اخیر چقدر بوده؟»
دستیار برای این پرسش‌ها از ۱۲ ابزار روشا استفاده می‌کند. فهرست ابزارها، ورودی‌ها و خروجی هر کدام در ابزارهای MCP است.
مصرف MCP چطور شمرده می‌شود؟
Section titled “مصرف MCP چطور شمرده می‌شود؟”هر درخواست HTTP به /mcp یک درخواست از سقف دقیقه‌ای و سهمیهٔ روزانهٔ کلید کم می‌کند. یک گفت‌وگوی دستیار چند درخواست می‌فرستد: برقراری نشست، گرفتن فهرست ابزارها و هر فراخوانی ابزار.
- مصرف MCP در پنل با نام مسیر
mcpدیده می‌شود. - سقف‌ها با REST مشترک است: یک کلید، یک شمارنده.
- در رسیدن به سقف، پاسخ
429باRetry-Afterاست؛ مثل REST. شرح در محدودیت‌ها و پلن‌ها.
چه دسترسی‌ای لازم است؟
Section titled “چه دسترسی‌ای لازم است؟”خانوادهٔ mcp در پلن، اتصال به سرور را باز می‌کند. دو ابزار لحظه‌ای به خانوادهٔ intraday هم نیاز دارند، مثل REST: در پلن بدون intraday، ابزار get_intraday_bars خطا می‌دهد و get_quote همیشه قیمت پایانی آخرین روز را برمی‌گرداند (source: daily). ده ابزار دیگر در هر پلنِ دارای mcp کار می‌کنند.
اگر پلن شما mcp نداشته باشد، اتصال با 403 plan_forbids رد می‌شود. بقیهٔ خطاهای دسترسی (401 و 429) همان‌هایی هستند که در خطاها آمده است.
MCP چه چیزهایی ندارد؟
Section titled “MCP چه چیزهایی ندارد؟”- ریزمعاملات و snapshot زیرصندوق‌ها: فقط در REST هستند (
/tradesو/snapshots). - سقف ردیف: هر ابزار حداکثر ۵۰۰ ردیف برمی‌گرداند تا پاسخ در حافظهٔ گفت‌وگوی دستیار جا شود. برای سابقهٔ بلند از REST استفاده کنید.
- ورود با OAuth: سرور فقط کلید API در سرآیند را می‌پذیرد. برنامه‌هایی که فقط OAuth می‌پذیرند (مثل برنامهٔ ChatGPT) فعلاً وصل نمی‌شوند؛ جزئیات در راه‌اندازی در هر دستیار.
English summary
Section titled “English summary”
ROSHA (روشا) runs a remote MCP server at https://poolick.ir/mcp (Streamable HTTP). Authenticate with the same API key as the REST API: Authorization: Bearer $ROSHA_KEY. It exposes 12 tools for Tehran Stock Exchange, Iran Fara Bourse and Iranian mutual-fund data (search, daily history, individual/institutional flows, quotes, intraday bars, indices, trading days, funds). Each tool returns one JSON object capped at 500 rows; prices are in rials and dates accept ISO, yyyymmdd or Jalali. Every HTTP request to /mcp counts against the key's rate limit and daily quota, and the plan must include mcp.
صفحهٔ اصلی · قیمت‌ها · وضعیت · پنل · پشتیبانی
داده‌ها توصیهٔ سرمایه‌گذاری نیست. سلب مسئولیت