# اتصال MCP

سرور MCP بنانا AI امکان خواندن مستندات API و فراخوانی endpointهای زنده را از Cursor، Claude Code، Codex و سایر کلاینت‌های Streamable HTTP می‌دهد.

Endpoint: `https://api.bananaai.ir/mcp`

## احراز هویت

برای ابزارهای تولید و گفتگو (عکس/ویدیو/چت/task) کلید API را در هدر بفرستید:

`Authorization: Bearer ba_live_YOUR_KEY`

ابزارهای مستندات بدون کلید هم کار می‌کنند. تولید موفق **اعتبار مصرف می‌کند**.

## پیکربندی Cursor

فایل `.cursor/mcp.json` یا تنظیمات MCP:

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

## پیکربندی Claude Code

CLI:

```bash
claude mcp add --transport http \
  --header "Authorization: Bearer ba_live_YOUR_KEY" \
  bananaai https://api.bananaai.ir/mcp
```

یا `.mcp.json` پروژه (برای HTTP حتماً `type: "http"`):

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

## پیکربندی Codex

کلید را در متغیر محیطی بگذارید، سپس CLI یا `~/.codex/config.toml`:

```bash
export BANANAAI_API_KEY="ba_live_YOUR_KEY"
codex mcp add bananaai --url https://api.bananaai.ir/mcp --bearer-token-env-var BANANAAI_API_KEY
```

```toml
[mcp_servers.bananaai]
url = "https://api.bananaai.ir/mcp"
bearer_token_env_var = "BANANAAI_API_KEY"
```

مقدار `BANANAAI_API_KEY` خود کلید است (بدون پیشوند Bearer). Codex هدر Authorization را می‌سازد.

## کلاینت‌های stdio

اگر کلاینت فقط stdio داشت:

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

## ابزارها

- `list_api_docs`: فهرست صفحات مستندات
- `get_api_docs`: دریافت Markdown یک صفحه
- `get_account`: `GET /api/v1/account` (موجودی کیف پول؛ بدون کسر اعتبار)
- `generate_image`: `POST /api/v1/images/generations`
- `edit_image`: `POST /api/v1/images/edits`
- `generate_video`: `POST /api/v1/videos/generations`
- `image_to_video`: `POST /api/v1/videos/image-to-video`
- `chat_completion`: `POST /api/v1/chat/completions` (گفتگو با GPT 6 Astra، Claude، Grok، Gemini و …؛ پاسخ فوری)
- `text_to_speech`: `POST /api/v1/audio/speech` (متن به گفتار؛ پاسخ فوری)
- `speech_to_text`: `POST /api/v1/audio/transcriptions` (گفتار به متن؛ پاسخ فوری)
- `dub_media`: `POST /api/v1/audio/dubbing` (دوبله؛ با `get_task` پیگیری کنید)
- `list_models`: `GET /api/v1/models` (فهرست مدل‌های عکس، ویدیو، گفتگو و صدا با هزینه؛ بدون کسر اعتبار)
- `get_task`: `GET /api/v1/tasks/:id` (مقدار فیلد `id` از پاسخ ساخت)

کلید را از https://api.bananaai.ir/console بسازید.