1.1. Configuración del MCP con Goujana
Clase
Guía paso a paso
🌐 Paso 1 — Abrir la plataforma de Claude
Qué hay que hacer: Ingresa a la interfaz web de Claude para iniciar el proceso de integración.
Cómo hacerlo:
- Abre tu navegador web habitual.
- Ingresa a la página oficial de la inteligencia artificial Claude.
- Haz clic en la opción de Ingresar o accede utilizando tu cuenta de Google.
Qué deberías ver o sentir al terminar este paso: La pantalla principal o el chat de Claude abierto y listo para usar.
⚙️ Paso 2 — Agregar un conector personalizado
Qué hay que hacer: Añade los datos del servidor MCP de Goujana dentro de la configuración de conectores de Claude.
Cómo hacerlo:
- Dirígete al menú principal de la plataforma.
- Haz clic en la opción Personalizar conectores.
- Haz clic en el botón con el símbolo de + para Agregar conector personalizado.
- Escribe un nombre identificable (por ejemplo, Goujana MCP) en el campo de nombre.
- Escribe la URL del servidor MCP de Goujana en el campo correspondiente.
- Haz clic en el botón Agregar.
Qué deberías ver o sentir al terminar este paso: El sistema mostrará el conector creado y el botón para establecer la conexión.
🔑 Paso 3 — Obtener y vincular el token de acceso
Qué hay que hacer: Copia el token de autenticación desde tu cuenta de Goujana y pégalo en la ventana de conexión de Claude.
Cómo hacerlo:
- Abre una pestaña nueva e ingresa a tu cuenta de Goujana.
- Haz clic en la imagen de tu perfil y selecciona la opción Cuenta.
- Desplázate hacia abajo y haz clic en la sección Más información.
- Localiza el campo llamado App token y cópialo.
- Regresa a la pestaña de Claude y pega el código en el espacio App Token.
- Haz clic en el botón Conectar.
Qué deberías ver o sentir al terminar este paso: El conector se conectará exitosamente mostrando las opciones de herramientas disponibles.
🛡️ Paso 4 — Configurar los permisos de las herramientas
Qué hay que hacer: Define los niveles de autorización de lectura y escritura para que la inteligencia artificial interactúe con tus datos.
Cómo hacerlo:
- Visualiza las opciones de herramienta solo lectura y herramienta de escritura/eliminación.
- Configura las acciones de solo lectura seleccionando la opción Permitir todo si deseas que no solicite confirmación en cada consulta.
- Configura las herramientas de escritura o eliminación manteniendo activa la solicitud de aprobación por seguridad.
Qué deberías ver o sentir al terminar este paso: Los permisos quedarán configurados de forma segura para las futuras consultas y modificaciones mediante chat.
💬 Paso 5 — Realizar una consulta de prueba
Qué hay que hacer: Envía una pregunta basada en tus registros empresariales para comprobar el funcionamiento del sistema.
Cómo hacerlo:
- Ve a la sección de Nuevo chat en la interfaz de Claude.
- Escribe una pregunta sobre tus datos, por ejemplo, cuántos registros tienes en el año 2025.
- Haz clic en el botón Enviar.
Qué deberías ver o sentir al terminar este paso: Claude procesará la solicitud buscando en la base de datos de Goujana y entregará el resultado correspondiente en el chat.