Use Brainy Canvas inside your AI

Quick install

Run this command, choose the agent app you want to update, then restart that app. Your browser will open when it is time to sign in to Brainy Canvas and approve access.

npx add-mcp https://brainycanvas.com/mcp --name brainy-canvas -g

add-mcp is an independent, open source setup helper. It updates the local configuration for supported agent apps. It does not receive your Brainy Canvas password or replace Brainy Canvas sign-in. For the account-level connector in Claude Desktop or the built-in MCP settings in Codex desktop, use the desktop steps below.

Connection URL

If you prefer to set up the connection yourself, use this URL. Brainy Canvas hosts the MCP server, so there is no Brainy Canvas package or local server to run.

https://brainycanvas.com/mcp

Codex CLI

codex mcp add brainy-canvas --url https://brainycanvas.com/mcp
codex mcp login brainy-canvas --scopes canvas:read,canvas:write

# Confirm the connection
codex mcp list

Restart Codex after adding the server. Codex can call the tools and read resources; inline MCP App rendering depends on the Codex surface, so the tool also returns a complete text and structured-data fallback.

Codex desktop

Codex desktop, the Codex experience in the ChatGPT desktop app, shares MCP settings with the Codex CLI and IDE extension. You only need to add Brainy Canvas once.

1. Open Settings, then MCP servers.
2. Select Add server and name it Brainy Canvas.
3. Choose Streamable HTTP and enter https://brainycanvas.com/mcp.
4. Save the server, select Restart, then choose Authenticate when Brainy Canvas asks you to sign in.
5. In the composer, type /mcp to confirm Brainy Canvas is connected.

Claude Code

claude mcp add --transport http brainy-canvas   https://brainycanvas.com/mcp

# In Claude Code, inspect connected servers with:
/mcp

The first protected call opens Brainy Canvas sign-in. Claude Code returns to a temporary localhost callback after approval; the port can change on each login.

Claude Desktop and Claude on the web

Hosted connectors are linked to your Claude account, so the same Brainy Canvas connection works in Claude Desktop and on the web.

1. Open Customize, then Connectors. You can also go directly to claude.ai/customize/connectors.
2. Select the plus button, then Add custom connector.
3. Enter https://brainycanvas.com/mcp.
4. Add the connector, sign in to Brainy Canvas, and approve access.
5. In a conversation, select the plus button, open Connectors, and enable Brainy Canvas.

On Team and Enterprise plans, an Owner or Primary Owner must first add Brainy Canvas under Organization settings, then Connectors. Members can connect it from their own Customize, then Connectors page.

ChatGPT

1. Open Settings, then Security and loginand turn on Developer mode.
2. Open Settings, then Plugins. You can also go directly to chatgpt.com/plugins.
3. Select the plus button, create a developer-mode app, and use https://brainycanvas.com/mcp as the MCP server URL.
4. Complete Brainy Canvas sign-in. In a new chat, select the plus button, choose More, and add Brainy Canvas.

If the Developer mode switch is missing or unavailable, your workspace may not allow it. Ask your workspace administrator or use another MCP client. You can still use Brainy Canvas normally without Developer mode.

ChatGPT and Claude can both display MCP App interfaces. Brainy Canvas uses that shared standard to show the canvas and generated media inside the conversation when the client supports it.

Try these requests

Create a cinematic product photo of a cobalt-blue running shoe.

Make a five-second vertical video of a paper city unfolding at sunrise.

Find a Brainy Canvas template for turning research into social content,
remix it, and show me the canvas before running it.

Open my latest project, explain its nodes, then run it.

What your AI can use

• create_image and create_video for direct creative requests that should also create a canvas project.
• list_media_models, create_media_generation, and get_media_generation for durable asynchronous image and video jobs without creating a canvas.
• search_templates and remix_template for reusable workflows.
• Project, node, edge, upload, run, and output tools for precise canvas work.
• Prompts for image creation, video creation, and workflow building.
• An interactive Canvas Runner resource with graph and media previews.

Access and billing

canvas:read can inspect projects, templates, nodes, runs, and outputs. canvas:write can create, edit, upload, and run; generation calls use the same Brainy Canvas credits as the website. You can revoke a connection from Connected Apps in your account.

If sign-in does not open

1. Confirm the URL ends in /mcp, with no trailing slash and no token in the URL.
2. Remove an older Brainy Canvas entry that points to /api/mcp, then add the canonical URL again.
3. In Codex, run codex mcp login brainy-canvas explicitly.
4. Restart the client or start a new conversation after authenticating.
5. Make sure popups and localhost callback URLs are not blocked.

The older https://brainycanvas.com/api/mcp endpoint remains as a compatibility alias, but new installations should use /mcp. If a client only supports pasted API keys, use the REST API instead; never put a credential in the MCP URL.

Protocol details

• Streamable HTTP with MCP protocol negotiation.
• OAuth 2.1 authorization code flow with S256 PKCE.
• Client ID Metadata Documents (preferred) with DCR fallback.
• Audience-bound access tokens and rotating refresh tokens.
• RFC 9728 protected-resource metadata under /.well-known/.
• MCP Apps resources using text/html;profile=mcp-app.