Skip to main content

Connect your AI agent

Your agent reads, draws and edits your boards over MCP. bakermind has no built-in AI. MCP is in beta.

How it works

bakermind does not run an AI model. Your own agent app does, and it reaches your boards through MCP.

Connection

  1. Your agent app (the client) calls the bakermind MCP server over HTTPS.
  2. The first call is refused with a pointer to sign in. The client opens bakermind in your browser.
  3. You sign in and choose Allow access. The client keeps a token; bakermind never shows it to you or to this page.
  4. The agent then reads and draws on your boards, and each change returns a link to the board.

Before you start

  • A bakermind account (sign in or sign up in the browser).
  • An agent app that supports remote HTTP MCP with OAuth sign-in.
  • A browser on the same machine or phone that you can sign in with. A headless agent cannot finish the approval alone.

Add bakermind to your agent

Use this address as a remote HTTP (Streamable HTTP) MCP server. It holds no token or secret; you sign in in your browser.

MCP server URL
https://bakermind.vercel.app/api/mcp
Not yet verified

Claude

  1. Run the command below in Claude Code, then open /mcp, choose bakermind and sign in.
  2. Approve the request on the bakermind page.
Terminal
claude mcp add --transport http bakermind https://bakermind.vercel.app/api/mcp

These steps are for Claude Code. Claude on the web and desktop manages connectors in its own settings; we have not checked those steps, so follow Anthropic's current instructions and use the server URL above.

Disconnect: Run claude mcp remove bakermind. Claude Code also deletes the sign-in it stored. To only sign out, choose Clear authentication in the /mcp menu.

Every app here is marked not yet verified: no successful run with a client version, bakermind build and date is recorded yet, so the steps follow the standard remote MCP setup. Any other client with remote MCP and OAuth can use the URL above.

Your first board

Six steps from connected to verified. If a step fails, see the fixes below and retry that step.

  1. step 1

    Connect and approve

    Add the server, sign in to bakermind and choose Allow access. Ask the agent which bakermind tools it can see.

  2. step 2

    Ask for a sample

    The agent draws a board and replies with a link.

    Prompt
    Use bakermind to draw a flowchart of how a support ticket moves from new to resolved. Keep it to 6 steps and give me the board link.
  3. step 3

    Open the link

    Open the link, like /app?board=<id>, in a browser signed in to the same account. If it says you lack access, you are on another account.

  4. step 4

    Edit it by hand

    Move a shape or rename a step. The agent re-reads the board before it changes it, so your edit stays.

  5. step 5

    Ask the agent to update it

    Name the board and the change you want.

    Prompt
    Use bakermind to read that board again, keep my edits, and add an "escalated" step between in progress and resolved.
  6. step 6

    Verify the result

    Reload the board and check that your edit and the new step are both there. If something is missing, say what, and retry.

    Prompt
    Use bakermind to read the board and list every step in order, so I can check my edit and the new step are there.

What your agent gets

Find and read the boards in your account. Create new boards. Edit boards where you have editing permission. Public share links never give an agent editing permission.

guide
Explains the board formats and how to draw well.
search_boards
Finds your boards by title.
list_folders
Lists your folders to file a new board in.
create_folder
Creates a folder to group boards, e.g. one per idea.
duplicate_board
Copies a board to try a variant without touching the original.
restore_version
Undoes an AI edit by taking the board back to its saved Before AI edit version.
fix_board
Fixes near-miss alignment, tiny text and label overflow that lint found, in one call.
list_templates
Lists the starter templates.
create_board_from_template
Starts a board from a template (retro, checklist, flow) to edit.
move_board
Moves a board into a folder or out of it.
read_board
Reads a board as compact text or JSON.
create_diagram_from_text
Draws a new board from Mermaid-style text (up to 20,000 characters).
create_board
Creates a board from a full bakermind document (up to 500 nodes and edges).
lint_board
Checks a diagram for typos, orphans and overlaps.
update_diagram
Edits a flowchart, mind map or sequence from its text.
apply_ops
Edits any board with up to 100 atomic operations per call.
auto_layout
Rearranges a flowchart or whiteboard (mind maps and sequences arrange themselves).
render_board
Renders a board as an SVG or PNG image to check it.

If something goes wrong

The client says it is not signed in or gets a 401

This is the normal first response. The client should open the sign-in flow. If it does not, remove the server and add it again.

The approval page says the authorization is unavailable or expired

Go back to your AI tool and connect again. Each approval link works once and expires.

The client says access was denied or the sign-in was cancelled

That happens when Deny is chosen on the approval page, or the window is closed. Connect again from the client and choose Allow access. Nothing was shared in between.

The agent says [FORBIDDEN] editing permission is required

Boards shared with you as viewer cannot be edited. Ask the owner for edit access, or ask the agent to create a new board.

The agent says [STALE_REVISION], the board changed

Nothing was written. Ask the agent to read the board again and repeat the change.

The agent says [LOCKED_OBJECTS], some objects are locked

Unlock them in the editor, or ask the agent to unlock them first, then repeat the change.

The agent says [RATE_LIMITED], the rate limit was reached

Wait for the number of seconds in the message, then retry. The agent can do this on its own. Limits per minute: 120 reads, 60 writes, 20 renders.

A tool call fails and the message is unclear

Ask the agent to try the same step once more. If it fails again, check the server URL, then reconnect from the client. Nothing is written unless the agent reports success.

The agent says [BOARD_NOT_FOUND]

The board does not exist or your account cannot see it. Ask the agent to search your boards again, or open the board link while signed in to the same account.

The agent says [INVALID_ARGUMENTS], [INVALID_OPERATIONS] or [INVALID_INPUT]

The request was not valid, for example text over 20,000 characters, more than 100 operations or a board over 500 items. Nothing was written. The agent can fix the call from the message and retry.

The agent says [SAVE_FAILED], [UNAVAILABLE] or [INTERNAL]

A temporary problem on our side. Nothing was written when the message says so. Ask the agent to retry once, then read the board to check its state.

The agent says [AUTH_EXPIRED] or [AUTH_REQUIRED], or your sign-in expired mid-session

Reconnect from the client (for example /mcp in Claude Code) and approve again. Your boards are not affected.

To disconnect or revoke access, remove the bakermind server in your client, as shown under each app above (Claude Code: claude mcp remove bakermind). There is no list of connected apps inside bakermind yet, so removing it in the client is how you revoke access.

Give your agent a board.

Open bakermind, connect your agent, and draw.

Open the app