Fonestar MCP Server

Servidor MCP (Model Context Protocol) para consultar el catálogo de productos Fonestar, y realizar pedidos desde asistentes de IA compatibles con MCP.

Accede a información de productos y pedidos.

📋 Requisitos

• Node.js 20.0.0 o superior
• Credenciales de Fonestar: API key, usuario y contraseña

🚀 Instalación

Opción 1: Instalación Global (Recomendado)

npm install -g @fonestar/mcp-server

Opción 2: Uso Directo con npx (Sin instalación)

No necesitas instalar el paquete, puedes usarlo directamente con npx en la configuración.

⚙️ Configuración

Claude Desktop

Edita tu archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Opción A: Con instalación global

{
  "mcpServers": {
    "fonestar": {
      "command": "fonestar-mcp",
      "env": {
        "FONESTAR_API_KEY": "tu_api_key_aqui",
        "FONESTAR_USERNAME": "[email protected]",
        "FONESTAR_PASSWORD": "tu_password_aqui"
      }
    }
  }
}

Opción B: Con npx (sin instalar)

{
  "mcpServers": {
    "fonestar": {
      "command": "npx",
      "args": ["-y", "@fonestar/mcp-server"],
      "env": {
        "FONESTAR_API_KEY": "tu_api_key_aqui",
        "FONESTAR_USERNAME": "[email protected]",
        "FONESTAR_PASSWORD": "tu_password_aqui"
      }
    }
  }
}

Reinicia Claude Desktop para aplicar los cambios.

Claude Code

Claude Code ofrece tres métodos de configuración:

Método 1: CLI (más rápido)

# Con instalación global
claude mcp add --transport stdio fonestar -- fonestar-mcp

# O con npx (sin instalar)
claude mcp add --transport stdio fonestar -- npx -y @fonestar/mcp-server

Luego configura las variables de entorno cuando Claude Code te lo solicite:

• FONESTAR_API_KEY: Tu API key
• FONESTAR_USERNAME: Tu usuario
• FONESTAR_PASSWORD: Tu contraseña

Método 2: Archivo de proyecto (compartido con el equipo)

Crea un archivo .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "fonestar": {
      "command": "npx",
      "args": ["-y", "@fonestar/mcp-server"],
      "env": {
        "FONESTAR_API_KEY": "${FONESTAR_API_KEY}",
        "FONESTAR_USERNAME": "${FONESTAR_USERNAME}",
        "FONESTAR_PASSWORD": "${FONESTAR_PASSWORD}"
      }
    }
  }
}

⚠️ Importante: Define las variables de entorno en tu sistema, NO en el archivo .mcp.json si lo compartes con el equipo.

Método 3: Configuración de usuario (scope user)

claude mcp add --scope user --transport stdio fonestar -- fonestar-mcp

Disponible en todos tus proyectos.

Cursor

Edita tu configuración de Cursor:

macOS/Linux: ~/.cursor/config.json Windows: %APPDATA%\Cursor\config.json

{
  "mcpServers": {
    "fonestar": {
      "command": "fonestar-mcp",
      "env": {
        "FONESTAR_API_KEY": "tu_api_key_aqui",
        "FONESTAR_USERNAME": "[email protected]",
        "FONESTAR_PASSWORD": "tu_password_aqui"
      }
    }
  }
}

Reinicia Cursor para aplicar los cambios.

💡 Uso

Una vez configurado, puedes consultar productos Fonestar desde tu asistente de IA:

Ejemplos de consultas:

Obtén información del artículo SONORA-3B

¿Qué características tiene el producto KS-06?

Muéstrame el precio y stock del MT-234

Compara los artículos SONORA-3B y KS-06

🔧 Troubleshooting

Error: "Faltan variables de entorno requeridas"

Causa: No configuraste las credenciales en las variables de entorno.

Solución: Verifica que FONESTAR_API_KEY, FONESTAR_USERNAME y FONESTAR_PASSWORD estén en tu archivo de configuración.

Error: "Invalid Fonestar credentials (401)"

Causa: Las credenciales son incorrectas.

Solución: Verifica que puedas iniciar sesión en https://clientes.fonestar.com con las mismas credenciales.

Error: "command not found: fonestar-mcp"

Causa: El paquete no está instalado globalmente o no está en el PATH.

Solución:

# Reinstala el paquete globalmente
npm install -g @fonestar/mcp-server

# O usa npx en la configuración en lugar de fonestar-mcp

🔒 Seguridad

• ✅ Ejecución local: El servidor MCP se ejecuta completamente en tu máquina
• ✅ Sin servidores externos: Tus credenciales nunca se envían a terceros
• ✅ HTTPS: Todas las comunicaciones con Fonestar usan HTTPS
• ✅ Credenciales locales: Se almacenan solo en tu configuración local

⚠️ Importante: No compartas tu archivo de configuración que contiene credenciales.

📄 Licencia

UNLICENSED - Copyright © 2025 Fonestar. Todos los derechos reservados.

Este software es propietario y confidencial. No se otorga licencia de uso, distribución o modificación sin permiso expreso por escrito de Fonestar.

Para consultas sobre licenciamiento, contacta: [email protected]

📞 Soporte

Para consultas sobre:

• Credenciales y acceso: Contacta a tu representante de Fonestar
• Problemas técnicos: [email protected]

🔗 Más Información

• Model Context Protocol: https://modelcontextprotocol.io
• Node.js: https://nodejs.org