Skip to content
← Voltar ao blog

Conecte seu assistente de IA ao seu Mentor de Forja

6 min de leitura
alphaconfiguraçãotutorial

Bem-vindo, alpha tester

Se você recebeu o convite, já tem o que precisa: um email na lista de acesso e um assistente de IA da sua escolha. Este guia te leva do zero a uma sessão funcionando em menos de cinco minutos.

Você só precisa de duas coisas:

  • O endereço do servidor: https://mcp.mentor4ai.app/mcp
  • O mesmo email onde você recebeu o convite (o link mágico vai pra lá)

Pronto. Sem contas pra criar, sem chaves de API, sem arquivos de configuração pra editar.

Escolha seu caminho

Há duas formas de conectar:

  1. Colar a URL num painel de configurações (Claude Desktop, ChatGPT, Copilot Studio). É a opção mais amigável se você já usa um cliente de IA de desktop.
  2. Rodar um único comando (npx @brain-mcps/setup ...). É a opção mais rápida se você já tem um terminal aberto ou usa um assistente CLI como Gemini CLI, Codex ou Claude Code.

Pule para a seção que combina com o assistente que você quer usar.

Opção A: Claude Desktop (recomendado)

O caminho mais suave para testers não técnicos.

  1. Abra o Claude Desktop. Se for sua primeira vez, faça login com sua conta da Anthropic.
  2. Clique no ícone do plugue MCP no canto inferior esquerdo do chat, ou vá em Configurações > Extensões.
  3. Clique em Adicionar ou Conectar a um servidor novo e cole: https://mcp.mentor4ai.app/mcp
  4. O Claude Desktop abre o seu navegador. Digite o email do seu convite alpha.
  5. Veja sua caixa de entrada e clique no link mágico.
  6. Volte ao Claude Desktop. O servidor deve aparecer como conectado.

É só isso. As ferramentas ficam disponíveis no chat na hora.

Opção B: ChatGPT (web ou Windows desktop)

Precisa de um plano ChatGPT Plus, Team ou Enterprise; contas gratuitas ainda não conseguem adicionar servidores MCP.

  1. Abra as configurações do ChatGPT (ícone de perfil, canto superior direito).
  2. Vá em Apps > Avançado > Servidores MCP. Se não aparecer, ative o Modo Desenvolvedor em Configurações > Desenvolvedor.
  3. Clique em Adicionar servidor MCP e cole: https://mcp.mentor4ai.app/mcp
  4. O ChatGPT abre uma aba do navegador. Digite seu email do convite alpha.
  5. Clique no link mágico da sua caixa de entrada.
  6. Volte ao ChatGPT. A conexão aparece como ativa.

Se a opção não aparecer, atualize o app pra última versão e verifique se o Modo Desenvolvedor está ligado.

Opção C: Microsoft Copilot Studio

Se seu time já vive no ecossistema Microsoft, essa é a escolha natural.

  1. Faça login em copilot.cloud.microsoft.
  2. Abra ou crie um agente e entre nas configurações.
  3. Encontre Servidores MCP (ou Serviços conectados), depois Adicionar servidor MCP personalizado.
  4. Cole: https://mcp.mentor4ai.app/mcp
  5. Autentique com seu email alpha e o link mágico.

O painel de teste do agente vai começar a mostrar chamadas de ferramentas enquanto você conversa com ele.

Opção D: Assistentes CLI (Gemini, Codex, Claude Code, Cursor, Windsurf)

Abra um terminal e rode um destes:

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          # IDE Cursor
npx @brain-mcps/setup windsurf mentor        # IDE Windsurf
npx @brain-mcps/setup --detect mentor        # Configurar todos os clientes instalados de uma vez

O comando escreve a entrada de configuração certa para o cliente que você escolheu, com o formato adequado (Gemini quer httpUrl, Windsurf quer serverUrl, etc.). Da próxima vez que você abrir o cliente, ele dispara o fluxo OAuth e pede seu email do convite. O link mágico finaliza.

O argumento mentor diz ao CLI que você quer o Mentor de Forja; sem ele, o padrão é Cérebro Externo. Para pré-visualizar sem escrever arquivos: acrescente --dry-run. Para listar todos os clientes suportados: npx @brain-mcps/setup --list.

Seu primeiro prompt

Uma vez conectado, tente isto:

"Inicie um novo processo de desenvolvimento de negócio. Quero validar uma ideia SaaS pra contadores freelancer."

Troque o tema pelo que você está construindo de verdade. O mentor vai te fazer as perguntas, apontar o próximo experimento concreto e te dizer o que fazer hoje. Sem frameworks pra preencher, sem canvas pra imprimir.

Você não precisa conhecer a metodologia. O mentor conhece.

Enviando feedback

A gente precisa. A qualquer momento na sessão, é só dizer ao assistente:

"Tenho feedback sobre esta experiência."

Ele coleta o que você disser e envia pra gente automaticamente. Sem formulários, sem ferramenta separada. O ciclo de feedback mais rápido é o que cabe dentro da conversa que você já estava tendo.

Solução de problemas

O link mágico não chegou. Olhe sua pasta de spam. Confirme que o email bate com o do seu convite alpha (não importa maiúsculas/minúsculas). Links mágicos expiram em dez minutos; se vencer, peça um novo.

As ferramentas não aparecem no chat. Feche e reabra o cliente. Alguns clientes cacheiam a lista de servidores; um reinício pega as ferramentas novas.

Gemini CLI mostra o servidor como desconectado. O Gemini nem sempre pede ao abrir. Digite /mcp authenticate forge-mentor (ou /mcp para ver o status) e conclua o login pelo link mágico com o email do seu convite.

Erro de "não autorizado". Seu convite pode ter expirado, ou o link mágico não foi concluído. Rode o fluxo de conexão de novo; se ainda falhar, responda ao seu email de convite e a gente confere a lista.

Token expirou no meio da sessão. Todos os clientes renovam tokens automaticamente. Mande outra mensagem; ele deve re-autenticar de forma transparente.

O comando CLI falha com "command not found". Você precisa de Node.js 18 ou superior. Instale em nodejs.org e rode o comando de novo.

Precisa de ajuda?

Responda direto ao seu email de convite alpha. Vai pra um humano de verdade (eu) e você recebe uma resposta de verdade, normalmente em um dia. Reportes de bug, sugestões, "isso não funcionou como eu esperava", tudo é útil.

Bem-vindo à forja.