رفتن به محتوای اصلی
بنانا AI
MCP

اتصال MCP

سرور MCP بنانا AI مستندات API را در اختیار عامل‌ها قرار می‌دهد و با کلید شما مسیرهای زنده API را فراخوانی می‌کند. این سرور با Cursor، Claude Code و Codex سازگار است.

معرفی

آدرس سرور: https://bananaai.ir/api/mcp. کلاینت‌هایی که Streamable HTTP را پشتیبانی می‌کنند، از جمله Cursor، Claude Code و Codex، می‌توانند مستقیماً متصل شوند. ابزارهای مستندات بدون کلید نیز کار می‌کنند، اما ابزارهای تولید به کلید API نیاز دارند و در صورت موفقیت از اعتبار حساب کم می‌کنند.

اطلاعات

کلید را از پنل توسعه‌دهندگان بسازید. راهنمای تنظیم هدر Authorization را در صفحه ساخت و استفاده از کلید ببینید.

احراز هویت

برای استفاده از ابزارهای زنده، هدر زیر را روی اتصال MCP تنظیم کنید:

bash
Authorization: Bearer ba_live_YOUR_KEY

هشدار

تولید موفق عکس یا ویدیو از اعتبار حساب کم می‌کند. پیش از فراخوانی، مدل و هزینه آن را در مستندات قیمت بررسی کنید.

پیکربندی Cursor

پیکربندی زیر را در تنظیمات MCP یا فایل .cursor/mcp.json وارد کنید:

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

پیکربندی Claude Code

سرور را با CLI اضافه کنید یا پیکربندی را در فایل .mcp.json پروژه بنویسید. برای پیکربندی در سطح کاربر از ~/.claude.json استفاده کنید. برای HTTP حتماً type: "http" را تنظیم کنید:

bash
claude mcp add --transport http \
  --header "Authorization: Bearer ba_live_YOUR_KEY" \
  bananaai https://bananaai.ir/api/mcp
.mcp.json
{
  "mcpServers": {
    "bananaai": {
      "type": "http",
      "url": "https://bananaai.ir/api/mcp",
      "headers": {
        "Authorization": "Bearer ba_live_YOUR_KEY"
      }
    }
  }
}

پیکربندی Codex

Codex از Streamable HTTP پشتیبانی می‌کند. کلید را در متغیر محیطی نگه دارید و پیکربندی را در ~/.codex/config.toml (یا .codex/config.toml پروژه) قرار دهید:

bash
export BANANAAI_API_KEY="ba_live_YOUR_KEY"
codex mcp add bananaai --url https://bananaai.ir/api/mcp --bearer-token-env-var BANANAAI_API_KEY
config.toml
[mcp_servers.bananaai]
url = "https://bananaai.ir/api/mcp"
bearer_token_env_var = "BANANAAI_API_KEY"

مقدار BANANAAI_API_KEY باید خود کلید، مانند ba_live_...، و بدون پیشوند Bearer باشد. Codex هدر Authorization را می‌سازد.

کلاینت‌های stdio

اگر کلاینت فقط از stdio پشتیبانی می‌کند، از mcp-remote استفاده کنید:

mcp.json
{
  "mcpServers": {
    "bananaai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bananaai.ir/api/mcp",
        "--header",
        "Authorization: Bearer ba_live_YOUR_KEY"
      ]
    }
  }
}

ابزارها

  • list_api_docs: دریافت فهرست صفحات مستندات
  • get_api_docs: دریافت Markdown یک صفحه
  • get_account: موجودی اعتبار، پلن و سقف نرخ
  • generate_image: تولید عکس از متن
  • edit_image: ویرایش عکس
  • generate_video: تولید ویدیو از متن
  • image_to_video: تولید ویدیو از عکس
  • get_task: پیگیری وضعیت وظیفه

نکته

پس از شروع تولید، هر ۳ تا ۵ ثانیه get_task را فراخوانی کنید تا وضعیت به completed یا failed برسد.
اتصال MCP