Skip to main content

Getting Started with brainCloud MCP in Claude

How to connect to the brainCloud MCP server from Claude and start managing your apps with AI assistance.

Written by Paul Winterhalder

Overview

The brainCloud MCP (Model Context Protocol) server lets you connect Claude - Anthropic's AI assistant - directly to your brainCloud account. Once connected, Claude can help you manage apps, write and deploy cloud code scripts, configure API hooks, manage S2S servers, and more, all through natural language.

Prerequisites

  • A brainCloud account with at least one team

  • Builder API enabled on your team (contact your team admin if not enabled) - it is done via the Team > Setup > Team Info page, and does NOT require static API keys

  • Access to Claude (claude.ai) or the Claude desktop/CLI app

Step 1: Install the brainCloud MCP Server

The brainCloud MCP server is available as a hosted HTTP/SSE server. To connect it to Claude, you will add it as an MCP server in your Claude settings.

In the Claude Desktop App or Claude Code CLI, add the brainCloud MCP server endpoint to your MCP configuration.

Claude Desktop App

For the Claude Desktop app, launch the app and go to the Code section. Click Customize.

Then choose Add custom connector from the drop-down menu

Then give the connector a name - like "brainCloud" or "braincloud-public-baas" or something. And enter the URL of the MCP. The determine the URL for a private deployment just replace the "api" portion of the url with "mcp" (and add "/mcp" to the end as well).
​
The URL for the Public BaaS is: https://mcp.braincloudservers.com/mcp

Claude Code CLI

For the Claude Code CLI, run the following command from the terminal:
​claude mcp add --transport http braincloud https://mcp.braincloudservers.com/mcp

Step 2: Authenticate

The server uses OAuth for authentication, so you will be prompted to log in with your brainCloud credentials the first time you connect.

Claude Desktop App

The Claude Desktop App will prompt you to connect immediately after adding the connector:

You will be redirected to brainCloud's OAuth login page. Sign in with your brainCloud account credentials. Once authorized, Claude will be able to act on your behalf within the permissions granted to your account.

Claude Code CLI

To connect in the Claude Code CLI:

  • Start Claude

  • Then type "/mcp" to see your mcp servers

  • Cursor to the brainCloud MCP, and hit [Enter]

  • Then choose "Authenticate" from the menu

A web browser will launch for you to log into brainCloud accept the mcp permissions.

Step 3: Check Your Working Context

Once connected, ask Claude to show your brainCloud context:

"What is my brainCloud context?"

Claude will report:

  • The brainCloud environment you are connected to (e.g., Public BaaS)

  • Your active team

  • Your active app (if one is selected)

  • Other teams available to you

Step 4: Select a Team and App

Most operations are scoped to a specific app. Tell Claude which team and app to work with:

"Switch to my Acme team and connect to my GameApp."

Claude will list your available apps and switch to the one you specify. From that point forward, all script and configuration operations target that app.

What You Can Do

Once connected and an app is selected, you can ask Claude to:

  • List and read scripts - "Show me all my cloud code scripts."

  • Create and edit scripts - "Create a cloud code script that posts a score to multiple leaderboards."

  • Manage API hooks - "Add a pre-hook for posting leaderboard scores."

  • Configure S2S servers - "List my S2S servers."

  • Explore the brainCloud API - "What parameters does the Entity service's UpdateEntity method take?"

  • Run scripts - "Test the AwardCoins script."

  • brainCloud client integration - "Let's add leaderboards to the app."

Live App Safety

If your app is on a live plan, brainCloud's live-lock feature protects it from accidental changes. Claude will notify you if an app is live-locked and ask you to confirm an unlock via the brainCloud portal before making any write operations.

Tips

  • You can switch teams and apps at any time by asking Claude: "Switch to my OtherTeam and use the BetaApp."

  • Claude follows brainCloud's cloud code rules automatically - it uses the Rhino JS engine and will verify API method signatures before writing any script.

  • If you are unsure what a brainCloud service or method does, just ask Claude — it can look up the live documentation for your instance.

  • The brainCloud MCP doesn't just help with Cloud Code -- the MCP's knowledge of the API helps with writing your client apps too!

Need Help?

Visit the brainCloud portal or contact brainCloud support if you have trouble connecting or authenticating.

Did this answer your question?