رفتن به محتوای اصلی
بنانا AI
مستندات APIشروع کارMCP

اتصال MCP

سرور MCP بنانا AI مستندات و ابزارهای تولید را در اختیار Cursor، Claude Code، Codex و هر کلاینت سازگار با Model Context Protocol قرار می‌دهد.

معرفی

سرور MCP بنانا AI روی پروتکل Streamable HTTP کار می‌کند و هر کلاینتی که این حالت را پشتیبانی کند، از جمله Cursor، Claude Code و Codex، می‌تواند مستقیماً به آن وصل شود. ابزارهای مستندات بدون کلید کار می‌کنند؛ ابزارهای حساب و تولید به کلید API نیاز دارند و در صورت تولید موفق از اعتبار حساب کم می‌کنند.

MCPhttps://bananaai.ir/api/mcp

احراز هویت

همان کلیدی که برای REST API می‌سازید اینجا هم استفاده می‌شود. کلید را از پنل توسعه‌دهندگان بسازید و در هدر Authorization اتصال MCP قرار دهید:

HTTP
Authorization: Bearer ba_live_YOUR_KEY

پیکربندی کلاینت

کلاینت خود را انتخاب کنید و پیکربندی را در فایل مربوط قرار دهید. در همهٔ نمونه‌ها ba_live_YOUR_KEY را با کلید خودتان جایگزین کنید.

از تنظیمات MCP یا فایل .cursor/mcp.json پروژه (یا ~/.cursor/mcp.json برای همهٔ پروژه‌ها) استفاده کنید.

.cursor/mcp.json
{
  "mcpServers": {
    "bananaai": {
      "url": "https://bananaai.ir/api/mcp",
      "headers": {
        "Authorization": "Bearer ba_live_YOUR_KEY"
      }
    }
  }
}

ابزارها

پس از اتصال، ابزارهای زیر در اختیار عامل قرار می‌گیرند. ابزارهای تولید همان پارامترهای مسیرهای REST را می‌پذیرند و شناسهٔ تسک را در فیلد id برمی‌گردانند.

ابزاردستهکلیدتوضیح
list_api_docsمستندات—فهرست صفحات مستندات API.
get_api_docsمستندات—Markdown کامل یک صفحه از مستندات.
get_accountحسابلازمموجودی اعتبار، پلن فعال و سقف نرخ درخواست.
generate_imageتولیدلازمتولید عکس از متن (images/generations).
edit_imageتولیدلازمویرایش عکس با عکس‌های مرجع (images/edits).
generate_videoتولیدلازمتولید ویدیو از متن (videos/generations).
image_to_videoتولیدلازمتولید ویدیو از عکس (videos/image-to-video).
text_to_speechتولیدلازممتن به گفتار با گویندگان فارسی (audio/speech).
speech_to_textتولیدلازمرونویسی صوت یا ویدیو به متن (audio/transcriptions).
dub_mediaتولیدلازمدوبلهٔ صوت یا ویدیو به زبان دیگر (audio/dubbing).
get_taskپیگیریلازموضعیت و نتیجهٔ یک تسک با شناسهٔ آن.

نکته

عامل پس از فراخوانی ابزار تولید باید هر ۳ تا ۵ ثانیه get_task را صدا بزند تا وضعیت به completed یا failed برسد. این نکته در توضیحات خود ابزارها هم آمده است، بنابراین عامل‌های مدرن آن را به‌طور خودکار انجام می‌دهند.