رونمایی از سرور ابری OpenRouter MCP؛ اتصال مستقیم ابزارهای کدنویسی به مدل‌های هوش مصنوعی

معرفی

سرویس OpenRouter MCP یک سرور راه دور مبتنی بر پروتکل زمینه مدل (MCP) است که توسط پلتفرم OpenRouter در نشانی https://mcp.openrouter.ai/mcp میزبانی می‌شود. برای آشنایی بیشتر می‌توانید به صفحه محصول و مستندات رسمی آن مراجعه کنید.

این سرویس، پلتفرم OpenRouter را مستقیماً به ایجنت‌ها و ابزارهای کدنویسی روزمره شما از جمله Claude Code، Codex CLI، OpenCode، Cursor یا هر کلاینت سازگار با MCP متصل می‌کند. به این ترتیب، دستیار هوشمند شما می‌تواند بدون نیاز به نصب هیچ‌گونه سرور محلی، داده‌های زنده OpenRouter را دریافت کرده و ابزارهای منتخب تولید محتوا را اجرا کند.

ویژگی‌های برجسته این سرویس عبارت‌اند از:

• دسترسی زنده به کاتالوگ و اطلاعات حساب: مشاهده فهرست مدل‌ها، قیمت‌ها، اندپوینت‌ها، رتبه‌بندی‌ها، جستجو در مستندات و بررسی اعتبار باقی‌مانده
• ابزارهای استنتاج مبتنی بر مصرف (که هزینه آن‌ها از حساب متصل OpenRouter کسر می‌شود): شامل ارسال پیام‌های آزمایشی و تولید تصویر؛ هم‌چنین بخش محصول این سرویس، گردش‌کارهای تولید صوت و ویدیو را هم که در صفحه MCP توضیح داده شده است، پوشش می‌دهد
• احراز هویت: از طریق OAuth مرورگر (با صدور کلید اختصاصی MCP که معمولاً ۷ روز اعتبار و سقف هزینه پیش‌فرض ۱۰ دلاری دارد) یا با استفاده از هدر Authorization: Bearer <OPENROUTER_API_KEY> برای کلاینت‌های فاقد پشتیبانی از OAuth
• پروتکل انتقال: مبتنی بر MCP راه دور با فناوری Streamable HTTP که نیاز به نصب محلی را به‌طور کامل از بین می‌برد.

توضیحات فنی و ضرورت ساخت

مشکل موجود چیست؟

ایجنت‌های کدنویسی اغلب نام مدل‌ها، قیمت‌ها و قابلیت‌های آن‌ها را بر اساس داده‌های آموزشی قدیمی خود حدس می‌زنند. علاوه‌بر این، تیم‌های توسعه مجبورند محیط ویرایشگر کد را ترک کنند و برای بررسی اعتبار حساب یا آزمایش یک پرامپت، سراغ داشبوردهای تحت وب بروند. سرویس OpenRouter MCP تمام این چرخه را در دل ایجنت کدنویسی نگه می‌دارد.

نحوه کارکرد

1. نشانی اینترنتی https://mcp.openrouter.ai/mcp را در کلاینت MCP خود اضافه کنید
2. فرآیند احراز هویت OAuth را کامل کنید (یا کلید API را در قالب Bearer بفرستید). پلتفرم OpenRouter یک کلید اختصاصی و نشان‌دار را ویژه استفاده در MCP صادر می‌کند
3. ابزارها با استفاده از این کلید، درخواست‌ها را به API عمومی OpenRouter هدایت می‌کنند که نتیجه‌اش دریافت داده‌های زنده بدون ذخیره وضعیت محلی است. کدهای منبع شما به سرور ارسال نمی‌شوند، مگر اینکه صراحتاً ابزارهای تولید محتوا یا ثبت بازخورد را فراخوانی کنید.

ابزارهای ثبت‌شده در مستندات شامل دستوراتی هم‌چون list-models، get-model، list-model-endpoints، get-credits، list-daily-model-rankings، list-benchmarks، search-docs، send-message، generate-image و موارد دیگر هستند که فهرست کامل آن‌ها در جدول ابزارهای مستندات آمده است.

محدودیت‌ها

• سرویس MCP صرفاً برای ساخت و انتخاب مدل‌ها در محیط ایجنت طراحی شده است؛ بنابراین عملیات استنتاج در برنامه‌های نهایی و عملیاتی همچنان باید از طریق API استاندارد OpenRouter انجام شود
• کلیدهای MCP دارای تاریخ انقضا هستند (معمولاً ظرف ۷ روز منقضی می‌شوند) و ممکن است به احراز هویت مجدد نیاز داشته باشند
• استفاده از ابزارهای تولید محتوا هزینه دارد؛ بنابراین باید مراقب سقف مجاز هزینه‌ها باشید.

کاربرد و راه‌اندازی

این ابزار مناسب چه کسانی است؟

• توسعه‌دهندگانی که از ابزارهای Claude Code، Codex، OpenCode، Cursor یا سایر کلاینت‌های MCP استفاده می‌کنند و مدل‌های خود را از مسیر OpenRouter فراخوانی می‌کنند
• تیم‌هایی که می‌خواهند کشف و بررسی مدل‌ها، کنترل اعتبار حساب و تست سریع پرامپت‌ها را با اتکا به داده‌های زنده OpenRouter در همان محیط ویرایشگر کد انجام دهند.

راهنمای شروع به کار

1. محتوای صفحه معرفی سرویس و راهنمای راه‌اندازی سرور MCP را مطالعه کنید
2. سرور را به ابزار خود اضافه کنید؛ برای نمونه در ابزار Claude Code ابتدا دستور claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp و سپس دستور claude mcp login openrouter را اجرا کنید
3. در ویرایشگر Cursor، عبارت { "mcpServers": { "openrouter": { "url": "https://mcp.openrouter.ai/mcp" } } } را داخل فایل ~/.cursor/mcp.json قرار دهید و مراحل احراز هویت را انجام دهید
4. پیش از ثبت ثابت نام یک مدل در کدهای خود، بهتر است ابتدا از ابزار list-models، رتبه‌بندی‌ها و بنچمارک‌ها کمک بگیرید؛ هم‌چنین به یاد داشته باشید که فراخوانی ابزارهای تولید محتوا به‌منزله استفاده تجاری و هزینه‌بر از API محسوب می‌شود.