Claude Code Integration with Veo MCP
📘 Overview：Claude Code MCP Overview →
Veo is an AI video generation model launched by Google, featuring high-quality visuals and supporting 1080p / 4K high-resolution output and control over the first and last frames; veo3 / veo31 will also automatically generate native audio (sound effects + voice) that matches the visuals. If you are a developer, Claude Code + Veo MCP is the most convenient combination—generate videos using natural language in the terminal without switching windows or learning editing software.
¶ Obtain API Token
Before using the Veo MCP Server, you need to prepare an Ace Data Cloud API Token. The method to obtain it is consistent with the Claude Code VS Code configuration tutorial:
- Open the Ace Data Cloud Console - Application List to get your API Token for backup.
- If you are not logged in or registered, you will be automatically redirected to the login page; after logging in or registering, you will be automatically returned to the current page.
- The first application will come with a free quota, allowing you to experience the Claude Code MCP service for free.
One Token can be used for all MCP Servers provided by Ace Data Cloud, without needing to apply separately for Veo. The documentation and screenshots suggest displaying only the desensitized form, such as YOUR_ACEDATACLOUD_API_KEY, and do not paste the complete Token into public repositories, Issues, screenshots, or chat records.
Using the web version of claude.ai or Claude Desktop? They support OAuth one-click authorization, eliminating the need to manually fill in the Token. For details, see the Claude.ai / Desktop tutorial for Veo MCP.
¶ Configure Claude Code
Choose one from the following three options. -H must be uppercase; lowercase -h is --help; please replace the Token after Authorization with the actual value you copied from the console.
¶ For current project only: local
Suitable for trial use, the configuration is bound only to the project directory where you run the command. Claude Code will write the records into the local ~/.claude.json, along with the current project path.
claude mcp add veo --transport http https://veo.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s local
¶ Usable for all projects: user
Suitable for frequent use of Veo MCP across multiple projects. The configuration is written into the local ~/.claude.json user-level configuration, which will be visible in any project when Claude Code is opened afterward.
claude mcp add veo --transport http https://veo.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s user
¶ Shared with the project: project
Suitable for team projects. The configuration is written into the .mcp.json in the current project root directory, which can be submitted to a private repository for teammates to reuse; do not submit the real Token to public repositories, and it is recommended to change it to an environment variable placeholder or have each person add it locally.
claude mcp add veo --transport http https://veo.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s project
When the project-level configuration is read by Claude Code for the first time, it may display Pending approval, and you need to confirm trust in this project configuration in the Claude Code session, which is a normal security prompt.
¶ Verify Connection
After configuration, run:
claude mcp list
Seeing veo display ✓ Connected indicates a successful handshake. If it fails, check the Token, service URL, and configuration scope; do not judge the current status based on historical client versions or fixed tool counts.
¶ Practical Examples
After configuration, return to the Claude Code session and directly use natural language to call Veo:
Generate a demo video for the project
I am developing a weather app, help me generate a demo video: the phone screen displays weather information, with the background transitioning from sunny to rainy
Generate animated illustrations for documentation
Generate an animation for the README document: data flows from the input box on the left to the result panel on the right, passing through three processing nodes in between
Transition with first and last frames + export 1080p
veo_image_to_video supports 1 to 3 images for first/last frame interpolation; after the initial version is generated, use veo_get_1080p to obtain the high-definition version:
Use these two design drafts to create a transition animation with first and last frames, then export it to 1080p
Videos with native audio
When using veo3 / veo31, directly describe the sound in the prompt, and the visuals and audio will be generated together:
Generate a video with veo3: a convenience store on a rainy night, the sound of rain on the glass door, the doorbell ringing, and soft background music
¶ Tool List
| Tool | Description |
|---|---|
| veo_text_to_video | Text to video generation |
| veo_image_to_video | Image to video generation (supports first/last frames) |
| veo_extend_video | Video extension |
| veo_get_1080p | Obtain 1080p high-definition version |