MCP رو کنار API بذار، نه روی اون
خلاصهٔ کاملتر
Jerome Louvel تو این مقاله از Naftiko میگه بیشتر تیمها MCP (یعنی پروتکلی که ایجنتهای هوش مصنوعی باهاش ابزارها رو صدا میزنن) رو یهجور اضافه میکنن: یه سرور MCP جلوی سرور API فعلی میذارن و هر tool رو به یه endpoint وصل میکنن. این روش سریع راه میافته، ولی هر فراخوانی ایجنت باید از ایجنت به سرور MCP، بعد به سرور API و بعد به سیستمهای بالادستی بره.
مشکل فقط سرعت نیست. سرور MCP دوباره دادهای رو serialize میکنه که API تازه serialize کرده، احراز هویت خودشو داره و deploy و لاگ و on-call جدا میخواد. یه قرارداد دوم هم درست میشه: API یه توضیح OpenAPI داره و توضیح toolها فقط همونو بازنویسی میکنه. وقتی معنی یه فیلد عوض بشه، باید هر دو آپدیت بشن و معمولاً فقط یکیش آپدیت میشه.
راهحل نویسنده یه capability تو ابزار Ikanos هست. هر capability سه بخش داره: consumes (یعنی APIهای بالادستی که ازشون استفاده میکنه)، aggregates (یعنی flowهایی که این APIها رو با هم ترکیب میکنن) و exposes. REST و MCP دو تا adapter تو همون لیست exposes هستن و هر دو با ref به یه flow مشترک اشاره میکنن. این بخش MCP همون مثال مقالهست:
- type: mcp
namespace: shipyard-tools
tools:
get-ship-with-crew:
description: "Get ship details with resolved crew names"
ref: crew-resolver.resolve-crew-for-shipعملیات REST به اسم get-ship-with-crew هم دقیقاً به همین crew-resolver.resolve-crew-for-ship ارجاع میده. یعنی فراخوانیهای بالادستی، credentialها و منطق مرحلهها فقط یه بار نوشته میشن و یه موتور برای هر دو adapter اجراشون میکنه. این یه مسیر مهاجرت هم میده: منابعی که هنوز منتقل نشدن با forward بدون تغییر به API قدیمی پاس داده میشن، منابع منتقلشده پشتشون یه flow دارن و هر flow با یه ref تبدیل به tool MCP میشه.
دلیل دوم نویسنده اینه که MCP داره از REST و GraphQL جلو میزنه. MCP سه چیز داره که اونا بهطور استاندارد ندارن: discovery داخلی با tools/list، elicitation (یعنی سرور وسط اجرا از کاربر سؤال بپرسه، مثلاً تأیید مبلغ) و tasks (یعنی یه فراخوانی طولانی فوراً یه handle برگردونه تا بعداً وضعیتشو چک کنی یا لغوش کنی). سرور MCPی که روی API نشسته نمیتونه elicitation یا tasks بده، چون API زیرش جایی برای این کارها نداره.
پشتیبانی Ikanos از این دو تا هنوز تو مرحلهٔ review هست: یه مرحلهٔ elicit اجرای flow رو نگه میداره و از طریق MCP سؤال میپرسه، و flowی با mode: task بهشکل یه task ماندگار اجرا میشه که با ریاستارت هم از بین نمیره. همین flow روی REST جواب 501 Not Implemented میده. نویسنده معتقده MCP رابط اصلی دوران ایجنتها میشه و REST و GraphQL کنارش میمونن.
نکات کلیدی:
- گذاشتن MCP روی API یه پرش شبکهای، یه قرارداد دوم و یه deploy دوم اضافه میکنه.
- تو Ikanos، REST و MCP دو adapter تو لیست exposes هستن که با ref به یه flow مشترک وصل میشن.
- با forward میشه API قدیمی رو resource به resource منتقل کرد.
- elicitation و tasks معادل استانداردی تو REST یا GraphQL ندارن.
- روی REST، flowی که ورودی کاربر لازم داره جواب 501 Not Implemented میده.




