Claude Integration with Luma MCP
📘 Overview Guide: Using Ace Data Cloud MCP in Claude →
With Luma MCP, Claude can generate videos from text or images, continue existing videos, and return results after tasks are completed.
¶ What is MCP?
MCP (Model Context Protocol) is an open protocol launched by Anthropic that allows models like Claude to call external tools through a standard interface. In simple terms: equipping Claude with plugin capabilities.
Ace Data Cloud has encapsulated Luma's core capabilities into a remote MCP Server, allowing Claude to directly:
- Generate video from text (
luma_generate_video) - Generate video from image (
luma_generate_video_from_image) - Continue video / chain videos (
luma_extend_video,luma_extend_video_from_url) - Single / batch query tasks (
luma_get_task,luma_get_tasks_batch) - List actions / aspect ratios (
luma_list_actions,luma_list_aspect_ratios)
The entire integration requires just one URL, and the rest is handled by Claude.
¶ Adding Luma MCP in Claude.ai Web Version
💡 The integration in Claude.ai web version is OAuth direct connection, no need to copy API Token. You only need an account that can log in to Ace Data Cloud (GitHub / Google / WeChat are all acceptable).
¶ 1. Open Connectors Settings
Log in to https://claude.ai, click on the avatar in the lower left corner → Settings → Customize → Connectors, or directly visit https://claude.ai/customize/connectors.
⚠️ The old entry
/settings/connectorshas been migrated to/customize/connectors. Accessing the old address will show a message "Connectors have moved to Customize".
¶ 2. Add Luma MCP Server
Click the plus sign in the upper right corner → Add custom connector, and fill in the pop-up dialog:
| Field | Value |
|---|---|
| Name | Luma (choose any name) |
| URL | https://luma.mcp.acedata.cloud/mcp |
Click Add, and Claude will automatically discover all tools exposed by the Server.
¶ 3. OAuth Authorization
Click Connect → redirect to the Ace Data Cloud OAuth authorization page → log in with your account and click Allow. If you do not have an account yet, you can register at Ace Data Cloud.
¶ 4. Check Tool List
After authorization, return to Claude.ai, open the Luma Connector, and confirm the status is Connected. The tool list is dynamically provided by the Server; commonly used tools include generation, continuation, task querying, and parameter querying. Whether to allow tools to run automatically should be set according to task sensitivity and your own permission preferences.
¶ Usage Example
Prompt: Use Luma to generate one short video. First list the available aspect ratios and options, then ask me to choose. Subject: a paper crane folding itself and slowly flying upward in a sunny window, minimal background.
Claude will submit the generation task, query the task status, and return the video link upon completion. Available ratios and other parameters are subject to the current return values of the tool.
Example output (for demonstration purposes only, not as evidence of connection status):
📹 https://cdn.acedata.cloud/47d3c64bae.mp4
¶ More Playful Uses (Same Connector)
Change the prompt to the following, and Claude will automatically select the appropriate tool:
Generate Video from Image
Take this image IMAGE_URL and animate it with Luma: slow zoom-in, soft wind through hair, cinematic.
→ Claude calls luma_generate_video_from_image, turning a static image into a dynamic short film.
Video Continuation
Extend the last video by another clip — keep the same camera move, but reveal a wider scene.
→ Claude calls luma_extend_video, allowing the short film to continue.
Quick Testing of Ratios / Styles
List Luma aspect ratios first, then generate a 9:16 vertical clip of "neon Tokyo street, walking POV, raining".
→ Claude first calls luma_list_aspect_ratios to get valid values, then luma_generate_video to produce a vertical short film.
Linking Flux → Luma
Generate a Flux image of "lone astronaut on red Mars dune", then animate it with Luma image_to_video, slow dolly forward.
→ Claude first generates an image with Flux, then uses Luma to create a video from the image, generating in a chain.
¶ Frequently Asked Questions
Q: Why does the tool still require confirmation? A: Claude will decide whether to require confirmation based on the tool and permission settings. Please check the permissions in the current tool list of the Connector; for operations involving external writing, publishing, or costs, it is recommended to keep confirmation.
Q: What if the balance is insufficient?
A: The error message will include insufficient balance. Please visit the Ace Data Cloud Console to check and replenish your balance.
Q: What advantages does it have compared to Sora / Veo / Seedance? A: Different services support different models, parameters, and output specifications. First, check the current tools and parameters of each Connector, then generate small samples with the same prompt for comparison.
Q: Can Claude Desktop and Claude Code use it this way too? A: Yes. For details, see Claude Desktop + Luma MCP and Claude Code + Luma MCP.