# Sienge MCP Server
Um servidor Model Context Protocol (MCP) para integração com a API do Sienge, sistema de gestão para empresas de construção civil.
## 🚀 Funcionalidades
### 📊 Contas a Receber
- **get_sienge_accounts_receivable**: Lista contas a receber com filtros por período
- Utiliza a Bulk-data API do Sienge para consultas eficientes
- Suporte a filtros por data de vencimento e data de competência
### 🏢 Projetos e Empresas
- **get_sienge_projects**: Lista todos os projetos/empresas disponíveis
- Informações detalhadas incluindo ID, nome, endereço e status
### 📝 Notas Fiscais de Compra
- **get_sienge_purchase_invoices**: Lista todas as notas fiscais de compra
- **get_sienge_purchase_invoice_details**: Detalhes completos de uma nota fiscal específica
- **get_sienge_purchase_invoice_items**: Lista itens de uma nota fiscal
- **get_sienge_purchase_invoice_payments**: Lista pagamentos de uma nota fiscal
- **search_sienge_purchase_invoices**: Busca avançada com múltiplos filtros
### 🔍 Solicitações de Compra
- **get_sienge_purchase_requests**: Lista solicitações de compra do sistema
### 🗄️ Consultas Supabase
- **query_supabase_database**: Executa queries no banco de dados Supabase
- **get_supabase_table_info**: Obtém informações sobre tabelas disponíveis
- **search_supabase_data**: Busca universal em múltiplas tabelas
- Suporte a filtros, ordenação e busca textual/inteligente
- Schema fixo `sienge_data` para organização dos dados
### 🔍 Busca Universal
- **search_sienge_data**: Busca unificada em múltiplas entidades do Sienge
- **search_sienge_financial_data**: Busca avançada em dados financeiros
- **get_sienge_data_paginated**: Paginação avançada para grandes volumes
- **get_sienge_dashboard_summary**: Resumo executivo do sistema
## 📦 Instalação
### Via PyPI (Recomendado)
```bash
pip install sienge-ecbiesek-mcp
```
### Via Código Fonte
```bash
git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
cd Sienge-MCP
pip install -e .
```
## ⚙️ Configuração
### 1. Variáveis de Ambiente
Crie um arquivo `.env` no diretório do projeto com as seguintes variáveis:
```env
# Configurações da API do Sienge
SIENGE_BASE_URL=https://api.sienge.com.br
SIENGE_SUBDOMAIN=seu_subdominio
SIENGE_USERNAME=seu_usuario
SIENGE_PASSWORD=sua_senha
SIENGE_TIMEOUT=30
# Configurações do Supabase (opcional)
SUPABASE_URL=https://seu-projeto.supabase.co
SUPABASE_SERVICE_ROLE_KEY=sua_service_role_key
```
### 2. Configuração no Claude Desktop
#### Configuração Básica
Adicione ao seu arquivo de configuração do Claude Desktop (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"sienge-mcp": {
"command": "python",
"args": ["-m", "sienge_mcp"],
"env": {
"SIENGE_BASE_URL": "https://api.sienge.com.br",
"SIENGE_SUBDOMAIN": "seu_subdominio",
"SIENGE_USERNAME": "seu_usuario",
"SIENGE_PASSWORD": "sua_senha",
"SIENGE_TIMEOUT": "30"
}
}
}
}
```
#### Configuração com Virtual Environment
Se você estiver usando um ambiente virtual:
```json
{
"mcpServers": {
"sienge-mcp": {
"command": "C:/caminho/para/seu/venv/Scripts/python.exe",
"args": ["-m", "sienge_mcp"],
"env": {
"SIENGE_BASE_URL": "https://api.sienge.com.br",
"SIENGE_SUBDOMAIN": "seu_subdominio",
"SIENGE_USERNAME": "seu_usuario",
"SIENGE_PASSWORD": "sua_senha",
"SIENGE_TIMEOUT": "30"
}
}
}
}
```
## 🔐 Autenticação
### Credenciais do Sienge
A autenticação é feita através de **usuário e senha** do Sienge, não por token API:
1. **SIENGE_BASE_URL**: URL base da API (`https://api.sienge.com.br`)
2. **SIENGE_SUBDOMAIN**: Seu subdomínio no Sienge (ex: `suaempresa`)
3. **SIENGE_USERNAME**: Seu nome de usuário no Sienge
4. **SIENGE_PASSWORD**: Sua senha no Sienge
5. **SIENGE_TIMEOUT**: Timeout das requisições em segundos (padrão: 30)
### URLs da API
- **API Base**: `https://api.sienge.com.br`
- **Endpoints v1**: `/sienge/api/public/v1/`
- **Bulk-data API**: `/bulk-data/`
## 💻 Como Usar
### 1. Iniciando o Servidor
```bash
# Via módulo Python
python -m sienge_mcp
# Ou diretamente
sienge-mcp-server
```
### 2. No Claude Desktop
Após configurar o servidor, reinicie o Claude Desktop. O servidor MCP será automaticamente carregado e as ferramentas ficarão disponíveis.
### 3. Exemplos de Uso no Claude
#### Consultar Contas a Receber
```
"Liste as contas a receber com vencimento entre 01/01/2024 e 31/01/2024"
```
#### Buscar Projetos
```
"Mostre todos os projetos disponíveis no Sienge"
```
#### Consultar Notas Fiscais
```
"Liste as notas fiscais de compra do mês atual"
```
#### Busca Avançada de Notas Fiscais
```
"Busque notas fiscais de compra com valor acima de R$ 10.000,00 emitidas em dezembro de 2023"
```
## 🛠️ Desenvolvimento
### Estrutura do Projeto
```
src/
├── sienge_mcp/
│ ├── __init__.py
│ ├── server.py # Servidor MCP principal
│ ├── services/ # Serviços de integração
│ ├── tools/ # Ferramentas MCP
│ └── utils/
│ └── logger.py # Sistema de logging
```
### Executando em Modo de Desenvolvimento
```bash
# Clone o repositório
git clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git
cd Sienge-MCP
# Crie um ambiente virtual
python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # Linux/Mac
# Instale as dependências
pip install -e .
# Configure as variáveis de ambiente
cp .env.example .env
# Edite o arquivo .env com suas configurações
# Execute o servidor
python -m sienge_mcp
```
### Testando Localmente
```bash
# Instale as dependências de teste
pip install pytest pytest-asyncio
# Execute os testes
pytest tests/
```
## 📋 Requisitos
### Dependências
- Python >= 3.10
- fastmcp >= 2.12.3
- httpx >= 0.25.0
- pydantic >= 2.0.0
- python-dotenv >= 1.0.0
- supabase >= 2.0.0
### Compatibilidade
- ✅ Windows
- ✅ macOS
- ✅ Linux
- ✅ Claude Desktop
- ✅ Outros clientes MCP
## 🔧 Configurações Avançadas
### Logs e Debug
O servidor inclui sistema de logging configurável:
```python
# Nível de log via variável de ambiente
LOG_LEVEL=DEBUG # DEBUG, INFO, WARNING, ERROR
```
### Timeout de Requisições
Configure o timeout das requisições HTTP:
```python
# Timeout em segundos (padrão: 30s)
SIENGE_TIMEOUT=60
```
### Cache de Respostas
Para melhor performance em consultas frequentes:
```python
# Habilitar cache (padrão: False)
SIENGE_CACHE_ENABLED=true
SIENGE_CACHE_TTL=300 # TTL em segundos
```
## 🚨 Solução de Problemas
### Erros Comuns
#### Erro 401 - Unauthorized
```
Causa: Credenciais inválidas (usuário/senha incorretos)
Solução: Verifique seu usuário e senha no Sienge
```
#### Erro 404 - Not Found
```
Causa: Endpoint incorreto ou recurso não encontrado
Solução: Verifique as URLs base da API
```
#### Erro 429 - Rate Limited
```
Causa: Muitas requisições por minuto
Solução: Implemente delay entre requisições
```
#### Servidor MCP não conecta
```
1. Verifique se o Python está no PATH
2. Confirme se o módulo está instalado: pip show sienge-ecbiesek-mcp
3. Teste a execução manual: python -m sienge_mcp
4. Verifique os logs do Claude Desktop
```
### Debug
Para debugar problemas de conexão:
```bash
# Execute com logs detalhados
LOG_LEVEL=DEBUG python -m sienge_mcp
# Teste a conectividade com a API
# Use as credenciais do seu arquivo de configuração para testar
```
## 📚 Documentação da API
### Endpoints Utilizados
#### API Padrão (v1)
- `GET /enterprises` - Lista empresas/projetos
- `GET /purchase-requests` - Solicitações de compra
- `GET /purchase-invoices` - Notas fiscais de compra
- `GET /purchase-invoices/{id}` - Detalhes da nota fiscal
- `GET /purchase-invoices/{id}/items` - Itens da nota fiscal
- `GET /purchase-invoices/{id}/payments` - Pagamentos da nota fiscal
#### Bulk-data API
- `POST /income` - Contas a receber (bulk)
### Formatos de Data
- **ISO 8601**: `2024-01-01T00:00:00Z`
- **Brasileiro**: `01/01/2024`
- **Filtros de período**: `start_date` e `end_date`
### Códigos de Status
- `200` - Sucesso
- `400` - Requisição inválida
- `401` - Não autorizado
- `404` - Recurso não encontrado
- `429` - Rate limit excedido
- `500` - Erro interno do servidor
## 📄 Licença
Este projeto está licenciado sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
## 🤝 Contribuindo
1. Faça um fork do projeto
2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
4. Push para a branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request
## 📞 Suporte
- **Issues**: [GitHub Issues](https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues)
- **Documentação**: [Wiki do Projeto](https://github.com/INOTECH-ecbiesek/Sienge-MCP/wiki)
- **API Sienge**: [Documentação Oficial](https://api.sienge.com.br/docs)
## 📈 Versões
### v1.3.0 (Atual)
- ✅ **NOVO**: Integração completa com Supabase
- ✅ **NOVO**: 3 ferramentas de consulta ao banco de dados
- ✅ **NOVO**: Busca universal em múltiplas tabelas
- ✅ **NOVO**: Busca inteligente (textual + numérica)
- ✅ **NOVO**: Dashboard executivo do sistema
- ✅ **NOVO**: Paginação avançada para grandes volumes
- ✅ **NOVO**: Busca financeira unificada
- ✅ **MELHORADO**: Validação de parâmetros robusta
- ✅ **MELHORADO**: Tratamento de erros aprimorado
- ✅ **MELHORADO**: Documentação completa atualizada
### v1.2.3
- ✅ Adicionadas 5 ferramentas para Notas Fiscais de Compra
- ✅ Suporte à Bulk-data API para contas a receber
- ✅ Correção de endpoints para projetos/empresas
- ✅ Melhorias na documentação e tratamento de erros
### v1.0.0
- ✅ Versão inicial com ferramentas básicas
- ✅ Integração com API padrão do Sienge
- ✅ Suporte a contas a receber, projetos e solicitações de compra
---
**Desenvolvido por INOTECH-ecbiesek** 🚀
Raw data
{
"_id": null,
"home_page": null,
"name": "sienge-ecbiesek-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "sienge, mcp, model-context-protocol, claude, api, construction, erp, brazil, ecbiesek, fastmcp, ai-integration",
"author": null,
"author_email": "ECBIESEK <ti@ecbiesek.com>",
"download_url": "https://files.pythonhosted.org/packages/e3/01/9b542557d9e8d68aa38f95937b29aa3902b422428df28932e769a46400a8/sienge_ecbiesek_mcp-1.5.1.tar.gz",
"platform": null,
"description": "# Sienge MCP Server\r\n\r\nUm servidor Model Context Protocol (MCP) para integra\u00e7\u00e3o com a API do Sienge, sistema de gest\u00e3o para empresas de constru\u00e7\u00e3o civil.\r\n\r\n## \ud83d\ude80 Funcionalidades\r\n\r\n### \ud83d\udcca Contas a Receber\r\n- **get_sienge_accounts_receivable**: Lista contas a receber com filtros por per\u00edodo\r\n- Utiliza a Bulk-data API do Sienge para consultas eficientes\r\n- Suporte a filtros por data de vencimento e data de compet\u00eancia\r\n\r\n### \ud83c\udfe2 Projetos e Empresas\r\n- **get_sienge_projects**: Lista todos os projetos/empresas dispon\u00edveis\r\n- Informa\u00e7\u00f5es detalhadas incluindo ID, nome, endere\u00e7o e status\r\n\r\n### \ud83d\udcdd Notas Fiscais de Compra\r\n- **get_sienge_purchase_invoices**: Lista todas as notas fiscais de compra\r\n- **get_sienge_purchase_invoice_details**: Detalhes completos de uma nota fiscal espec\u00edfica\r\n- **get_sienge_purchase_invoice_items**: Lista itens de uma nota fiscal\r\n- **get_sienge_purchase_invoice_payments**: Lista pagamentos de uma nota fiscal\r\n- **search_sienge_purchase_invoices**: Busca avan\u00e7ada com m\u00faltiplos filtros\r\n\r\n### \ud83d\udd0d Solicita\u00e7\u00f5es de Compra\r\n- **get_sienge_purchase_requests**: Lista solicita\u00e7\u00f5es de compra do sistema\r\n\r\n### \ud83d\uddc4\ufe0f Consultas Supabase\r\n- **query_supabase_database**: Executa queries no banco de dados Supabase\r\n- **get_supabase_table_info**: Obt\u00e9m informa\u00e7\u00f5es sobre tabelas dispon\u00edveis\r\n- **search_supabase_data**: Busca universal em m\u00faltiplas tabelas\r\n- Suporte a filtros, ordena\u00e7\u00e3o e busca textual/inteligente\r\n- Schema fixo `sienge_data` para organiza\u00e7\u00e3o dos dados\r\n\r\n### \ud83d\udd0d Busca Universal\r\n- **search_sienge_data**: Busca unificada em m\u00faltiplas entidades do Sienge\r\n- **search_sienge_financial_data**: Busca avan\u00e7ada em dados financeiros\r\n- **get_sienge_data_paginated**: Pagina\u00e7\u00e3o avan\u00e7ada para grandes volumes\r\n- **get_sienge_dashboard_summary**: Resumo executivo do sistema\r\n\r\n## \ud83d\udce6 Instala\u00e7\u00e3o\r\n\r\n### Via PyPI (Recomendado)\r\n```bash\r\npip install sienge-ecbiesek-mcp\r\n```\r\n\r\n### Via C\u00f3digo Fonte\r\n```bash\r\ngit clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git\r\ncd Sienge-MCP\r\npip install -e .\r\n```\r\n\r\n## \u2699\ufe0f Configura\u00e7\u00e3o\r\n\r\n### 1. Vari\u00e1veis de Ambiente\r\nCrie um arquivo `.env` no diret\u00f3rio do projeto com as seguintes vari\u00e1veis:\r\n\r\n```env\r\n# Configura\u00e7\u00f5es da API do Sienge\r\nSIENGE_BASE_URL=https://api.sienge.com.br\r\nSIENGE_SUBDOMAIN=seu_subdominio\r\nSIENGE_USERNAME=seu_usuario\r\nSIENGE_PASSWORD=sua_senha\r\nSIENGE_TIMEOUT=30\r\n\r\n# Configura\u00e7\u00f5es do Supabase (opcional)\r\nSUPABASE_URL=https://seu-projeto.supabase.co\r\nSUPABASE_SERVICE_ROLE_KEY=sua_service_role_key\r\n```\r\n\r\n### 2. Configura\u00e7\u00e3o no Claude Desktop\r\n\r\n#### Configura\u00e7\u00e3o B\u00e1sica\r\nAdicione ao seu arquivo de configura\u00e7\u00e3o do Claude Desktop (`claude_desktop_config.json`):\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"sienge-mcp\": {\r\n \"command\": \"python\",\r\n \"args\": [\"-m\", \"sienge_mcp\"],\r\n \"env\": {\r\n \"SIENGE_BASE_URL\": \"https://api.sienge.com.br\",\r\n \"SIENGE_SUBDOMAIN\": \"seu_subdominio\",\r\n \"SIENGE_USERNAME\": \"seu_usuario\",\r\n \"SIENGE_PASSWORD\": \"sua_senha\",\r\n \"SIENGE_TIMEOUT\": \"30\"\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n#### Configura\u00e7\u00e3o com Virtual Environment\r\nSe voc\u00ea estiver usando um ambiente virtual:\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"sienge-mcp\": {\r\n \"command\": \"C:/caminho/para/seu/venv/Scripts/python.exe\",\r\n \"args\": [\"-m\", \"sienge_mcp\"],\r\n \"env\": {\r\n \"SIENGE_BASE_URL\": \"https://api.sienge.com.br\",\r\n \"SIENGE_SUBDOMAIN\": \"seu_subdominio\",\r\n \"SIENGE_USERNAME\": \"seu_usuario\",\r\n \"SIENGE_PASSWORD\": \"sua_senha\",\r\n \"SIENGE_TIMEOUT\": \"30\"\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n## \ud83d\udd10 Autentica\u00e7\u00e3o\r\n\r\n### Credenciais do Sienge\r\nA autentica\u00e7\u00e3o \u00e9 feita atrav\u00e9s de **usu\u00e1rio e senha** do Sienge, n\u00e3o por token API:\r\n\r\n1. **SIENGE_BASE_URL**: URL base da API (`https://api.sienge.com.br`)\r\n2. **SIENGE_SUBDOMAIN**: Seu subdom\u00ednio no Sienge (ex: `suaempresa`)\r\n3. **SIENGE_USERNAME**: Seu nome de usu\u00e1rio no Sienge\r\n4. **SIENGE_PASSWORD**: Sua senha no Sienge\r\n5. **SIENGE_TIMEOUT**: Timeout das requisi\u00e7\u00f5es em segundos (padr\u00e3o: 30)\r\n\r\n### URLs da API\r\n- **API Base**: `https://api.sienge.com.br`\r\n- **Endpoints v1**: `/sienge/api/public/v1/`\r\n- **Bulk-data API**: `/bulk-data/`\r\n\r\n## \ud83d\udcbb Como Usar\r\n\r\n### 1. Iniciando o Servidor\r\n```bash\r\n# Via m\u00f3dulo Python\r\npython -m sienge_mcp\r\n\r\n# Ou diretamente\r\nsienge-mcp-server\r\n```\r\n\r\n### 2. No Claude Desktop\r\nAp\u00f3s configurar o servidor, reinicie o Claude Desktop. O servidor MCP ser\u00e1 automaticamente carregado e as ferramentas ficar\u00e3o dispon\u00edveis.\r\n\r\n### 3. Exemplos de Uso no Claude\r\n\r\n#### Consultar Contas a Receber\r\n```\r\n\"Liste as contas a receber com vencimento entre 01/01/2024 e 31/01/2024\"\r\n```\r\n\r\n#### Buscar Projetos\r\n```\r\n\"Mostre todos os projetos dispon\u00edveis no Sienge\"\r\n```\r\n\r\n#### Consultar Notas Fiscais\r\n```\r\n\"Liste as notas fiscais de compra do m\u00eas atual\"\r\n```\r\n\r\n#### Busca Avan\u00e7ada de Notas Fiscais\r\n```\r\n\"Busque notas fiscais de compra com valor acima de R$ 10.000,00 emitidas em dezembro de 2023\"\r\n```\r\n\r\n## \ud83d\udee0\ufe0f Desenvolvimento\r\n\r\n### Estrutura do Projeto\r\n```\r\nsrc/\r\n\u251c\u2500\u2500 sienge_mcp/\r\n\u2502 \u251c\u2500\u2500 __init__.py\r\n\u2502 \u251c\u2500\u2500 server.py # Servidor MCP principal\r\n\u2502 \u251c\u2500\u2500 services/ # Servi\u00e7os de integra\u00e7\u00e3o\r\n\u2502 \u251c\u2500\u2500 tools/ # Ferramentas MCP\r\n\u2502 \u2514\u2500\u2500 utils/\r\n\u2502 \u2514\u2500\u2500 logger.py # Sistema de logging\r\n```\r\n\r\n### Executando em Modo de Desenvolvimento\r\n```bash\r\n# Clone o reposit\u00f3rio\r\ngit clone https://github.com/INOTECH-ecbiesek/Sienge-MCP.git\r\ncd Sienge-MCP\r\n\r\n# Crie um ambiente virtual\r\npython -m venv .venv\r\n.venv\\Scripts\\activate # Windows\r\nsource .venv/bin/activate # Linux/Mac\r\n\r\n# Instale as depend\u00eancias\r\npip install -e .\r\n\r\n# Configure as vari\u00e1veis de ambiente\r\ncp .env.example .env\r\n# Edite o arquivo .env com suas configura\u00e7\u00f5es\r\n\r\n# Execute o servidor\r\npython -m sienge_mcp\r\n```\r\n\r\n### Testando Localmente\r\n```bash\r\n# Instale as depend\u00eancias de teste\r\npip install pytest pytest-asyncio\r\n\r\n# Execute os testes\r\npytest tests/\r\n```\r\n\r\n## \ud83d\udccb Requisitos\r\n\r\n### Depend\u00eancias\r\n- Python >= 3.10\r\n- fastmcp >= 2.12.3\r\n- httpx >= 0.25.0\r\n- pydantic >= 2.0.0\r\n- python-dotenv >= 1.0.0\r\n- supabase >= 2.0.0\r\n\r\n### Compatibilidade\r\n- \u2705 Windows\r\n- \u2705 macOS \r\n- \u2705 Linux\r\n- \u2705 Claude Desktop\r\n- \u2705 Outros clientes MCP\r\n\r\n## \ud83d\udd27 Configura\u00e7\u00f5es Avan\u00e7adas\r\n\r\n### Logs e Debug\r\nO servidor inclui sistema de logging configur\u00e1vel:\r\n\r\n```python\r\n# N\u00edvel de log via vari\u00e1vel de ambiente\r\nLOG_LEVEL=DEBUG # DEBUG, INFO, WARNING, ERROR\r\n```\r\n\r\n### Timeout de Requisi\u00e7\u00f5es\r\nConfigure o timeout das requisi\u00e7\u00f5es HTTP:\r\n\r\n```python\r\n# Timeout em segundos (padr\u00e3o: 30s)\r\nSIENGE_TIMEOUT=60\r\n```\r\n\r\n### Cache de Respostas\r\nPara melhor performance em consultas frequentes:\r\n\r\n```python\r\n# Habilitar cache (padr\u00e3o: False)\r\nSIENGE_CACHE_ENABLED=true\r\nSIENGE_CACHE_TTL=300 # TTL em segundos\r\n```\r\n\r\n## \ud83d\udea8 Solu\u00e7\u00e3o de Problemas\r\n\r\n### Erros Comuns\r\n\r\n#### Erro 401 - Unauthorized\r\n```\r\nCausa: Credenciais inv\u00e1lidas (usu\u00e1rio/senha incorretos)\r\nSolu\u00e7\u00e3o: Verifique seu usu\u00e1rio e senha no Sienge\r\n```\r\n\r\n#### Erro 404 - Not Found\r\n```\r\nCausa: Endpoint incorreto ou recurso n\u00e3o encontrado\r\nSolu\u00e7\u00e3o: Verifique as URLs base da API\r\n```\r\n\r\n#### Erro 429 - Rate Limited\r\n```\r\nCausa: Muitas requisi\u00e7\u00f5es por minuto\r\nSolu\u00e7\u00e3o: Implemente delay entre requisi\u00e7\u00f5es\r\n```\r\n\r\n#### Servidor MCP n\u00e3o conecta\r\n```\r\n1. Verifique se o Python est\u00e1 no PATH\r\n2. Confirme se o m\u00f3dulo est\u00e1 instalado: pip show sienge-ecbiesek-mcp\r\n3. Teste a execu\u00e7\u00e3o manual: python -m sienge_mcp\r\n4. Verifique os logs do Claude Desktop\r\n```\r\n\r\n### Debug\r\nPara debugar problemas de conex\u00e3o:\r\n\r\n```bash\r\n# Execute com logs detalhados\r\nLOG_LEVEL=DEBUG python -m sienge_mcp\r\n\r\n# Teste a conectividade com a API\r\n# Use as credenciais do seu arquivo de configura\u00e7\u00e3o para testar\r\n```\r\n\r\n## \ud83d\udcda Documenta\u00e7\u00e3o da API\r\n\r\n### Endpoints Utilizados\r\n\r\n#### API Padr\u00e3o (v1)\r\n- `GET /enterprises` - Lista empresas/projetos\r\n- `GET /purchase-requests` - Solicita\u00e7\u00f5es de compra \r\n- `GET /purchase-invoices` - Notas fiscais de compra\r\n- `GET /purchase-invoices/{id}` - Detalhes da nota fiscal\r\n- `GET /purchase-invoices/{id}/items` - Itens da nota fiscal\r\n- `GET /purchase-invoices/{id}/payments` - Pagamentos da nota fiscal\r\n\r\n#### Bulk-data API\r\n- `POST /income` - Contas a receber (bulk)\r\n\r\n### Formatos de Data\r\n- **ISO 8601**: `2024-01-01T00:00:00Z`\r\n- **Brasileiro**: `01/01/2024`\r\n- **Filtros de per\u00edodo**: `start_date` e `end_date`\r\n\r\n### C\u00f3digos de Status\r\n- `200` - Sucesso\r\n- `400` - Requisi\u00e7\u00e3o inv\u00e1lida\r\n- `401` - N\u00e3o autorizado\r\n- `404` - Recurso n\u00e3o encontrado\r\n- `429` - Rate limit excedido\r\n- `500` - Erro interno do servidor\r\n\r\n## \ud83d\udcc4 Licen\u00e7a\r\n\r\nEste projeto est\u00e1 licenciado sob a licen\u00e7a MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.\r\n\r\n## \ud83e\udd1d Contribuindo\r\n\r\n1. Fa\u00e7a um fork do projeto\r\n2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)\r\n3. Commit suas mudan\u00e7as (`git commit -m 'Add some AmazingFeature'`)\r\n4. Push para a branch (`git push origin feature/AmazingFeature`)\r\n5. Abra um Pull Request\r\n\r\n## \ud83d\udcde Suporte\r\n\r\n- **Issues**: [GitHub Issues](https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues)\r\n- **Documenta\u00e7\u00e3o**: [Wiki do Projeto](https://github.com/INOTECH-ecbiesek/Sienge-MCP/wiki)\r\n- **API Sienge**: [Documenta\u00e7\u00e3o Oficial](https://api.sienge.com.br/docs)\r\n\r\n## \ud83d\udcc8 Vers\u00f5es\r\n\r\n### v1.3.0 (Atual)\r\n- \u2705 **NOVO**: Integra\u00e7\u00e3o completa com Supabase\r\n- \u2705 **NOVO**: 3 ferramentas de consulta ao banco de dados\r\n- \u2705 **NOVO**: Busca universal em m\u00faltiplas tabelas\r\n- \u2705 **NOVO**: Busca inteligente (textual + num\u00e9rica)\r\n- \u2705 **NOVO**: Dashboard executivo do sistema\r\n- \u2705 **NOVO**: Pagina\u00e7\u00e3o avan\u00e7ada para grandes volumes\r\n- \u2705 **NOVO**: Busca financeira unificada\r\n- \u2705 **MELHORADO**: Valida\u00e7\u00e3o de par\u00e2metros robusta\r\n- \u2705 **MELHORADO**: Tratamento de erros aprimorado\r\n- \u2705 **MELHORADO**: Documenta\u00e7\u00e3o completa atualizada\r\n\r\n### v1.2.3\r\n- \u2705 Adicionadas 5 ferramentas para Notas Fiscais de Compra\r\n- \u2705 Suporte \u00e0 Bulk-data API para contas a receber\r\n- \u2705 Corre\u00e7\u00e3o de endpoints para projetos/empresas\r\n- \u2705 Melhorias na documenta\u00e7\u00e3o e tratamento de erros\r\n\r\n### v1.0.0\r\n- \u2705 Vers\u00e3o inicial com ferramentas b\u00e1sicas\r\n- \u2705 Integra\u00e7\u00e3o com API padr\u00e3o do Sienge\r\n- \u2705 Suporte a contas a receber, projetos e solicita\u00e7\u00f5es de compra\r\n\r\n---\r\n\r\n**Desenvolvido por INOTECH-ecbiesek** \ud83d\ude80\r\n",
"bugtrack_url": null,
"license": null,
"summary": "\ud83c\udfd7\ufe0f Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction ERP system. Connect Claude AI to Sienge with 50+ powerful tools for comprehensive business management including financials, projects, operations, and Supabase database queries.",
"version": "1.5.1",
"project_urls": {
"Bug Reports": "https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues",
"Documentation": "https://github.com/INOTECH-ecbiesek/Sienge-MCP#readme",
"Homepage": "https://github.com/INOTECH-ecbiesek/Sienge-MCP",
"Issues": "https://github.com/INOTECH-ecbiesek/Sienge-MCP/issues",
"PyPI": "https://pypi.org/project/sienge-ecbiesek-mcp/",
"Repository": "https://github.com/INOTECH-ecbiesek/Sienge-MCP.git",
"Source Code": "https://github.com/INOTECH-ecbiesek/Sienge-MCP"
},
"split_keywords": [
"sienge",
" mcp",
" model-context-protocol",
" claude",
" api",
" construction",
" erp",
" brazil",
" ecbiesek",
" fastmcp",
" ai-integration"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d99f9375deffdefb0b8c77ddc9fb652d78b82b24578d09975fb07756cb964a0f",
"md5": "b87113d13a2be2689b29e30db3422e33",
"sha256": "baf04bc686efc936dcc4194cfc6bf8a6f596261a8c261beb18342f186f1e4792"
},
"downloads": -1,
"filename": "sienge_ecbiesek_mcp-1.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b87113d13a2be2689b29e30db3422e33",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 57416,
"upload_time": "2025-10-07T03:38:34",
"upload_time_iso_8601": "2025-10-07T03:38:34.678761Z",
"url": "https://files.pythonhosted.org/packages/d9/9f/9375deffdefb0b8c77ddc9fb652d78b82b24578d09975fb07756cb964a0f/sienge_ecbiesek_mcp-1.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e3019b542557d9e8d68aa38f95937b29aa3902b422428df28932e769a46400a8",
"md5": "12184a3d74bbdaaba72c290474b5e1c9",
"sha256": "a35dc89d1632946601541d54019b1448fb49cd781fec8320b0a5a6c7efeabd76"
},
"downloads": -1,
"filename": "sienge_ecbiesek_mcp-1.5.1.tar.gz",
"has_sig": false,
"md5_digest": "12184a3d74bbdaaba72c290474b5e1c9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 61426,
"upload_time": "2025-10-07T03:38:35",
"upload_time_iso_8601": "2025-10-07T03:38:35.958596Z",
"url": "https://files.pythonhosted.org/packages/e3/01/9b542557d9e8d68aa38f95937b29aa3902b422428df28932e769a46400a8/sienge_ecbiesek_mcp-1.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-07 03:38:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "INOTECH-ecbiesek",
"github_project": "Sienge-MCP",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "fastmcp",
"specs": [
[
">=",
"0.1.0"
]
]
},
{
"name": "httpx",
"specs": [
[
">=",
"0.25.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "fastapi",
"specs": [
[
">=",
"0.100.0"
]
]
},
{
"name": "uvicorn",
"specs": [
[
">=",
"0.31.0"
]
]
}
],
"lcname": "sienge-ecbiesek-mcp"
}
JSON
