Cocos Creator 3.x MCP Install Guide: Import Extension and Connect an AI IDE

What This Guide Covers

Follow these five steps to connect Cocos Creator 3.x MCP (VberAI Pro) to a local Creator project so Cursor (or another MCP-capable AI IDE—same idea) can operate, preview, and debug the editor—not just edit scripts on disk.

When you finish, you should be able to:

• Import and enable cocos-mcp-server via Extension Manager
• Activate with a VberAI account or email + activation code
• Start the local Cocos MCP Server (default port 3000)
• Use Quick configure → Auto configure to register the server in Cursor and confirm the connection

Product page: VberAI Cocos MCP 3.x

This article uses Cursor as the example. Claude Code, Windsurf, Cline, and other MCP clients follow a similar flow.

Prerequisites

Item	Notes
Cocos Creator	3.0+ (any 3.x project)
Plugin package	Cocos Creator 3.x MCP Pro archive from the official site
Activation	VberAI account + password, or email + activation code
AI IDE	Cursor recommended; other MCP clients also work
Local network	The MCP bridge usually runs on 127.0.0.1—do not expose the port publicly

Step 1: Download Cocos Creator 3.x MCP

Download the Pro build from the VberAI site:

Download page: https://www.vberai.com/game-engines/cocos?ch=CQZLC2FG

Suggested flow:

1. Open the page and download Cocos MCP 3.x Pro with your account permissions
2. Save the archive locally—you do not need to unzip into the project yet (the next step imports the archive)
3. Confirm the project is Creator 3.0 or newer; do not mix with the 2.x package

OSS vs Pro differences and billing follow the current site copy.

Step 2: Import the Extension

1. Open your Cocos Creator 3.x project
2. Menu: Extension → Extension Manager → Import Extension
3. Select the Cocos Creator 3.x MCP archive you just downloaded
4. After a successful import, the extension list should show cocos-mcp-server enabled

If it appears disabled, enable it before continuing.

Step 3: Activate cocos-mcp-server

1. Menu: Extension → Cocos MCP Server → Open Mcp Panel
2. On the activation screen, use either:
   • VberAI account + password
   • Email + activation code
3. After activation succeeds, open the MCP Server settings page (next step)

Without activation, the server usually will not start. Confirm your plan or code matches the current Pro build.

Step 4: Start cocos-mcp-server

1. After activation, open MCP Server settings
2. Adjust as needed:
   • Port: default 3000
   • Language: match your UI preference
   • Startup: use panel options (for example auto-start with the editor, if available)
3. Click Start service
4. When the panel shows Running, Cocos MCP Server is up

You now have a local MCP bridge. Next, hand it to your AI IDE.

Step 5: One-Click AI IDE Setup (Cursor Example)

1. Open Tool manager
   • Review tools exposed by Cocos MCP Server
   • Enable only what you want the AI to use
2. Open Quick configure
   • Choose your IDE (for example Cursor)
   • Click Auto configure
   • Confirm the UI shows a configured state
3. Open Cursor
   • In the MCP / tools list you should see cocos-creator (or the name shown in the panel) connected
   • If it is missing, click Reload (or the equivalent MCP reload) in Cursor and check again

Other IDEs follow the same path—just pick a different client under Quick configure.

Quick verification after connecting

In Cursor, start with a read-only check, for example:

List the root nodes of the scene currently open in Cocos Creator.

If the reply matches the editor hierarchy, the bridge works. Then try a small write (create a temporary node and delete it) to confirm permissions and tool selection.

FAQ

Import failed, or cocos-mcp-server is missing from the list?
Use the official 3.x archive (not 2.x). Creator must be 3.0+. If it stays disabled, enable it in Extension Manager and restart Creator.

Activation keeps failing?
Confirm Pro entitlements, or that the activation code is valid and tied to the correct email. Check the account center on the site, then retry in the panel.

I clicked Start service but never see Running?
Confirm port 3000 (or your custom port) is free, and localhost is not blocked. Make sure Step 3 completed successfully.

Cursor does not show cocos-creator?
In Creator, confirm the server is still Running, run Quick configure → Auto configure again, then reload MCP in Cursor. If it still fails, check that Cursor’s MCP config includes the local bridge address.

Next Steps

• Use natural language for a scene query or a small edit to learn the tool boundaries
• Commit before large changes; keep the bridge on localhost only
• For design-to-engine UI, pair with VberAI AI Studio, then iterate in-editor with MCP

For Creator 2.x, follow the Cocos Creator 2.x MCP install guide—do not mix packages. For more MCP context, see the Cocos Creator MCP video guide.