---
title: "MCP server"
description: "Connect Claude, ChatGPT, Cursor or Codex to generate images and videos, edit assets and reuse your Batch Banana library."
section: "Connect"
url: "https://batchbanana.com/docs/connect/mcp"
markdown_url: "https://batchbanana.com/docs/connect/mcp.md"
last_verified: "2026-11-11"
---

# MCP server

Connect Claude, ChatGPT, Cursor or Codex to generate images and videos, edit assets and reuse your Batch Banana library.

Create images and videos from Claude, ChatGPT, Cursor, Codex or another app that supports MCP (Model Context Protocol). The Batch Banana MCP server gives your app access to generation, editing and your existing library.

Pick your app below. ChatGPT and Codex add Batch Banana from their Plugins page. The others take the server URL, then you sign in to your Batch Banana account. No API key or local installation is needed.

```
https://mcp.batchbanana.com/mcp
```

### Claude

**Claude app** (On the web or in the desktop app)

1. Open Customize, then Connectors.
2. Choose + Add, then Add custom connector.
3. Name it, paste the URL and choose Continue.
4. Sign in to Batch Banana, then choose Add.

**Claude Code** (In your terminal)

```
claude mcp add --transport http batch-banana https://mcp.batchbanana.com/mcp
```

Then type /mcp in Claude Code and sign in.

On Team or Enterprise, an owner adds the connector first, in Organization settings > Connectors.

### ChatGPT

**ChatGPT and Codex apps** (On the web, in the ChatGPT app or in the Codex app)

1. Open Plugins.
2. Search for Batch Banana.
3. Choose + to add it.
4. Sign in to Batch Banana when it asks.

**Codex CLI** (In your terminal)

```
codex mcp add batch-banana --url https://mcp.batchbanana.com/mcp
codex mcp login batch-banana
```

### Cursor

**Cursor** (In ~/.cursor/mcp.json, or .cursor/mcp.json in one project)

```
{
  "mcpServers": {
    "batch-banana": {
      "url": "https://mcp.batchbanana.com/mcp"
    }
  }
}
```

Cursor asks you to sign in the first time it connects.

### Other apps

**Any app with MCP** (Most apps that read a config file take this entry)

```
{
  "mcpServers": {
    "batch-banana": {
      "url": "https://mcp.batchbanana.com/mcp"
    }
  }
}
```

The same steps are in Batch Banana, under _Settings > MCP_. They follow each app's own setup as of October 2026. Apps rename their menus often. If a step doesn't match what you see, the app's own guide has the current path.

## Sign in and choose a workspace

The first time your app connects, it opens a Batch Banana page in your browser. Sign in, or create an account from the sign-in page.

If you have more than one workspace, choose the one your app starts in. Then review its permissions:

- Generate images and video
- Edit and upscale images
- View generation results
- Read your library
- Import images to your library

Choose **Allow access** and return to your app. Public model information and prices are also available without workspace permissions.

If you signed up with email, the page first asks you to verify your address. Open the link in the email from Batch Banana, then come back to the page. It continues on its own, and **Allow access** appears.

The page stays valid for 30 minutes. If it says "Authorization request expired", start again from your app.

A connection works in one of your workspaces at a time and spends that workspace's credits. To move it to another of your workspaces, ask your app to switch, or pick another workspace from the **⋯** menu next to the app in _Settings > Connected apps_. It never switches on its own. If you leave the workspace it is using, its requests are refused until you move it.

## Try it

Ask for one image in your first test. Without a count, Batch Banana makes 4.

In ChatGPT, start your message with **@Batch Banana** and pick it from the list that appears, or choose it from the **+** menu. Without that, ChatGPT may answer an image request with its own image tool.

> Make one image of a chocolate bar in a cobalt paper wrapper lying on an old atlas, in hard window light.

What to ask next is in [Ask your AI app](https://batchbanana.com/docs/connect/use-in-your-ai-app).

## FAQ

**What does it cost?**
Connecting is free. So are looking up models, searching your library and asking for a price. Images, video and paid edits use the workspace's [credits](https://batchbanana.com/docs/account-and-billing/credits), at the same prices as in the app. Each model's price is in [Credit costs](https://batchbanana.com/docs/account-and-billing/credit-costs).

**Can I cap what an app spends?**
Yes. A connection has no daily credit limit until the workspace owner sets one. In _Settings > MCP_, under **Connected apps**, they open the **⋯** menu next to the app and choose **Daily limit** to set it, change it or turn it off. Each workspace has its own limit for the app. Once the app spends credits that day, its row shows how much. A request that would go over the limit is refused, and nothing is charged. The daily limit resets at midnight UTC. See [Daily credit limit](https://batchbanana.com/docs/connect/mcp-tools#daily-credit-limit).

**Can my teammates connect?**
Yes, any member can. Have each person connect from their own account, so _Settings > MCP_ shows who connected what.

**How do I disconnect an app?**
In _Settings > Connected apps_, choose **Disconnect** from the **⋯** menu next to the app. It loses access to all your workspaces right away. The owner of the workspace an app is using can also disconnect it, in _Settings > MCP_ under **Connected apps**.

**Why did an app ask me to sign in again?**
Batch Banana disconnects a connection on its own after 90 days without use, so the list holds only the apps you still run. It also replaces a connection when the same app on the same device signs in again, and drops sign-ins that never finished. Sign in again and the app carries on.

**Can the app delete my work?**
No. It can't delete anything or reach your billing. It works in one of your workspaces at a time and moves to another only when you ask. It can read your name, email and workspace name to label the connection. See [MCP tools](https://batchbanana.com/docs/connect/mcp-tools).

---

Last verified November 11, 2026. Web version: https://batchbanana.com/docs/connect/mcp
