MCP quickstart

Sume has one MCP URL for all clients:

https://mcp.sume.com/mcp

Add the URL to your client. The client opens a browser. Sign in to Sume, then select Allow. You do not need an API key.

1. Connect your client

Claude (claude.ai and Claude Desktop)

Add Sume to Claude

The link opens Add custom connector in Claude with the name and the URL filled in. Select Continue and finish the steps. To add it by hand, open Customize → Connectors in Claude, add a custom connector, and paste the URL. On a Team or Enterprise plan, an owner adds custom connectors.

Claude Code

claude mcp add --transport http sume https://mcp.sume.com/mcp
claude mcp login sume

claude mcp login opens the browser. Sign in, then select Allow. In a session, /mcp shows sume as connected.

Cursor

Add Sume to Cursor

Or add Sume to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp"
    }
  }
}

Cursor shows Needs login next to sume. Select it, sign in, then select Allow.

Codex

codex mcp add sume --url https://mcp.sume.com/mcp
codex mcp login sume

Other clients

Add the URL as a streamable HTTP MCP server. The client finds the sign-in at https://mcp.sume.com/.well-known/oauth-protected-resource/mcp. A script that cannot sign in sends a Sume API key to https://api.sume.com/mcp instead (Authorization: Bearer $SUME_API_KEY or x-api-key); mcp.sume.com does not take API keys. Refer to Sign-in and API keys.

2. Allow access

After you sign in, Sume shows which app asks for access and the account that you signed in with.

• Read is always on. The app can see your account, credits, models, assets, and jobs.
• Create and spend credits lets the app make images, videos, and audio, upload files, and cancel jobs. Keep it on to generate. If you turn it off, the app can only read.
• If the page shows a Workspace choice, pick the workspace whose credits the app spends. If it does not, the app uses your personal workspace.

Select Allow to connect, or Deny to stop.

3. Make your first image

Ask the agent:

Use Sume to make an image of a red apple on a white table. Show me the link.

The agent calls two tools:

1. generate_image with payload.prompt and an idempotency_key. Sume answers in about a second with a job_id.
2. jobs_wait with that job_id and include_results: true. When the job is done, the answer has the image URL (https://media.sume.com/...).

In Claude, the image also shows up in Sume's viewer right in the chat. It waits for the job on its own. Select the image to see it full screen with the prompt, the model and the ratio. Download saves the file, and Animate, Edit and Recreate put a ready request into your message box, so the agent runs it with generate_video or generate_image once you send it.

Images take 10–60 seconds. Videos (generate_video) take 1–5 minutes. To see the price first, ask the agent to add dry_run: true. Sume then shows the credits and does not run the job.

To use a file from your computer as a reference, the agent uploads it with assets_upload_url and assets_complete, then passes the asset URL. A public https:// image or video URL works directly.

4. When something goes wrong

Local CLI alternative

If the agent can run shell commands on your machine, direct CLI commands also work (sume login, sume tools list --json, sume jobs …). Refer to the CLI overview. Local sume mcp is not launched in the current CLI releases (sume mcp doctor → coming_soon). It is separate from the hosted connector at mcp.sume.com.

Studio Agent is different

Studio Agent is the in-app Sume agent product. It is not the public hosted MCP connector that these pages document. Do not configure Studio Agent internals as a customer MCP server URL.