Skip to content
← Back to blog

Connect your AI assistant to your Forge Mentor

6 min read
alphasetuptutorial

Welcome, alpha tester

If you got the invite, you already have what you need: an email address on the allowlist and an AI assistant of your choice. This walkthrough takes you from zero to a working session in under five minutes.

You only need two things:

  • The server address: https://mcp.mentor4ai.app/mcp
  • The same email you received the invite on (the magic link goes there)

That's it. No accounts to create, no API keys, no config files to edit.

Pick your path

There are two ways to connect:

  1. Paste the URL into a settings panel (Claude Desktop, ChatGPT, Copilot Studio). This is the friendliest option if you already use a desktop AI client.
  2. Run a single command (npx @brain-mcps/setup ...). This is the fastest option if you have a terminal open or use a CLI assistant like Gemini CLI, Codex, or Claude Code.

Pick the section below that matches the assistant you want to use.

Option A: Claude Desktop (recommended)

The smoothest path for non-technical testers.

  1. Open Claude Desktop. If it's your first time, sign in with your Anthropic account.
  2. Click the MCP plug icon in the bottom-left of the chat window, or go to Settings > Extensions.
  3. Click Add or Connect to a new server and paste: https://mcp.mentor4ai.app/mcp
  4. Claude Desktop opens your browser. Enter the email from your alpha invite.
  5. Check your inbox for a magic link. Click it.
  6. Return to Claude Desktop. The server should show as connected.

That's the whole thing. The tools become available in the chat instantly.

Option B: ChatGPT (web or Windows desktop)

Requires a ChatGPT Plus, Team, or Enterprise plan; free accounts can't add MCP servers yet.

  1. Open ChatGPT settings (profile icon, top-right).
  2. Go to Apps > Advanced > MCP Servers. If you don't see it, enable Developer Mode under Settings > Developer.
  3. Click Add MCP Server and paste: https://mcp.mentor4ai.app/mcp
  4. ChatGPT opens a browser tab. Enter your alpha invite email.
  5. Click the magic link in your inbox.
  6. Return to ChatGPT. The connection shows as active.

If the option doesn't appear, update the app to the latest version and check that Developer Mode is on.

Option C: Microsoft Copilot Studio

If your team already lives in the Microsoft ecosystem, this is the natural choice.

  1. Sign in to copilot.cloud.microsoft.
  2. Open or create an agent and go to its settings.
  3. Find MCP Servers (or Connected Services), then Add a custom MCP server.
  4. Paste: https://mcp.mentor4ai.app/mcp
  5. Authenticate with your alpha email and the magic link.

The agent's test panel will start showing tool calls as you chat with it.

Option D: CLI assistants (Gemini, Codex, Claude Code, Cursor, Windsurf)

Open a terminal and run one of these:

npx @brain-mcps/setup gemini mentor          # Gemini CLI
npx @brain-mcps/setup claude-code mentor     # Claude Code
npx @brain-mcps/setup codex mentor           # Codex (OpenAI CLI)
npx @brain-mcps/setup cursor mentor          # Cursor IDE
npx @brain-mcps/setup windsurf mentor        # Windsurf IDE
npx @brain-mcps/setup --detect mentor        # Configure every installed client at once

The command writes the right config entry for the client you picked, with the correct format (Gemini wants httpUrl, Windsurf wants serverUrl, etc.). When you next open the client, it triggers the OAuth flow and asks for your invite email. The magic link finishes it.

The mentor argument tells the CLI you want Forge Mentor; without it, the default is Cerebro Externo. To preview without writing files: append --dry-run. To list every supported client: npx @brain-mcps/setup --list.

Your first prompt

Once connected, try this:

"Start a new business development process. I want to validate a SaaS idea for freelance accountants."

Replace the topic with whatever you're actually building. The mentor will ask the questions, point at the next concrete experiment, and tell you what to do today. No frameworks to fill, no canvases to print.

You don't need to know the methodology. The mentor does.

Giving feedback

We need it. Anytime during your session, just tell the assistant:

"I have feedback about this experience."

It will collect what you say and submit it to us automatically. No forms, no separate tool. The fastest feedback loop is the one that fits inside the conversation you were already having.

Troubleshooting

Magic link didn't arrive. Check your spam folder. Make sure the email matches the one on your alpha invite (case doesn't matter). Magic links expire after ten minutes; if it expires, request a new one.

Tools don't appear in the chat. Close and reopen the client. Some clients cache the server list; a fresh launch picks up new tools.

Gemini CLI shows the server as disconnected. Gemini doesn't always prompt on launch. Type /mcp authenticate forge-mentor (or /mcp to check status), then complete the magic-link sign-in with your invite email.

"Unauthorized" error. Your invite may have expired, or the magic link wasn't completed. Re-run the connect flow; if it still fails, reply to your invite email and we'll check the allowlist.

Token expired mid-session. All clients refresh tokens automatically. Send another message; it should re-authenticate transparently.

The CLI command fails with "command not found". You need Node.js 18 or newer. Install it from nodejs.org, then re-run the command.

Need help?

Reply directly to your alpha invite email. That goes to a real human (me) and you'll get a real answer, usually within a day. Bug reports, suggestions, "this didn't work the way I expected", all of it is useful.

Welcome to the forge.