MCP Sankhya Server

Servidor MCP (Model Context Protocol) para integração com Sankhya ERP - Dashboard 208 de Planejamento de Importação.

🚀 Instalação

Opção 1: NPX (Recomendado)

npx @calimp/mcp-sankhya-server

Opção 2: Instalação Local

# Clone o repositório
git clone [seu-repo]
cd mcp

# Instale dependências
npm install

# Configure variáveis de ambiente
cp .env.example .env
# Edite .env com suas credenciais

# Compile e execute
npm run build
npm start

⚙️ Configuração

1. Variáveis de Ambiente

Crie um arquivo .env com suas credenciais:

# Sankhya API
SANKHYA_API_URL=https://api.sankhya.com.br
SANKHYA_TOKEN=seu_token_aqui
SANKHYA_APPKEY=sua_appkey_aqui
[email protected]
SANKHYA_PASSWORD=senha_segura

2. Configuração no Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "sankhya": {
      "command": "node",
      "args": ["/caminho/para/mcp/dist/index.js"],
      "env": {
        "SANKHYA_API_URL": "https://api.sankhya.com.br",
        "SANKHYA_TOKEN": "seu_token",
        "SANKHYA_APPKEY": "sua_appkey",
        "SANKHYA_USERNAME": "[email protected]",
        "SANKHYA_PASSWORD": "senha"
      }
    }
  }
}

Ou use via NPX:

{
  "mcpServers": {
    "sankhya": {
      "command": "npx",
      "args": ["-y", "@calimp/mcp-sankhya-server"],
      "env": {
        "SANKHYA_API_URL": "https://api.sankhya.com.br",
        "SANKHYA_TOKEN": "seu_token",
        "SANKHYA_APPKEY": "sua_appkey",
        "SANKHYA_USERNAME": "[email protected]",
        "SANKHYA_PASSWORD": "senha"
      }
    }
  }
}

🛠️ Ferramentas Disponíveis

searchProduct

Busca produtos no Dashboard 208 por nome ou código.

Parâmetros:

• query (string, obrigatório): Termo de busca
• searchBy (string, opcional): 'name', 'code', ou 'both' (padrão: 'both')
• limit (number, opcional): Máximo de resultados (padrão: 10)

Exemplos de uso:

"Busque produtos com fondue no nome"
"Qual o estoque do produto 45?"
"Mostre produtos da GERBER"

🧪 Testando

Com MCP Inspector

# Instale o inspector
npm install -g @modelcontextprotocol/inspector

# Execute o teste
npm run inspect

Teste Manual

# Modo desenvolvimento
npm run dev

# Produção
npm run build
npm start

📊 Estrutura de Resposta

O servidor retorna informações detalhadas dos produtos:

{
  codigo: string;
  nome: string;
  fornecedor: string;
  estoque: {
    disponivel: number;
    reservado: number;
    liquido: number;
    emRuptura: boolean;
  };
  medias: {
    ultimas3Quinzenas: number;
    ultimas5Quinzenas: number;
  };
  acao: {
    texto: string;
    urgencia: string;
  };
}

🔍 Troubleshooting

Erro de Autenticação

• Verifique se as credenciais estão corretas
• Confirme que o usuário tem acesso à API Sankhya
• Valide token e appkey com o administrador

Produtos não encontrados

• A view VW_DASHBOARD_PRODUTOS_RESUMO deve existir
• Verifique se o usuário tem permissão para acessar a view
• Confirme que existem produtos ativos no sistema

Timeout

• Verifique conexão com a internet
• Confirme que a URL da API está correta
• Aumente o timeout se necessário

📈 Roadmap

• [x] v1.0 - Busca básica de produtos
• [ ] v1.1 - Cache de resultados
• [ ] v1.2 - Filtros avançados (ruptura, urgência)
• [ ] v2.0 - Múltiplas views e análises

📝 Licença

MIT

👥 Suporte

Para suporte, entre em contato com a equipe Dashboard 208.