Hable con sus datos GSE-Web en lenguaje natural

El servidor MCP de GSE-Web conecta los asistentes de IA (Claude, ChatGPT, etc.) directamente a su aplicacion de gestion de stock. Haga preguntas, lance acciones, obtenga informes — sin escribir una sola linea de codigo.

55 herramientas 3 recursos 30 permisos

?Que es MCP?

MCP (Model Context Protocol) es un estandar abierto creado por Anthropic que permite a una IA conectarse a fuentes de datos externas de forma segura y estructurada.

Pienselo como un traductor universal: la IA habla en lenguaje natural, el servidor MCP traduce en solicitudes tecnicas (API, SQL) y devuelve los resultados en un formato que la IA comprende.

Vous (langage naturel) Claude / Assistant IA ↓ stdio Serveur MCP GSE-Web (local) ↓ HTTPS Serveur d'hébergement (proxies HTTPS) Bases de données GSE-Web
En resumen: escribe "?Que productos estan sin stock?" y la IA consulta directamente su base de datos GSE-Web para responder con datos reales.

?Por que usar el servidor MCP?

💬

Preguntas en lenguaje natural

Ya no necesita navegar por menus ni saber escribir SQL. Haga sus preguntas como se las haria a un companero.

Respuestas instantaneas

La IA analiza los datos y sintetiza los resultados. Un panel completo en una frase.

🔒

Seguridad preservada

Mismas reglas que la aplicacion: autenticacion JWT, permisos por rol (30 derechos), aislamiento por organizacion.

📝

Acciones automatizadas

Cree entradas/salidas de stock, cambie estados de albaranes — directamente desde la conversacion.

📈

Analisis inteligentes

Alertas de rotura, productos caducados, estadisticas — la IA cruza los datos y le avisa proactivamente.

🎓

Modulo de formacion

Los docentes pueden seguir las clases, escenarios y el progreso de los alumnos con una simple pregunta.

Sin MCP / Con MCP

Sin MCP

  • Abrir la aplicacion GSE-Web
  • Navegar por los menus
  • Aplicar filtros manualmente
  • Exportar a CSV, abrir Excel
  • Cruzar datos a mano
  • Escribir un informe

Con MCP

  • "Quels produits ont un stock < 5 dans le magasin Central ?"
  • L'IA repond en 3 secondes avec un tableau
  • "Compare les sorties de janvier et fevrier"
  • L'IA génère l'analyse directement
  • "Créeune entrée de 50 unites pour le produit REF-2024"
  • Action effectuee, confirmation instantanée

?Como funciona?

El servidor MCP es un proceso Node.js que se ejecuta localmente en su maquina (o de forma remota via HTTPS). Se autentica con GSE-Web usando sus credenciales y luego expone 55 herramientas que la IA puede llamar.

Votre machine (local) ↓ Claude + MCP Server Serveur d'hébergément (proxies HTTPS) Bases de données GSE-Web
Ningún puerto que abrir: el servidor MCP se comunica con Claude vía stdio (entrada/salida estándar) y con GSE-Web vía HTTPS. Sin servidor web local que exponer.

Requisitos previos

ElementoRequeridoNota
Node.jsv18 o superiornodejs.org
npmIncluido con Node.js-
Claude CodeCLI Anthropicnpm install -g @anthropic-ai/claude-code
Cuenta GSE-WebCredenciales válidasMismo login que la aplicación móvil/web
Conexión a internetPara alcanzar las APIs de GSE-Web

Instalacion paso a paso

Paso 1 — Compilar el servidor TypeScript

Abra un terminal en la carpeta del proyecto GSE-Web y ejecute:

cd mcp-server
npm install
npm run build

El resultado compilado esta en mcp-server/dist/.

Paso 2 — Verificar la configuracion

En la raiz del proyecto, ya hay un archivo .mcp.json configurado:

{
  "mcpServers": {
    "gse-web": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/chemin/vers/gse_web_mobile_v2/mcp-server",
      "env": {
        "GSE_PROXY_BASE_URL": "https://gse-web-dev.xlexe.com",
        "GSE_DEFAULT_SERVER": "https://dev.gse-web.online/"
      }
    }
  }
}
Adapte el campo cwd a la ruta real de la carpeta mcp-server en su máquina. Para producción, reemplace las URLs por https://gse-web.xlexe.com y https://www.gse-web.online/.

Paso 3 — Lanzar Claude Code

Desde la raiz del proyecto:

claude

Claude Code detecta automaticamente .mcp.json y propone activar el servidor gse-web. Acepte.

Paso 4 — Autenticarse

En la conversacion de Claude, escriba simplemente:

Connecte-moi au serveur de développement GSE-Web
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude llama a la herramienta authenticate y confirma su conexion con la lista de sus derechos.

Primer uso: ejemplos concretos

Una vez autenticado, haga sus preguntas en lenguaje natural. Aqui hay algunos ejemplos:

🔍 Rechercher des produits
"Cherche les produits contenant 'cable' dans la référence"

"Donne-moi les details du produit n°142 avec son stock par emplacement"

"Quelles sont les catégories de produits disponibles ?"

L'IA utilise search_products, get_product_details et get_catégories.

📦 Consulter les stocks
"Montre-moi le stock du magasin Central"

"Quels emplacements existent dans mon organisation ?"

"Y a-t-il des produits en rupture de stock ?"

L'IA utilise get_stock_levels, get_emplacements et get_stock_alerts.

🚚 Gérer les mouvements
"Liste les entrées de stock de cette semaine"

"Montre-moi les bons de mouvement a traiter"

"Affiche les details du bon de mouvement n°85"

L'IA utilise list_entrées, list_bon_mouvements et get_bon_mouvement_details.

✍️ Créer des opérations (droits requis)
"Créeune entrée de 50 unites du produit 142, emplacement A-03, magasin Central"

"Sortie de 10 unites du produit 98 avec le commentaire 'Chantier Bordeaux'"

"Passe le bon de mouvement 85 au statut 'termine'"

L'IA utilise create_entrée, create_sortie et update_bon_mouvement_statut.
Ces outils requierent des droits spécifiques (EDITER_ENTREE, EDITER_SORTIE, etc.).

📊 Obtenir des statistiques
"Donne-moi un résumé du tableau de bord : produits, stock, utilisateurs"

"Y a-t-il des produits qui périmént dans les 30 jours ?"

"Montre-moi les derniers logs d'erreur de l'application"

L'IA utilise get_dashboard_stats, get_stock_alerts et get_recent_logs.

🎓 Module formation
"Liste mes classes de formation"

"Quels scenarios pedagogiques sont disponibles ?"

"Montre la progression des eleves sur le scenario 12"

L'IA utilise list_classes, list_scenarios et get_student_progress.
Requiert le droit FORMATION_ENSEIGNANT.

Claude Code (CLI) — Interfaz principal

Claude Code es la interfaz recomendada para usar el servidor MCP. Detecta automaticamente la configuracion .mcp.json y ofrece activar el servidor.

Instalacion

npm install -g @anthropic-ai/claude-code

Uso

# Depuis la racine du projet GSE-Web
cd /chemin/vers/gse_web_mobile_v2

# Lancer Claude Code (detecte .mcp.json automatiquement)
claude

# Claude propose d'activer le serveur MCP "gse-web" → acceptez
# Vous pouvez ensuite discuter normalement :

> Connecte-moi au serveur dev avec login "admin" password "***"
> Quels produits sont en rupture de stock ?
> Créeune entrée de 20 unites pour le produit 45
Consejo: Claude Code mantiene el contexto de la conversación. Autentíquese una sola vez al inicio de la sesión y luego haga todas las preguntas que quiera.

Claude Desktop

Compatible con Claude Desktop (Windows/Mac). Configurelo anadiendo la seccion mcpServers al archivo de configuracion.

Configuracion

Edite el archivo de configuracion de Claude Desktop:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Anada la seccion mcpServers:

{
  "mcpServers": {
    "gse-web": {
      "command": "node",
      "args": ["/chemin/vers/mcp-server/dist/index.js"],
      "env": {
        "GSE_PROXY_BASE_URL": "https://gse-web-dev.xlexe.com",
        "GSE_DEFAULT_SERVER": "https://dev.gse-web.online/"
      }
    }
  }
}

Reinicie Claude Desktop. El servidor aparece en la lista de herramientas disponibles.

Claude.ai — Integracion directa (recomendado)

El método más sencillo y potente. Conecte Claude directamente a sus datos de GSE-Web desde claude.ai, sin instalar nada.

Para usuarios de Claude Pro, Max o Team: conecte directamente su servidor MCP via la interfaz claude.ai. No se requiere instalacion local.

🧠

Lenguaje natural

Claude (Opus, Sonnet, Haiku) comprende el lenguaje natural. Sin palabras clave que recordar, haga sus preguntas como se las diria a un companero.

💰

Incluido en su suscripcion

Sin coste adicional. La integracion MCP usa su suscripcion Claude existente (Pro, Max o Team).

🌐

100% en el navegador

Todo funciona en el navegador. Nada que descargar, nada que configurar en su maquina.

🔒

Seguridad de grado Claude

Autenticacion por sus credenciales GSE-Web. Aislamiento estricto por organizacion. Ningun dato es almacenado por el servidor MCP.

📝

Lectura + escritura

Consulte sus stocks y tambien cree entradas/salidas — con verificacion de derechos en cada accion.

📊

Analisis avanzados

Claude puede cruzar datos, comparar periodos, generar informes — tiene acceso a 55 herramientas especializadas.

Configuracion (una sola vez, 2 minutos)

Abrir Configuracion

Vaya a claude.ai y haga clic en el icono de engranaje en la parte inferior izquierda para abrir Configuracion.

Anadir una integracion

En la seccion Integraciones, haga clic en "Anadir integracion". Introduzca la URL del servidor MCP:

EntornoURL a copiar
Desarrollo / Demohttps://gse-web-dev.xlexe.com/api/mcp_remote.php
Producciónhttps://gse-web.xlexe.com/api/mcp_remote.php

La integracion aparece en su lista con el nombre "gse-web".

Autenticarse

En una nueva conversacion de Claude, diga simplemente:

Connecte-moi au serveur GSE-Web demo
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude llama a la herramienta authenticate y confirma su conexion con la lista de sus derechos.

¡Haga sus preguntas!

Esta conectado. Pregunte lo que quiera:

"Quels produits sont en rupture de stock ?"

"Montre-moi le stock sur l'emplacement HALLIDAY"

"Donne-moi le tableau de bord avec les chiffres clés"

"Liste les entrées de la semaine dernière"

"Créeune entrée de 50 gants isolants, emplacement A-03"

"Compare les sorties de janvier et fevrier"

Lo que Claude puede hacer con sus datos

🔍 Búsqueda y consulta
  • Buscar productos por referencia, nombre, categoría o código de barras
  • Ver el detalle de un producto con su stock por ubicación
  • Listar el stock filtrado por ubicación
  • Consultar las categorías y ubicaciones disponibles
📈 Análisis y alertas
  • Panel: número de productos, cantidad total, usuarios
  • Alertas de rotura de stock (productos con cantidad 0)
  • Alertas de caducidad (productos que caducan en 30 días)
  • Claude puede cruzar y analizar los resultados de varias herramientas para responder a preguntas complejas
🚚 Movimientos de stock
  • Histórico de entradas y salidas con filtros por fecha
  • Lista de albaranes de movimiento con filtro por estado
  • Crear entradas de stock (derecho EDITER_ENTREE requerido)
  • Crear salidas de stock (derecho EDITER_SORTIE requerido)

Claude siempre pedirá confirmación antes de crear una entrada o salida.

👥 Administración (derechos ADMIN)
  • Lista de usuarios de la organización
  • Consulta de derechos y roles

Diferencia con el Asistente Web

Asistente Web (chat básico)

  • Gratuito, sin suscripción
  • Comprensión por palabras clave
  • Botones de atajo predefinidos
  • Sin análisis cruzado
  • Respuestas formateadas simples

Claude.ai (IA completa)

  • Suscripción Claude requerida (Pro/Max/Team)
  • Comprensión total del lenguaje natural
  • Preguntas complejas y seguimiento de contexto
  • Análisis, comparación, síntesis de datos
  • Respuestas detalladas con explicaciones

Preguntas frecuentes

¿Cuesta algo extra?

No. La integración MCP está incluida en su suscripción Claude (Pro a 20 $/mes, Max a 100 $/mes, Team a 30 $/mes/usuario). Sin gastos adicionales por parte de GSE-Web.

¿Se envían mis datos a Anthropic?

Los datos transitan entre el servidor MCP y Claude para formular las respuestas. Anthropic no almacena los datos de las herramientas MCP y no los utiliza para entrenar sus modelos (política de privacidad de Anthropic). La conexión está cifrada en HTTPS de extremo a extremo.

¿Puede alguien acceder a mis datos con la URL del servidor MCP?

No. La URL del servidor MCP solo permite ver la lista de herramientas disponibles (nombres genéricos como "search_products"). Para acceder a cualquier dato, hay que autenticarse con un login y contraseña reales de GSE-Web. Es el mismo nivel de seguridad que una página de inicio de sesión.

¿Puedo compartir esta integración con mi equipo?

Sí. Cada miembro del equipo añade la URL en sus propios ajustes de Claude, luego se conecta con sus propias credenciales GSE-Web. Cada uno solo ve los datos de su organización.

¿Tengo que reconectarme en cada conversación?

, la autenticación GSE-Web es por conversación. Al inicio de cada nueva conversación, dígale a Claude que le conecte. La integración MCP en sí permanece configurada permanentemente en sus ajustes.

ChatGPT Custom GPT (cero instalación)

Un Custom GPT en ChatGPT permite a cualquier usuario chatear con los datos de GSE-Web directamente desde chat.openai.com. Sin instalación requerida.

Configuración por el administrador

Crear un Custom GPT

En ChatGPT, vaya a Explore GPTs → Create.

Añadir las instrucciones

Pegue estas instrucciones en el campo "Instructions" del GPT:

Tu es l'assistant GSE-Web, un expert en gestion de stock.
Tu aides les utilisateurs a interroger et gérer leurs données
de stock, produits, mouvements et bons de mouvement.

Regles :
1. Commence TOUJOURS par authentifier l'utilisateur (action authenticate)
2. Utilise le token recu pour toutes les requêtes suivantes
3. Reponds en francais, de manière claire et synthetique
4. Pour les tableaux de données, formate-les de manière lisible
5. Ne montre JAMAIS le token JWT a l'utilisateur
6. Pour les actions d'écriture, confirme AVANT d'executer

Configurar las Acciones

En la pestaña Actions, importe el esquema OpenAPI disponible en:

https://gse-web.xlexe.com/api/gse_assistant_openapi.json

La autenticación se realiza vía el header Authorization: Bearer gestionado automáticamente por el GPT después del login.

Publicar el GPT

Elija "Only people with a link" o "Anyone at [su organización]" para compartir con su equipo.

Uso por los empleados

El usuario simplemente abre el enlace del Custom GPT y chatea normalmente:

"Connecte-moi au serveur de production, login jean.dupont, mot de passe ***"
"Quels produits sont en rupture ?"
"Donne-moi le tableau de bord"
"Créeune entrée de 50 gants, emplacement A-03"

Asistente Web (sin IA)

El Asistente Web es una interfaz de consulta rápida con botones de atajo y búsqueda por palabras clave. No requiere ninguna suscripción de IA pero no utiliza inteligencia artificial.

Abrir el Asistente Web →

Acceso directo a la interfaz de chat (credenciales GSE-Web requeridas).

Otras herramientas compatibles

⚙️

n8n — Automatización →

Conecte GSE-Web a n8n para crear flujos automáticos: alertas de stock, informes, sync ERP. Guía completa disponible.

Cursor / Windsurf

IDE con IA integrada. Soportan el protocolo MCP para desarrolladores.

Cualquier cliente MCP

Cualquier software compatible con MCP puede conectarse al servidor local gse-web.

Referencia de herramientas

55 herramientas disponibles en el servidor MCP de GSE-Web.

Autenticación

HerramientaDescripciónAcceso
authenticate Conectarse a un servidor GSE-Web con login/contraseña Abierto
get_current_user Ver el perfil y los derechos del usuario conectado JWT
list_servers Información sobre el servidor del usuario conectado JWT

Productos & Stock (lectura)

HerramientaDescripciónAcceso
search_products Buscar productos por palabra clave (referencia, etiqueta, categoría) JWT
get_product_details Detalles completos de un producto con stock por ubicación JWT
get_stock_levels Niveles de stock con filtros por almacén / ubicación JWT
get_emplacements Lista de ubicaciones de almacenamiento JWT
get_catégories Categorías de productos distintas JWT

Movimientos (lectura)

HerramientaDescripciónAcceso
list_entrées Entradas de stock con filtros por fecha JWT
list_sorties Salidas de stock con filtros por fecha JWT
list_bon_mouvements Albaranes de movimiento con filtro por estado JWT
get_bon_mouvement_details Detalles completos de un albarán de movimiento JWT

Operaciones de escritura

HerramientaDescripciónAcceso
create_entrée Crear una entrada de stock (producto, cantidad, ubicación, magasins_id, no_lot...) EDITER_ENTREE
create_sortie Crear una salida de stock EDITER_SORTIE
update_bon_mouvement_statut Cambiar el estado de un albarán de movimiento EDITER_STATUTS_BDM

Usuarios & Organización

HerramientaDescripciónAcceso
list_users Lista de usuarios de la organización ADMIN
get_user_details Detalles de un usuario con grupos y derechos ADMIN
get_organisation_info Información sobre la organización actual JWT

Analítica & Monitoreo

HerramientaDescripciónAcceso
get_stock_alerts Alertas: roturas de stock, productos que caducan en 30 días JWT
get_dashboard_stats Estadísticas clave: nº productos, cantidad stock, nº usuarios JWT
get_recent_logs Últimos logs aplicativos con filtro por nivel SUPERADMIN

Formación

HerramientaDescripciónAcceso
list_classes Clases de formación FORMATION
list_scenarios Escenarios pedagógicos (prácticas) FORMATION
get_student_progress Progreso de los alumnos en un escenario FORMATION

Escenarios pedagógicos (escritura)

HerramientaDescripciónAcceso
create_scenario Crea un escenario pedagógico completo (etapas, recursos opcionales y enlaces de etapas) en una sola llamada; el total de puntos se recalcula como la suma de los puntos de las etapas FORMATION_ENSEIGNANT
add_scenario_ressource Añade un recurso (Vídeo, PDF, Esquema, Quiz, URL o Archivo) a un escenario existente, con sus enlaces de etapas FORMATION_ENSEIGNANT
link_quiz_to_scenario Asocia un quiz de biblioteca existente a un escenario (crea un recurso de tipo Quiz, leído por la aplicación para mostrar el quiz) FORMATION_ENSEIGNANT

Albaranes de recepción

HerramientaDescripciónAcceso
list_bons_reception Albaranes de recepción con % recepción, filtros por fecha y proveedor JWT
get_bon_reception_details Detalles de un albarán de recepción con estado por línea (recibido/parcial/pendiente) JWT

Pedidos clientes (OMS)

HerramientaDescripciónAcceso
list_commandes_clients Pedidos clientes del portal OMS con filtros por estado, fecha y cliente JWT
get_commande_client_details Detalles completos de un pedido cliente con líneas de productos JWT
get_oms_reconciliation_report Informe de conciliación OMS (solo lectura): pedidos validados sin orden de movimiento, órdenes sin líneas de detalle, explosiones de kits bloqueadas. JWT

Logística & Aprovisionamiento

HerramientaDescripciónAcceso
list_commandes_fournisseurs Pedidos de proveedores con filtros por estado JWT
get_commande_fournisseur_details Detalles del pedido con líneas (qty pedida/recibida/pendiente) JWT
get_reception_status Estado recepción: % recibido, líneas pendientes JWT
list_expeditions Expediciones con número de palets y albaranes vinculados JWT
get_expedition_details Detalles de expedición con albaranes vinculados y palets JWT
get_bon_reliquats Albaranes pendientes (-R1, -R2) de un albarán parcialmente preparado JWT
get_missing_quantities Cantidades faltantes (solicitadas - salidas) por línea JWT
list_ruptures Productos en rotura con estado y proveedor JWT
get_stock_history Histórico entradas/salidas de un producto en un período JWT
list_magasins Almacenes (depósitos) de la organización JWT

Terceros (Proveedores & Clientes)

HerramientaDescripciónAcceso
list_tiers Proveedores y clientes con filtros por tipo y búsqueda JWT
get_tiers_details Detalles completos de un tercero (30+ campos) JWT

Operaciones stock avanzadas

HerramientaDescripciónAcceso
modify_stock Modificar la cantidad de un stock existente EDITER_PRODUIT
change_emplacement Cambiar la ubicación de un stock EDITER_PRODUIT

Creación en masa (Bulk Create)

HerramientaDescripciónAcceso
bulk_create_tiers Crea en masa hasta 100 terceros (proveedores/clientes) en una sola llamada EDITER_FOURNISSEUR / EDITER_CLIENT
bulk_create_quiz_library Crea en masa hasta 50 cuestionarios de biblioteca con sus preguntas anidadas FORMATION_ENSEIGNANT
bulk_create_products Crea en masa productos (catálogo) en una sola llamada solo claude.ai EDITER_PRODUIT
bulk_create_entrees Crea en masa entradas de stock (recepciones) con validación posterior a la inserción solo claude.ai EDITER_ENTREE

Lotes y Trazabilidad

HerramientaDescripciónAcceso
list_lots Lista paginada de lotes (producto, estado de calidad, cantidad expedida, resto por controlar, caducidad) JWT
get_lot_details Detalle completo de un lote: info+estado, producto, entradas, salidas, stocks, historial de controles de calidad JWT
get_lot_tracking Panel de envejecimiento: edad de los lotes, vencimientos valorizados, estado de calidad, top 10 rotación, KPI JWT
get_product_composition Nomenclatura de un producto compuesto (kit): componentes + cantidad por ensamblaje JWT
list_composed_products Lista los productos compuestos (kits) con su nomenclatura y el número de ensamblajes disponibles JWT

Referencia: 3 recursos de contexto

Los recursos proporcionan contexto estático a la IA para entender mejor la aplicación GSE-Web.

URIDescripción
gse://schema/tables Estructura de la base de datos GSE-Web (tablas y relaciones principales)
gse://permissions/list Los 32 derechos disponibles con su descripción
gse://docs/api Resumen de los endpoints de la API REST (productos, stocks, movimientos...)

Seguridad

El servidor MCP aplica los mismos mecanismos de seguridad que la aplicacion GSE-Web.

🔑 Autenticacion JWT

Cada sesion comienza con una llamada authenticate. El JWT generado caduca al final de la sesion.

👥 Aislamiento de organizacion

Imposible acceder a los datos de otro cliente. Cada consulta SQL se filtra por organisations_id.

🛡️ 30 derechos granulares

Las herramientas de escritura verifican los derechos del usuario conectado. Sin el derecho EDITER_PRODUIT, es imposible crear una entrada.

🚫 Filtro SQL doble/triple

Servidores compartidos: id + org. Servidores dedicados: id + org + nombre del servidor.

⏱️ Rate limiting

60 lecturas/minuto, 10 escrituras/minuto por sesion. Protege contra abusos.

👁️ Logs trazables

Cada llamada a una herramienta se registra con marca de tiempo, usuario, herramienta y parametros. Pista de auditoria completa.

Importante: el servidor MCP se ejecuta localmente en su máquina. Sus credenciales nunca pasan por un servicio de terceros. La comunicación con GSE-Web se realiza en HTTPS directamente a los servidores seguros.

Casos de uso por rol

💼 Gestor de stock
  • "¿Qué productos tienen un stock inferior al umbral de alerta?"
  • "Muéstrame los 10 últimos movimientos del almacén Norte"
  • "Crea una entrada de 200 guantes aislantes, lote 2026-A, ubicación B-12"
  • "¿Cuántos productos diferentes tenemos en stock total?"
  • "¿Hay productos que caduquen pronto?"
💻 Administrador
  • "¿Cuántos usuarios están registrados en nuestra organización?"
  • "¿Qué derechos tiene el usuario n°23?"
  • "Muéstrame los logs de error de las últimas 24h"
  • "Dame las estadísticas globales del panel"
  • "¿A qué servidor estoy conectado?"
📚 Formador / Profesor
  • "Lista mis clases de formación"
  • "¿Qué escenarios de prácticas están disponibles?"
  • "Muestra el progreso de mis alumnos en el escenario 'Inventario completo'"
  • "¿Cuál es la nota media de la clase en la última práctica?"
🛠️ Técnico / Operador de campo
  • "Busca el producto con el código de barras 3700547800126"
  • "¿Cuál es el stock de este producto en la ubicación C-01?"
  • "Registra una salida de 5 unidades para la obra Lyon"
  • "¿Qué albaranes de movimiento están 'por tratar'?"
📊 Desarrollador / Integrador
  • "Muéstrame la estructura de la base de datos"
  • "¿Qué endpoints API están disponibles?" (recurso gse://docs/api)
  • "¿Cuál es el formato de respuesta de la API productos?"
  • "¿Cuántos derechos diferentes existen en el sistema?" (recurso gse://permissions/list)
  • Integre el servidor MCP en sus propias herramientas compatibles

FAQ

¿Se almacenan mis credenciales en algún sitio?

No. El servidor MCP no persiste nada en disco. El JWT obtenido tras la autenticación se mantiene en memoria únicamente durante la sesión. Cuando cierra Claude Code, todo se borra.

¿Puedo acceder a los datos de otra organización?

No. Todas las solicitudes incluyen un filtro organisations_id derivado de su JWT. Filtros adicionales impiden cualquier acceso fuera de su organización.

¿Puede la IA modificar mis datos sin mi consentimiento?

Claude Code siempre pide su aprobación antes de ejecutar una herramienta de escritura. Verá la herramienta y sus parámetros, y puede rechazar. Además, un limitador de velocidad limita las escrituras a 10/minuto.

¿Funciona el servidor MCP sin conexión?

No. El servidor MCP necesita conexión a internet para acceder a las APIs de GSE-Web.

¿Puedo usar el servidor MCP en producción?

Sí. Modifique las variables de entorno en .mcp.json:

"GSE_PROXY_BASE_URL": "https://gse-web.xlexe.com"
"GSE_DEFAULT_SERVER": "https://www.gse-web.online/"
¿Cuánto cuesta usar el servidor MCP?

El servidor MCP en sí es gratuito (código abierto, incluido en el proyecto). El coste está en el lado de la IA: necesita una suscripción a Claude (Pro, Team o Enterprise) para usar Claude Code o Claude Desktop.

¿Cómo actualizar el servidor MCP?

Tras un git pull del proyecto, basta con recompilar:

cd mcp-server && npm install && npm run build

Luego reinicie Claude Code.