YOUR FIRST MCP CONNECTION

Talk to AI.
Create together.

Describe what you would like to make. With an MCP connection, an AI app can help you create inside COCO CHARA.

Available on WindowsSee how to get started
It can start with a conversation
You

Make a small blue robot.

AI

I’ll make a preview first. Please take a look in COCO CHARA.

An example conversation. Review a new creation before asking AI to finalize it.

01 · ABOUT MCP

What is MCP?

MCP is a way for AI to connect to other apps. When connected to COCO CHARA, AI can look at your world and help create things based on your requests.

The conversation takes place in the AI app you connected. Use everyday language to describe what you want to make or change.

  1. Describe your idea to AI
  2. See it in COCO CHARA
  3. Review, refine and finish

02 · IDEAS

What can I do?

Start with a small creation or one change at a time.

Make something new

“Make a small house with a red roof.”

Describe its shape, colors and style, and ask AI to help build it.

Refine what you see

“Make the roof a little brighter.”

Look at the result, then talk through changes to its colors and shape.

Create something that moves

“Make a plane with a spinning propeller.”

Describe which parts should move and how, as well as what the creation should look like.

Available actions depend on the world mode and the part you are editing. Include the name or location of the creation or part you want to change.

03 · GET STARTED

How do I use it?

Prepare COCO CHARA first, then follow the instructions for your AI app. You only need to set up one of the four.

First, prepare COCO CHARA

  1. Allow the connection

    From COCO CHARA’s main menu, open “AI Settings” and turn “Allow MCP Connections” ON.

  2. Copy the path

    Click the copy button beside “MCP Server Path.” This is the location of the connection program. Use the path shown in your app.

  3. Open your AI app’s settings

    Choose your app’s guide below. You will enter the copied path in that app’s settings screen or configuration file.

Labels and locations may vary with your app’s language and updates.

CODEX

Using Codex

Set this up in the Windows desktop app.

  1. Open MCP settings

    Open “Settings” → “MCP servers” → “Add server.”

  2. Enter these values
    Name
    cocochara
    Transport
    STDIO
    Command
    Paste the original path copied from COCO CHARA. Do not add quotation marks around it.
    Arguments and environment variables
    Leave these empty.

    STDIO starts the connection program on your PC.

  3. Save and restart

    Save the server, select “Restart,” and check that cocochara is enabled in the server list.

  4. Check the connection

    Open a local task running on this PC. Type /mcp in the composer to inspect connections, then follow the connection check below.

Settings reference: OpenAI’s MCP guide

CLAUDE DESKTOP

Using Claude Desktop

Use Chat in the installed desktop app.

  1. Open the configuration file

    From the app menu, open “Settings” → “Developer” → “Edit Config.” If a folder opens, right-click claude_desktop_config.json and choose “Open with” → “Notepad.”

    You can also enter %APPDATA%\Claude in File Explorer’s address bar. “Edit Config” creates the file if needed.

  2. Paste and save

    If the file is empty or contains only {}, select and copy the entire example below, then paste it into the file open in Notepad. Otherwise, expand the instructions for an existing file.

    Example to paste into claude_desktop_config.json

    {
      "mcpServers": {
        "cocochara": {
          "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
        }
      }
    }
    If your file already contains settings

    Keep your existing settings. Add the entry below inside the existing mcpServers braces, after the last server. Put a comma after that server’s closing }, then paste this entry. If mcpServers is empty, paste the entry inside its braces without a preceding comma. If cocochara already exists, update its command only. Do not add a second mcpServers block.

    Entry to add inside mcpServers in claude_desktop_config.json

      "cocochara": {
        "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
      }

    If there are other settings but no mcpServers entry, add "mcpServers": { … } inside the outermost braces, separated from the preceding setting by a comma. Save a copy of the original file before editing.

    Next, replace the path in the file you are editing. Return to COCO CHARA’s AI Settings and copy “MCP Server Path” again. Back in claude_desktop_config.json, select only REPLACE_WITH_YOUR_MCP_SERVER_PATH and paste your path. Keep the surrounding double quotes.

    Inside this JSON file, write every backslash \ twice as \\. For example, a copied path of C:\Games\COCO CHARA\mcp_server\cocochara_mcp.exe becomes "command": "C:\\Games\\COCO CHARA\\mcp_server\\cocochara_mcp.exe". This location is only an example; use your actual copied path.

    Press Ctrl + S. Keep the name claude_desktop_config.json, with no .txt suffix.

  3. Quit and reopen Claude Desktop

    Right-click Claude in the Windows notification area (under “∧” if hidden) and quit. Open Claude again from the Start menu.

  4. Find the connection

    In a new chat, open “+” → “Connectors” and look for cocochara. If missing, check “Developer” for connection errors. Continue with the connection check.

This local configuration works in desktop Chat; it is not available in the browser or Cowork.

Official guides: Local setup · Connection status · Desktop, web, and Cowork

ANTIGRAVITY

Using Antigravity

These steps use Antigravity IDE, with its editor and AI side panel.

  1. Open MCP management

    At the top of the AI side panel, select “…” → “MCP Servers” → “Manage MCP Servers” → “View raw config.”

  2. Add the settings

    In mcp_config.json, select and copy the entire example below, then paste it into the empty file or replace {} in the Antigravity editor. For an existing configuration, follow the expandable instructions to add cocochara.

    Example to paste into mcp_config.json

    {
      "mcpServers": {
        "cocochara": {
          "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
        }
      }
    }
    If your file already contains settings

    Keep your existing settings. Add the entry below inside the existing mcpServers braces, after the last server. Put a comma after that server’s closing }, then paste this entry. If mcpServers is empty, paste the entry inside its braces without a preceding comma. If cocochara already exists, update its command only. Do not add a second mcpServers block.

    Entry to add inside mcpServers in mcp_config.json

      "cocochara": {
        "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
      }

    If there are other settings but no mcpServers entry, add "mcpServers": { … } inside the outermost braces, separated from the preceding setting by a comma. Save a copy of the original file before editing.

    Next, replace the path in the file you are editing. Return to COCO CHARA’s AI Settings and copy “MCP Server Path” again. Back in mcp_config.json, select only REPLACE_WITH_YOUR_MCP_SERVER_PATH and paste your path. Keep the surrounding double quotes.

    Inside this JSON file, write every backslash \ twice as \\. For example, a copied path of C:\Games\COCO CHARA\mcp_server\cocochara_mcp.exe becomes "command": "C:\\Games\\COCO CHARA\\mcp_server\\cocochara_mcp.exe". This location is only an example; use your actual copied path.

    Press Ctrl + S.

  3. Reopen the app

    Quit and restart Antigravity. Check that cocochara appears and is enabled in MCP management.

  4. Try it in chat

    Start a new conversation and follow the connection check.

If you use the Antigravity 2.0 interface

Open “Settings” at bottom left → “Customizations” → “Installed MCP Servers.” For manual configuration, open %USERPROFILE%\.gemini\config in File Explorer and edit mcp_config.json in Notepad. Create the folder and file if missing; paste the example above, replace its path as described in step 2, and save without a .txt suffix.

Refresh the server list and enable cocochara.

Interface reference: Google’s Antigravity MCP guide

LM STUDIO

Using LM Studio

Use LM Studio’s own chat with a model loaded on your PC.

  1. Prepare a model

    If needed, download a model from “Discover.” Choose one that fits your PC’s memory and supports tool use.

    Open “Chat,” select the downloaded model in the model loader at the top, and load it. Send a short greeting to check that it responds.

  2. Open MCP settings

    In the chat’s right settings sidebar, choose “Program” → “Install” → “Edit mcp.json.”

  3. Paste and save

    Select and copy the entire example below, then paste it into the empty mcp.json or replace {} in LM Studio’s editor. For an existing file, follow the expandable instructions to add cocochara.

    Example to paste into mcp.json

    {
      "mcpServers": {
        "cocochara": {
          "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
        }
      }
    }
    If your file already contains settings

    Keep your existing settings. Add the entry below inside the existing mcpServers braces, after the last server. Put a comma after that server’s closing }, then paste this entry. If mcpServers is empty, paste the entry inside its braces without a preceding comma. If cocochara already exists, update its command only. Do not add a second mcpServers block.

    Entry to add inside mcpServers in mcp.json

      "cocochara": {
        "command": "REPLACE_WITH_YOUR_MCP_SERVER_PATH"
      }

    If there are other settings but no mcpServers entry, add "mcpServers": { … } inside the outermost braces, separated from the preceding setting by a comma. Save a copy of the original file before editing.

    Next, replace the path in the file you are editing. Return to COCO CHARA’s AI Settings and copy “MCP Server Path” again. Back in mcp.json, select only REPLACE_WITH_YOUR_MCP_SERVER_PATH and paste your path. Keep the surrounding double quotes.

    Inside this JSON file, write every backslash \ twice as \\. For example, a copied path of C:\Games\COCO CHARA\mcp_server\cocochara_mcp.exe becomes "command": "C:\\Games\\COCO CHARA\\mcp_server\\cocochara_mcp.exe". This location is only an example; use your actual copied path.

    Press Ctrl + S. Saving loads the configured servers.

  4. Try the connection in chat

    Check cocochara in “Program” and enable it if disabled. Send the connection check below in the chat with your loaded model.

    If asked to approve a tool call, check that it inspects the connection and allow it. If the model only replies without checking, review tool availability and the model’s tool-use support.

Official guides: MCP setup · Loading a model · Model tool support · Loading servers and approving calls

Finally, check that it works

  1. Open a world in COCO CHARA

    Close settings and open the world you want to work in. Keep COCO CHARA running.

  2. Send this to your AI app
    Use COCO CHARA’s MCP tools to check the world and mode I have open. Do not change any creations yet.

    If an approval prompt appears, review the action and allow it.

  3. Compare the reply with your screen

    The connection works when the AI actually uses a COCO CHARA tool and returns information matching your current world or mode. A reply saying it can connect is not enough to verify the connection.

If you get stuck

Settings will not save, or a JSON error appears
Check braces, commas, and quotation marks. In your AI app’s configuration file, check that you replaced the example’s path and doubled every backslash inside the JSON string.
cocochara is missing from the list
Check that you saved the right file, that its name does not end in .json.txt, and that you restarted the app.
The server is listed but cannot check the world
Keep COCO CHARA running with MCP ON, using the same Windows account. If you moved the app, copy its new path from AI Settings and update the connection.
It connected at the menu, but cannot create anything
Open a world, then refresh the connection or restart the AI app and try a new conversation. Available actions depend on the world’s mode.

Common questions

Do I need to know programming?

No. You can describe your creation in everyday language. You only need to set up the connection in your AI app before using it for the first time.

How is this different from In-game Chat AI?

With MCP, you talk to an AI app outside COCO CHARA. For Gemini inside the game, see the In-game Chat AI guide.

Can I connect from Android?

MCP connections are available on Windows. The Android version cannot make a direct MCP connection.

Does AI change my creation straight away?

For a new creation, review the preview and ask AI to finalize it when you are happy. Some actions, such as deleting blocks or changing colors, take effect directly. Be clear about what you want changed.

What if it does not connect?

Check that COCO CHARA is running, MCP is enabled, and the displayed path was registered correctly. Run both apps as the same Windows user, then reconnect from your AI app.