Webposto MCP

Webposto MCP Server

Servidor MCP (Model Context Protocol) para integração com WEBPOSTO - Sistema de Gestão de Postos de Combustível.

Descrição

Este servidor MCP permite que assistentes de IA interajam com o sistema WEBPOSTO para consultar informações sobre:

• Caixas e fechamentos
• Abastecimentos e vendas de combustível
• Estoque de produtos e tanques
• Despesas financeiras
• Movimentação de combustível (LMC)
• Status operacional do posto

Instalação

Pré-requisitos

• Python 3.8+
• uv (Python package manager)

Configuração

1. Clone o repositório:

git clone https://github.com/leopn08/webposto-mcp.git
cd webposto-mcp

1. Instale as dependências:

uv pip install -r requirements.txt

1. Configure as variáveis de ambiente:

cp .env.example .env
# Edite o arquivo .env e adicione sua API key do WEBPOSTO

1. Configure o servidor no Claude Desktop ou Claude Code:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webposto-mcp": {
      "command": "/path/to/webposto-mcp/start_webposto.sh"
    }
  }
}

Claude Code (~/.claude/mcp_servers.json):

{
  "mcpServers": {
    "webposto-mcp": {
      "command": "/path/to/webposto-mcp/start_webposto.sh"
    }
  }
}

Funcionalidades

Consultas Disponíveis

• webposto_consultar_caixas: Consulta informações de caixas no período
• webposto_consultar_abastecimentos: Consulta abastecimentos realizados
• webposto_consultar_vendas_resumo: Resumo de vendas por período
• webposto_consultar_vendas_combustivel: Vendas específicas de combustível
• webposto_consultar_vendas_itens: Vendas detalhadas por item
• webposto_consultar_estoque_produtos: Estoque atual de produtos
• webposto_consultar_estoque_periodo: Movimentação de estoque no período
• webposto_consultar_despesas_financeiro: Despesas financeiras da empresa
• webposto_consultar_tanques: Informações dos tanques de combustível
• webposto_consultar_lmc: Livro de Movimentação de Combustível
• webposto_status_operacional: Status operacional do posto

Configuração da API

O servidor está configurado para usar a API WEBPOSTO em:

• URL: https://web.qualityautomacao.com.br/INTEGRACAO
• Autenticação via header X-API-Key

Licença

MIT

Autor

Leandro Garcia