LicenseSpring

Interaja com a API de Licenças e a API de Gerenciamento do LicenseSpring.

Documentação

Servidor MCP LicenseSpring®

Uma implementação de servidor MCP que se integra às APIs LicenseSpring, fornecendo recursos abrangentes de gerenciamento de licenças e operações de clientes.

Recursos

Operações de Licença: Ativar, verificar, desativar licenças com vínculo de hardware
Gerenciamento de Clientes: Criar, listar e gerenciar clientes
Rastreamento de Uso: Monitorar consumo de licenças e uso de recursos
Gerenciamento de Testes: Gerar e gerenciar licenças de teste
Licenças Flutuantes: Lidar com operações de licenças flutuantes
Prioridade de Autenticação: LICENSE_API_KEY como método principal, LICENSE_SHARED_KEY opcional para segurança aprimorada
Testes Abrangentes: Suíte completa de testes de integração com validação de API real

Ferramentas

Ferramentas da API de Licença

activate_license - Ativar uma licença com vínculo de ID de hardware
check_license - Verificar status e validade da licença
deactivate_license - Desativar uma licença para hardware específico
add_consumption - Adicionar unidades de consumo a uma licença
get_trial_key - Gerar chaves de licença de teste
get_product_details - Recuperar informações do produto
floating_release - Liberar licenças flutuantes
floating_borrow - Tomar emprestadas licenças flutuantes para uso offline
change_password - Alterar senhas de usuário para licenças baseadas em usuário
get_versions - Obter versões de software disponíveis
get_installation_file - Obter informações do arquivo de instalação
get_sso_url - Gerar URLs de Single Sign-On

Ferramentas da API de Gerenciamento

list_licenses - Listar licenças com filtragem opcional
create_license - Criar novas licenças
update_license - Atualizar licenças existentes
get_license - Obter informações detalhadas da licença
delete_license - Excluir licenças
list_customers - Listar clientes com opções de filtragem
create_customer - Criar novos clientes

Configuração

Obtendo Credenciais da API

Chave da API de Licença: Faça login no seu painel LicenseSpring → Configurações → Chaves (método de autenticação PRIMÁRIO)
Chave da API de Gerenciamento: No mesmo local, copie sua Chave da API de Gerenciamento
Chave Compartilhada: Opcional para organizações que usam configurações de API compartilhadas (fornece segurança aprimorada)

Testes

Execute o teste de integração abrangente para validar a funcionalidade:

# Build the project
npm run build

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

# Run unit tests
npm test

O teste de integração valida todas as 34 ferramentas MCP contra a API real LicenseSpring e verifica se a prioridade de autenticação funciona corretamente. A implementação fornece paridade de recursos de 100% com a coleção Postman LicenseSpring.

🔧 Integração CI/CD: Os fluxos de trabalho do GitHub Actions agora suportam testes de integração completos com configuração adequada de segredos.

Uso com Claude Desktop

Adicione isso ao seu claude_desktop_config.json:

Servidor da API de Licença

{
  "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 da API de Gerenciamento

{
  "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"
      }
    }
  }
}

Suporte a Níveis de Assinatura

O servidor se adapta automaticamente ao seu nível de assinatura LicenseSpring:

Premium/Empresarial: Funcionalidade completa com autenticação HMAC
Básico/Standard: Modo limitado com orientação útil de atualização
Desenvolvimento: Modo de teste para desenvolvimento seguro

Nota: LICENSE_SHARED_KEY é opcional. O servidor iniciará independentemente do seu nível de assinatura e fornecerá orientação apropriada para limitações da API.

Uso com VS Code

Para instalação rápida, use os botões de instalação com um clique abaixo:

Para instalação manual, adicione o seguinte bloco JSON ao seu arquivo de Configurações do Usuário (JSON) no 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}"
        }
      }
    }
  }
}

Solução de Problemas

Problemas Comuns

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

Solução: Atualize para a versão 1.0.1 ou posterior: npx @tfedorko/licensespring-mcp-server@latest
Causa: Corrigido na v1.0.1 - configuração binária e processo de inicialização aprimorados

Erro: "MCP error -1: Connection closed"

Solução: Atualize para a versão 1.0.2 ou posterior: npx @tfedorko/licensespring-mcp-server@latest
Causa: Corrigido na v1.0.2 - o servidor agora usa o modo license-api por padrão para compatibilidade com Claude Desktop

Erro: "LICENSE_API_KEY is required"

Solução: Defina suas variáveis de ambiente no arquivo .env ou na configuração do Claude Desktop
Verificação: Copie .env.example para .env e preencha suas credenciais da API

Erro: "Authentication failed"

Solução: Verifique suas chaves de API no painel LicenseSpring
Nota: LICENSE_SHARED_KEY é opcional para níveis de assinatura Básico/Standard

O servidor inicia, mas as chamadas de API falham

Verificação: Seu nível de assinatura LicenseSpring e recursos de API disponíveis
Solução: O servidor fornece orientação útil para limitações de assinatura

Obtendo Ajuda

Verifique as mensagens de erro - elas fornecem orientação específica
Verifique seu nível de assinatura LicenseSpring e acesso à API
Revise a Documentação Avançada abaixo
Abra um problema no GitHub com detalhes do erro

Automação de Lançamentos

Este projeto inclui versionamento automatizado abrangente de lançamentos e distribuição NPM:

Comandos Rápidos de Lançamento

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)

Visualizar Alterações

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

Lançamentos Automatizados do GitHub

Gatilhos de commit: Use [release] em mensagens de commit
Envio manual: Fluxo de trabalho do GitHub Actions
Lançamento semântico: Mensagens de commit convencionais

Para documentação completa de automação, consulte Guia de Automação de Lançamentos.

Documentação Avançada

Para guias abrangentes e configuração avançada:

Guia de Automação de Lançamentos - Sistema completo de lançamento e distribuição automatizados
Suporte a Níveis de Assinatura - Guia detalhado para diferentes níveis de assinatura LicenseSpring
Guia de Distribuição - Instruções completas de configuração e compartilhamento
Relatório de Testes - Resultados abrangentes de testes e validação
Guia de Migração - Detalhes técnicos de implementação

Instalação

Pacote NPM

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

Nota: Requer Node.js 20.x ou superior para compatibilidade ideal.

Imagens Docker

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

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

Build

Build Docker:

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

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.

Aviso de Marca Registrada

Este projeto usa o nome LicenseSpring® com permissão da Cense Data Inc. Consulte o arquivo TRADEMARK para detalhes.