Metadata-Version: 2.4
Name: sienge-ecbiesek-mcp
Version: 1.0.0
Summary: Sienge ECBIESEK MCP Server - Model Context Protocol integration for Sienge API (ECBIESEK Company)
Author-email: ECBIESEK <ti@ecbiesek.com>
License: MIT
Project-URL: Homepage, https://github.com/Moizas951/Sienge-mcp
Project-URL: Documentation, https://github.com/Moizas951/Sienge-mcp#readme
Project-URL: Repository, https://github.com/Moizas951/Sienge-mcp.git
Project-URL: Issues, https://github.com/Moizas951/Sienge-mcp/issues
Keywords: sienge,mcp,claude,api,construction,ecbiesek
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: license-file

# 🏗️ Sienge ECBIESEK MCP Server

[![PyPI version](https://badge.fury.io/py/sienge-ecbiesek-mcp.svg)](https://badge.fury.io/py/sienge-ecbiesek-mcp)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)

**Sienge ECBIESEK MCP Server** - Servidor MCP personalizado para a empresa ECBIESEK integrar com a API do Sienge através do Claude Desktop.

## 🚀 Instalação Rápida (ECBIESEK)

### Usando pipx (Recomendado)

```bash
# Executar diretamente sem instalação
pipx run sienge-ecbiesek-mcp

# Ou instalar permanentemente
pipx install sienge-ecbiesek-mcp
```

### Usando pip

```bash
pip install sienge-ecbiesek-mcp
```

## ⚙️ Configuração no Claude Desktop (ECBIESEK)

Adicione a seguinte configuração ao seu arquivo `claude_desktop_config.json`:

### Para pipx (Recomendado):
```json
{
  "mcpServers": {
    "SiengeECBIESEK": {
      "command": "pipx",
      "args": [
        "run",
        "sienge-ecbiesek-mcp@latest"
      ],
      "env": {
        "SIENGE_BASE_URL": "https://api.sienge.com.br",
        "SIENGE_SUBDOMAIN": "ecbiesek",
        "SIENGE_USERNAME": "seu-usuario-ecbiesek",
        "SIENGE_PASSWORD": "sua-senha-ecbiesek"
      }
    }
  }
}
```

### Para pip (instalação global):
```json
{
  "mcpServers": {
    "SiengeECBIESEK": {
      "command": "sienge-ecbiesek-mcp",
      "env": {
        "SIENGE_BASE_URL": "https://api.sienge.com.br",
        "SIENGE_SUBDOMAIN": "ecbiesek",
        "SIENGE_USERNAME": "seu-usuario-ecbiesek",
        "SIENGE_PASSWORD": "sua-senha-ecbiesek"
      }
    }
  }
}
```

## 🔐 Variáveis de Ambiente (ECBIESEK)

### Autenticação Basic Auth (Configuração ECBIESEK)
```bash
SIENGE_USERNAME=usuario_ecbiesek
SIENGE_PASSWORD=senha_ecbiesek
SIENGE_SUBDOMAIN=ecbiesek
SIENGE_BASE_URL=https://api.sienge.com.br
```

### Autenticação Bearer Token (Alternativa)
```bash
SIENGE_API_KEY=token_api_ecbiesek
SIENGE_BASE_URL=https://api.sienge.com.br
```

## 🛠️ Ferramentas Disponíveis

O servidor ECBIESEK fornece mais de 30 ferramentas para interagir com a API do Sienge:

### 📊 Relatórios e Listagens
- `listar_projetos` - Lista todos os projetos ECBIESEK
- `listar_contas` - Lista contas a pagar/receber
- `listar_centros_custo` - Lista centros de custo
- `listar_fornecedores` - Lista fornecedores
- `listar_colaboradores` - Lista colaboradores ECBIESEK

### 🏗️ Gestão de Projetos
- `obter_projeto` - Obtém detalhes de um projeto específico
- `listar_etapas_projeto` - Lista etapas de um projeto
- `listar_medicoes_projeto` - Lista medições de um projeto

### 💰 Financeiro
- `criar_conta_pagar` - Cria conta a pagar
- `atualizar_conta` - Atualiza conta existente
- `obter_detalhes_conta` - Obtém detalhes de uma conta

### 👥 Recursos Humanos ECBIESEK
- `obter_colaborador` - Obtém detalhes de um colaborador
- `listar_departamentos` - Lista departamentos
- `listar_cargos` - Lista cargos

### 📦 Estoque e Suprimentos
- `listar_produtos` - Lista produtos
- `obter_produto` - Obtém detalhes de um produto
- `listar_grupos_produto` - Lista grupos de produtos

### ⚙️ Configurações
- `obter_configuracoes_sistema` - Obtém configurações do sistema
- `listar_moedas` - Lista moedas disponíveis
- `obter_info_autenticacao` - Verifica status da autenticação

## 📝 Exemplos de Uso (ECBIESEK)

### Listar Projetos
```
Claude: Liste todos os projetos ativos da ECBIESEK no Sienge.
```

### Criar Conta a Pagar
```
Claude: Crie uma conta a pagar para o fornecedor XYZ no valor de R$ 1.500,00 com vencimento em 30 dias.
```

### Obter Relatório Financeiro
```
Claude: Me mostre um resumo das contas a pagar em aberto dos projetos da ECBIESEK.
```

## 🏢 Sobre a ECBIESEK

Este MCP Server foi desenvolvido especificamente para atender às necessidades da empresa ECBIESEK na integração com o sistema Sienge.

## 📋 Requisitos

- Python 3.9 ou superior
- Acesso à API do Sienge com credenciais ECBIESEK
- Claude Desktop instalado

## 🐛 Resolução de Problemas

### Erro de Autenticação
- Verifique se as credenciais ECBIESEK estão corretas
- Confirme se o subdomínio "ecbiesek" está correto
- Teste as credenciais diretamente na API do Sienge

### Timeout de Requisições
- Aumente o valor de `REQUEST_TIMEOUT`
- Verifique a conectividade com a API do Sienge

## 📄 Licença

MIT License - Desenvolvido para ECBIESEK

## 📞 Suporte ECBIESEK

- 📧 Email: ti@ecbiesek.com
- 🏢 Empresa: ECBIESEK
- 📖 Documentação interna

---

**⭐ Sienge ECBIESEK MCP Server - Solução personalizada para integração Sienge + Claude Desktop**
