Base44 custom MCP connection: add Sume's hosted server
Add Sume's hosted MCP to Base44 under Builder, MCP Connections: Builder plan, 20-server cap, an x-api-key header or OAuth, and what it can do at build time.

To add Sume to Base44, open Account preferences, go to Builder, then MCP Connections, click Add custom MCP, enter https://mcp.sume.com/mcp as the URL, and choose either OAuth or a custom header. Base44 says custom MCP connections need a Builder plan or higher, and an account can connect up to 20 MCP servers. Once the connection tests clean, the Base44 AI chat can call Sume's hosted tools for images, video and audio while you build.
What are the exact steps in Base44?
Base44's documentation lists the path: click the workspace name at the bottom left, open Account preferences, then Builder, then MCP Connections, then Add custom MCP. Fill in a name, the URL and the authentication, click Test, and click Test and add to save.
- Name: anything your collaborators will recognize, for example Sume.
- URL:
https://mcp.sume.com/mcp. This is the production endpoint on the Sume docs. - Authentication: OAuth, or Not required plus a custom header. Sume does not allow unauthenticated calls, so skip Not required unless you add a header.
- Custom header: Base44 lets you add a header name and value. Sume accepts
x-api-keyorAuthorization: Bearer.
Which auth should you pick: OAuth or an API key header?
Both work with Sume's hosted MCP, and they give different tool sets. OAuth grants mcp:read by default, so the session sees read-only tools only. To expose the tools that change data and the paid generation tools, the person approving must turn on the Write toggle on the consent page. An API key session sees the full hosted tool set. Sume has no mcp:paid scope, so spend is controlled by wallet admission, and paid calls still need an idempotency_key.
If a teammate only needs to browse jobs and assets from the Base44 chat, OAuth with Write off is the safer default. Base44 itself notes that OAuth is completed after the initial setup, so plan for a browser sign-in on the Sume MCP host.
What can Base44 do with Sume after connecting?
Base44 states that MCP connections only control what the AI chat can access while you build. They do not work in app logic, workflows or runtime, and data fetched during building is static. For Sume that means the chat can generate a hero image, a clip or a voice-over while you build, then you store the resulting media.sume.com URL in your app. A published Base44 app does not call the connection at runtime.
Quick reference
| Base44 field | Sume value | Source |
|---|---|---|
| Plan | Builder or higher | Base44 docs |
| Server limit | 20 per account | Base44 docs |
| URL | https://mcp.sume.com/mcp | Sume MCP quickstart |
| Header (API key) | x-api-key or Authorization: Bearer | Sume OAuth and API keys |
| OAuth scopes | mcp:read, optional mcp:write | Sume OAuth and API keys |
| Paid calls | idempotency_key required | Sume tools and gates |
Test it before you generate anything
After saving, ask the chat to call mcp_health and tools_list. Both are read-only and free. Before a paid call, ask for dry_run=true or generation_admission_preview to see the estimate. Long video jobs outlast one call, so tell the chat to resume with jobs_wait using the same job id and never to submit the create again.
Sources
Related posts
More in Integrations
- Bolt custom MCP server: connect Sume, tools are on by default
Connect Sume's hosted MCP in Bolt as a custom MCP server: HTTP, API key or MCP OAuth, and why tools-on-by-default makes OAuth read-only a safe start.
- Claude Free plan has one custom connector: is Sume worth the slot?
Claude's Free plan allows one custom remote MCP connector. What Sume's hosted MCP gives you in that slot, why read-only fits, and when to upgrade.
- Claude Research with a Sume connector: turn off write tools first
Anthropic advises disabling write-action tools when a custom connector is used with Research. For Sume that means read-only OAuth, no paid tools.
- Durable Object as a job_id ledger for Sume webhook retries
Use one Cloudflare Durable Object per Sume job_id to dedupe job.completed retries and redeliveries: verify in the Worker, record once in the object, return 2xx.
Written by Sume