Getting Started

Get up and running with BridgeMind in under five minutes. Create your account, connect your first agent, and ship something.

This guide walks you through setting up BridgeMind from scratch. By the end, you'll have an AI coding agent connected to the BridgeMind platform, ready to manage projects and execute tasks through natural language.

Prerequisites

• A BridgeMind account — sign up at bridgemind.ai
• An AI coding agent — Cursor, Claude Code, Windsurf, or BridgeCode
• Node.js 18+ (for running MCP servers locally)

Step 1: Create Your Account

Head to bridgemind.ai and sign in with Google OAuth. Once you're in, you'll land on the BridgeMind dashboard where you can manage projects, tasks, and API keys.

Step 2: Generate an API Key

From the dashboard:

1. Navigate to Settings → API Keys
2. Click Generate New Key
3. Give your key a descriptive name (e.g., "Cursor MCP" or "Claude Code")
4. Copy the key — you'll need it in the next step

Your API key is scoped to your account. Any agent using this key can access your projects and tasks.

Step 3: Connect BridgeMCP

BridgeMCP is the Model Context Protocol server that gives your AI agent access to BridgeMind's project and task management tools. Pick your client below.

For advanced options (remote HTTP, project-scoped configs, and more), see the full BridgeMCP Installation guide.

{
  "mcpServers": {
    "bridgemind": {
      "command": "npx",
      "args": ["-y", "@bridgemind/mcp"],
      "env": {
        "BRIDGEMIND_API_KEY": "your_api_key_here"
      }
    }
  }
}

claude mcp add bridgemind -- npx -y @bridgemind/mcp

export BRIDGEMIND_API_KEY="your_api_key_here"

{
  "mcpServers": {
    "bridgemind": {
      "command": "npx",
      "args": ["-y", "@bridgemind/mcp"],
      "env": {
        "BRIDGEMIND_API_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "bridgemind": {
      "command": "npx",
      "args": ["-y", "@bridgemind/mcp"],
      "env": {
        "BRIDGEMIND_API_KEY": "your_api_key_here"
      }
    }
  }
}

codex mcp add bridgemind -- npx -y @bridgemind/mcp
export BRIDGEMIND_API_KEY="your_api_key_here"

bridgecode auth login

Step 4: Create Your First Project

With BridgeMCP connected, your agent now has access to BridgeMind tools. Ask your agent to create a project:

"Create a new BridgeMind project called 'My First App' with a description of 'A starter project to learn vibe coding.'"

Your agent will use the create_project tool to set this up. You'll see the project appear in your BridgeMind dashboard.

Step 5: Create a Task

Now create a task for your agent to work on:

"Create a task in the 'My First App' project: Build a simple REST API with Express that has a health check endpoint and a users CRUD endpoint. Use TypeScript."

The agent will create the task with your instructions. You can add knowledge context for more complex tasks:

"Add this knowledge to the task: We're using PostgreSQL for the database, Drizzle ORM for queries, and Zod for input validation. The project should follow a clean architecture pattern."

Step 6: Ship It

Tell your agent to pick up the task and start building:

"Pick up the first task in 'My First App' and start working on it."

The agent will:

1. Read the task instructions and knowledge
2. Update the task status to in-progress
3. Start writing code, creating files, and running commands
4. Mark the task in-review when it's done

Review the work, request changes if needed, and mark the task complete when you're happy.

What's Next

You're set up. Here's where to go from here:

• BridgeMCP — Learn about all available tools and advanced task workflows.
• BridgeCode — Install the full AI coding agent for terminal-first vibe coding.
• BridgeSpace — Download the desktop workspace for multi-terminal, multi-agent workflows.
• BridgeVoice — Add voice dictation to your workflow.
• Authentication — Deep dive into API keys, OAuth, and token management.