LicenseSpring

Interactúa con la API de Licencias y la API de Gestión de LicenseSpring.

Documentación

LicenseSpring® MCP Server

Una implementación de servidor MCP que se integra con las APIs de LicenseSpring, proporcionando capacidades integrales de gestión de licencias y operaciones de clientes.

Características

Operaciones de Licencias: Activar, verificar y desactivar licencias con vinculación de hardware
Gestión de Clientes: Crear, listar y gestionar clientes
Seguimiento de Uso: Monitorear el consumo de licencias y el uso de funciones
Gestión de Pruebas: Generar y gestionar licencias de prueba
Licencias Flotantes: Manejar operaciones de licencias flotantes
Prioridad de Autenticación: LICENSE_API_KEY como método principal, LICENSE_SHARED_KEY opcional para mayor seguridad
Pruebas Integrales: Suite completa de pruebas de integración con validación de API real

Herramientas

Herramientas de la API de Licencias

activate_license - Activar una licencia con vinculación de ID de hardware
check_license - Verificar el estado y la validez de la licencia
deactivate_license - Desactivar una licencia para hardware específico
add_consumption - Agregar unidades de consumo a una licencia
get_trial_key - Generar claves de licencia de prueba
get_product_details - Obtener información del producto
floating_release - Liberar licencias flotantes
floating_borrow - Tomar prestadas licencias flotantes para uso sin conexión
change_password - Cambiar contraseñas de usuario para licencias basadas en usuarios
get_versions - Obtener versiones de software disponibles
get_installation_file - Obtener información del archivo de instalación
get_sso_url - Generar URLs de inicio de sesión único (SSO)

Herramientas de la API de Gestión

list_licenses - Listar licencias con filtrado opcional
create_license - Crear nuevas licencias
update_license - Actualizar licencias existentes
get_license - Obtener información detallada de la licencia
delete_license - Eliminar licencias
list_customers - Listar clientes con opciones de filtrado
create_customer - Crear nuevos clientes

Configuración

Obtención de Credenciales de API

Clave de API de Licencias: Inicie sesión en su panel de LicenseSpring → Configuración → Claves (método de autenticación PRIMARIO)
Clave de API de Gestión: En la misma ubicación, copie su Clave de API de Gestión
Clave Compartida: Opcional para organizaciones que usan configuraciones de API compartidas (proporciona mayor seguridad)

Pruebas

Ejecute la prueba de integración integral para validar la funcionalidad:

# Build the project
npm run build

# Run integration tests against real LicenseSpring API
npm run test:integration

# Run unit tests
npm test

La prueba de integración valida las 34 herramientas MCP contra la API real de LicenseSpring y verifica que la prioridad de autenticación funcione correctamente. La implementación proporciona una paridad de funciones del 100% con la colección Postman de LicenseSpring.

🔧 Integración CI/CD: Los flujos de trabajo de GitHub Actions ahora admiten pruebas de integración completas con la configuración adecuada de secretos.

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json:

Servidor de API de Licencias

{
  "mcpServers": {
    "licensespring": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "license-api"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_IF_USING_SHARED_API_SETTINGS"
      }
    }
  }
}

Servidor de API de Gestión

{
  "mcpServers": {
    "licensespring-management": {
      "command": "npx",
      "args": [
        "-y",
        "@tfedorko/licensespring-mcp-server",
        "management-api"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "licensespring": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "LICENSE_API_KEY",
        "-e",
        "LICENSE_SHARED_KEY",
        "stiertfedorko/licensespring-mcp:latest"
      ],
      "env": {
        "LICENSE_API_KEY": "YOUR_LICENSE_API_KEY",
        "LICENSE_SHARED_KEY": "YOUR_SHARED_KEY_OR_LEAVE_EMPTY"
      }
    },
    "licensespring-management": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MANAGEMENT_API_KEY",
        "stiertfedorko/licensespring-mcp-management:latest"
      ],
      "env": {
        "MANAGEMENT_API_KEY": "YOUR_MANAGEMENT_API_KEY"
      }
    }
  }
}

Soporte de Niveles de Suscripción

El servidor se adapta automáticamente a su nivel de suscripción de LicenseSpring:

Premium/Enterprise: Funcionalidad completa con autenticación HMAC
Basic/Standard: Modo limitado con orientación útil para actualizar
Development: Modo de prueba para desarrollo seguro

Nota: LICENSE_SHARED_KEY es opcional. El servidor se iniciará independientemente de su nivel de suscripción y proporcionará orientación adecuada para las limitaciones de la API.

Uso con VS Code

Para una instalación rápida, use los botones de instalación con un clic a continuación:

Para instalación manual, agregue el siguiente bloque JSON a su archivo de Configuración de Usuario (JSON) en VS Code:

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "license_api_key",
        "description": "LicenseSpring License API Key",
        "password": true
      },
      {
        "type": "promptString",
        "id": "license_shared_key",
        "description": "LicenseSpring Shared Key (optional for Basic/Standard tiers)",
        "password": true
      }
    ],
    "servers": {
      "licensespring": {
        "command": "npx",
        "args": ["-y", "@tfedorko/licensespring-mcp-server", "license-api"],
        "env": {
          "LICENSE_API_KEY": "${input:license_api_key}",
          "LICENSE_SHARED_KEY": "${input:license_shared_key}"
        }
      }
    }
  }
}

Solución de Problemas

Problemas Comunes

Error: "npm error could not determine executable to run"

Solución: Actualice a la versión 1.0.1 o posterior: npx @tfedorko/licensespring-mcp-server@latest
Causa: Corregido en v1.0.1 - configuración binaria y proceso de inicio mejorados

Error: "MCP error -1: Connection closed"

Solución: Actualice a la versión 1.0.2 o posterior: npx @tfedorko/licensespring-mcp-server@latest
Causa: Corregido en v1.0.2 - el servidor ahora usa el modo license-api por defecto para compatibilidad con Claude Desktop

Error: "LICENSE_API_KEY is required"

Solución: Establezca sus variables de entorno en el archivo .env o en la configuración de Claude Desktop
Verificación: Copie .env.example a .env y complete sus credenciales de API

Error: "Authentication failed"

Solución: Verifique sus claves de API en el panel de LicenseSpring
Nota: LICENSE_SHARED_KEY es opcional para los niveles de suscripción Basic/Standard

El servidor se inicia pero las llamadas a la API fallan

Verificación: Su nivel de suscripción de LicenseSpring y las funciones de API disponibles
Solución: El servidor proporciona orientación útil para las limitaciones de suscripción

Obtención de Ayuda

Revise los mensajes de error: proporcionan orientación específica
Verifique su nivel de suscripción de LicenseSpring y el acceso a la API
Revise la Documentación Avanzada a continuación
Abra un issue en GitHub con los detalles del error

Automatización de Lanzamientos

Este proyecto incluye versionado automatizado integral de lanzamientos y distribución NPM:

Comandos Rápidos de Lanzamiento

npm run release          # Patch release (1.0.0 -> 1.0.1)
npm run release:minor    # Minor release (1.0.0 -> 1.1.0)
npm run release:major    # Major release (1.0.0 -> 2.0.0)

Vista Previa de Cambios

npm run version:dry      # Preview version bump
npm run publish:dry      # Preview NPM publish

Lanzamientos Automatizados de GitHub

Disparadores de commit: Use [release] en los mensajes de commit
Despacho manual: Flujo de trabajo de GitHub Actions
Lanzamiento semántico: Mensajes de commit convencionales

Para documentación completa de automatización, consulte la Guía de Automatización de Lanzamientos.

Documentación Avanzada

Para guías completas y configuración avanzada:

Guía de Automatización de Lanzamientos - Sistema completo de lanzamiento y distribución automatizados
Soporte de Niveles de Suscripción - Guía detallada para los diferentes niveles de suscripción de LicenseSpring
Guía de Distribución - Instrucciones completas de configuración y uso compartido
Informe de Pruebas - Resultados de pruebas integrales y validación
Guía de Migración - Detalles técnicos de implementación

Instalación

Paquete NPM

npm install -g @tfedorko/licensespring-mcp-server

Nota: Requiere Node.js 20.x o superior para una compatibilidad óptima.

Imágenes Docker

# License API Server
docker pull stiertfedorko/licensespring-mcp:latest

# Management API Server
docker pull stiertfedorko/licensespring-mcp-management:latest

Compilación

Compilación Docker:

docker build -t licensespring-mcp:latest -f Dockerfile .
docker build -t licensespring-mcp-management:latest -f Dockerfile.management .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.

Aviso de Marca Registrada

Este proyecto utiliza el nombre LicenseSpring® con permiso de Cense Data Inc. Consulte el archivo TRADEMARK para más detalles.