Skip to content
← Volver al blog

Conecta tu asistente de IA a tu Mentor de Forja

6 min de lectura
alphaconfiguracióntutorial

Bienvenido, alpha tester

Si recibiste la invitación, ya tienes lo que necesitas: un correo en la lista de acceso y un asistente de IA a tu elección. Esta guía te lleva de cero a una sesión funcionando en menos de cinco minutos.

Solo necesitas dos cosas:

  • La dirección del servidor: https://mcp.mentor4ai.app/mcp
  • El mismo correo donde recibiste la invitación (allí llega el enlace mágico)

Ya está. Sin cuentas que crear, sin claves de API, sin archivos de configuración que editar.

Elige tu camino

Hay dos formas de conectar:

  1. Pegar la URL en un panel de configuración (Claude Desktop, ChatGPT, Copilot Studio). Es la opción más amigable si ya usas un cliente de IA de escritorio.
  2. Ejecutar un solo comando (npx @brain-mcps/setup ...). Es la opción más rápida si ya tienes una terminal abierta o usas un asistente CLI como Gemini CLI, Codex o Claude Code.

Salta a la sección que coincida con el asistente que quieres usar.

Opción A: Claude Desktop (recomendado)

El camino más fluido para testers no técnicos.

  1. Abre Claude Desktop. Si es la primera vez, inicia sesión con tu cuenta de Anthropic.
  2. Haz clic en el ícono del enchufe MCP en la esquina inferior izquierda del chat, o ve a Configuración > Extensiones.
  3. Haz clic en Añadir o Conectar a un servidor nuevo y pega: https://mcp.mentor4ai.app/mcp
  4. Claude Desktop abrirá tu navegador. Ingresa el correo de tu invitación alpha.
  5. Revisa tu bandeja de entrada y haz clic en el enlace mágico.
  6. Regresa a Claude Desktop. El servidor debe aparecer como conectado.

Eso es todo. Las herramientas quedan disponibles en el chat al instante.

Opción B: ChatGPT (web o Windows desktop)

Requiere un plan ChatGPT Plus, Team o Enterprise; las cuentas gratuitas todavía no pueden añadir servidores MCP.

  1. Abre la configuración de ChatGPT (ícono de perfil, arriba a la derecha).
  2. Ve a Apps > Avanzado > Servidores MCP. Si no lo ves, activa el Modo Desarrollador en Configuración > Desarrollador.
  3. Haz clic en Añadir servidor MCP y pega: https://mcp.mentor4ai.app/mcp
  4. ChatGPT abre una pestaña del navegador. Ingresa tu correo de invitación alpha.
  5. Haz clic en el enlace mágico de tu bandeja.
  6. Regresa a ChatGPT. La conexión aparece como activa.

Si la opción no aparece, actualiza la aplicación a la última versión y verifica que el Modo Desarrollador esté activo.

Opción C: Microsoft Copilot Studio

Si tu equipo ya vive en el ecosistema Microsoft, esta es la opción natural.

  1. Inicia sesión en copilot.cloud.microsoft.
  2. Abre o crea un agente y entra a su configuración.
  3. Busca Servidores MCP (o Servicios conectados), luego Añadir servidor MCP personalizado.
  4. Pega: https://mcp.mentor4ai.app/mcp
  5. Autentícate con tu correo alpha y el enlace mágico.

El panel de prueba del agente empezará a mostrar llamadas a herramientas mientras chateas con él.

Opción D: Asistentes CLI (Gemini, Codex, Claude Code, Cursor, Windsurf)

Abre una terminal y ejecuta uno de estos:

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 los clientes instalados a la vez

El comando escribe la entrada de configuración correcta para el cliente que elegiste, con el formato adecuado (Gemini quiere httpUrl, Windsurf quiere serverUrl, etc.). La próxima vez que abras el cliente, este activa el flujo OAuth y te pide tu correo de invitación. El enlace mágico lo termina.

El argumento mentor le dice al CLI que quieres Mentor de Forja; sin él, la opción por defecto es Cerebro Externo. Para previsualizar sin escribir archivos: añade --dry-run. Para listar todos los clientes soportados: npx @brain-mcps/setup --list.

Tu primer prompt

Una vez conectado, prueba esto:

"Inicia un nuevo proceso de desarrollo de negocio. Quiero validar una idea SaaS para contadores freelance."

Cambia el tema por lo que estés construyendo en realidad. El mentor te hará las preguntas, te apuntará al siguiente experimento concreto y te dirá qué hacer hoy. Sin frameworks que llenar, sin canvas que imprimir.

No necesitas conocer la metodología. El mentor la conoce.

Enviando feedback

Lo necesitamos. En cualquier momento de la sesión, solo dile al asistente:

"Tengo feedback sobre esta experiencia."

El asistente recopila lo que digas y nos lo envía automáticamente. Sin formularios, sin herramientas aparte. El ciclo de feedback más rápido es el que cabe dentro de la conversación que ya estabas teniendo.

Solución de problemas

El enlace mágico no llegó. Revisa tu carpeta de spam. Asegúrate de que el correo coincida con el de tu invitación alpha (no importa mayúsculas/minúsculas). Los enlaces mágicos expiran a los diez minutos; si vence, solicita uno nuevo.

Las herramientas no aparecen en el chat. Cierra y vuelve a abrir el cliente. Algunos clientes cachean la lista de servidores; un reinicio recoge las herramientas nuevas.

Gemini CLI muestra el servidor como desconectado. Gemini no siempre lo pide al abrir. Escribe /mcp authenticate forge-mentor (o /mcp para ver el estado) y completa el inicio de sesión con el enlace mágico usando tu correo de invitación.

Error de "no autorizado". Puede que tu invitación haya expirado, o que el enlace mágico no se completó. Vuelve a ejecutar el flujo de conexión; si sigue fallando, responde a tu correo de invitación y revisaremos la lista.

El token expiró a mitad de sesión. Todos los clientes refrescan tokens automáticamente. Envía otro mensaje; debería re-autenticarse de forma transparente.

El comando CLI falla con "command not found". Necesitas Node.js 18 o superior. Instálalo desde nodejs.org y vuelve a ejecutar el comando.

¿Necesitas ayuda?

Responde directamente a tu correo de invitación alpha. Llega a un humano real (yo) y obtienes una respuesta real, normalmente en un día. Reportes de bugs, sugerencias, "esto no funcionó como esperaba", todo es útil.

Bienvenido a la forja.