Mcp Sgp

SGP MCP Server

MCP Server para integração com o SGP (Sistema de Gestão para Provedores) de internet, desenvolvido para rodar no Cloudflare Workers.

🚀 Funcionalidades

Este MCP Server expõe 50+ ferramentas para que assistentes de IA possam interagir com o SGP:

Clientes e Contratos

• Consultar clientes por CPF/CNPJ, telefone ou nome
• Listar e detalhar contratos
• Verificar status e pendências

Financeiro

• Listar faturas (abertas, pagas, vencidas)
• Gerar segunda via de faturas
• Consultar e gerar boletos

Suporte

• Abrir e gerenciar chamados
• Adicionar interações
• Atribuir a atendentes
• Finalizar atendimentos

Ordens de Serviço

• Criar OS de instalação, manutenção, etc.
• Agendar e reagendar serviços
• Transferir entre técnicos
• Consultar agenda de técnicos

FTTH (Rede Óptica)

• Gerenciar ONUs (provisionar, reiniciar, status)
• Consultar OLTs
• Gerenciar caixas (CTO/CEO)
• Consultar splitters

Estoque

• Listar produtos e categorias
• Registrar movimentações (entrada/saída)
• Consultar fornecedores
• Gerenciar inventários

RADIUS

• Gerenciar usuários RADIUS
• Bloquear/desbloquear conexões
• Monitorar sessões ativas
• Encerrar sessões
• Consultar accounting

📦 Instalação

1. Clone ou copie o projeto

# Se estiver usando como template
npm create cloudflare@latest -- sgp-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless
# Ou simplesmente copie os arquivos para seu projeto

2. Instale as dependências

cd sgp-mcp-server
npm install

3. Configure as credenciais

Edite o arquivo wrangler.toml ou use secrets:

# URL do seu SGP
wrangler secret put SGP_API_URL
# Digite: https://seu-provedor.sgp.net.br/api

# Para autenticação por Token (recomendado)
wrangler secret put SGP_TOKEN
wrangler secret put SGP_APP

# OU para autenticação Basic
wrangler secret put SGP_USERNAME
wrangler secret put SGP_PASSWORD

4. Deploy

# Login na Cloudflare
npx wrangler login

# Deploy
npx wrangler deploy

Após o deploy, seu MCP Server estará disponível em:

https://sgp-mcp-server..workers.dev

🔧 Configuração

Variáveis de Ambiente

| Variável | Descrição | Obrigatório | |----------|-----------|-------------| | SGP_API_URL | URL base da API do SGP | Sim | | SGP_AUTH_TYPE | Tipo de autenticação: basic ou token | Não (padrão: token) | | SGP_TOKEN | Token de API (se authtype=token) | Condicional | | SGP_APP | Nome do app (se authtype=token) | Condicional | | SGP_USERNAME | Usuário (se authtype=basic) | Condicional | | SGP_PASSWORD | Senha (se authtype=basic) | Condicional |

Exemplo de wrangler.toml

name = "sgp-mcp-server"
main = "src/index.ts"
compatibility_date = "2024-12-01"
compatibility_flags = ["nodejs_compat"]

[vars]
SGP_API_URL = "https://demo.sgp.net.br/api"
SGP_AUTH_TYPE = "token"

🔌 Conectando Clientes MCP

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "sgp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://sgp-mcp-server..workers.dev/sse"
      ]
    }
  }
}

Cloudflare AI Playground

1. Acesse: https://playground.ai.cloudflare.com/
2. Clique em "Add MCP Server"
3. Cole a URL: https://sgp-mcp-server..workers.dev/sse

Outros Clientes MCP

Use o endpoint /mcp para Streamable HTTP ou /sse para Server-Sent Events.

📚 Endpoints

| Endpoint | Descrição | |----------|-----------| | / ou /health | Health check | | /tools | Lista todas as ferramentas disponíveis | | /mcp | Endpoint MCP (Streamable HTTP) | | /sse | Endpoint MCP (Server-Sent Events) |

🛠️ Desenvolvimento Local

# Rodar localmente
npm run dev

# O servidor estará em http://localhost:8787

Para testar com o MCP Inspector:

npx @anthropic/mcp-inspector http://localhost:8787/sse

📋 Lista de Ferramentas

Clientes

• sgp_consultar_cliente - Consulta clientes por CPF/CNPJ, telefone ou nome
• sgp_detalhes_cliente - Detalhes completos de um cliente

Contratos

• sgp_listar_contratos - Lista contratos com filtros
• sgp_detalhes_contrato - Detalhes de um contrato
• sgp_consultar_contrato_resumido - Consulta rápida via URA

Faturas

• sgp_listar_faturas - Lista faturas com filtros
• sgp_detalhes_fatura - Detalhes de uma fatura
• sgp_segunda_via_fatura - Gera segunda via
• sgp_faturas_contrato - Faturas de um contrato (URA)
• sgp_listar_boletos - Lista boletos
• sgp_detalhes_boleto - Detalhes de um boleto
• sgp_gerar_boleto - Gera novo boleto

Chamados

• sgp_listar_chamados - Lista chamados com filtros
• sgp_detalhes_chamado - Detalhes de um chamado
• sgp_abrir_chamado - Abre novo chamado
• sgp_interagir_chamado - Adiciona interação
• sgp_atribuir_chamado - Atribui a atendente
• sgp_finalizar_chamado - Finaliza atendimento
• sgp_listar_categorias_chamado - Lista categorias
• sgp_listar_interacoes_chamado - Histórico de interações

Ordens de Serviço

• sgp_listar_ordens_servico - Lista OS com filtros
• sgp_detalhes_ordem_servico - Detalhes de uma OS
• sgp_criar_ordem_servico - Cria nova OS
• sgp_atualizar_status_ordem - Atualiza status (iniciar, pausar, finalizar, etc.)
• sgp_reagendar_ordem - Reagenda OS
• sgp_transferir_ordem - Transfere para outro técnico
• sgp_comentario_ordem - Adiciona comentário
• sgp_listar_comentarios_ordem - Lista comentários
• sgp_listar_tipos_os - Lista tipos de OS
• sgp_listar_tecnicos - Lista técnicos
• sgp_agenda_tecnico - Consulta agenda de técnico

FTTH

• sgp_listar_onus - Lista ONUs
• sgp_detalhes_onu - Detalhes de uma ONU
• sgp_provisionar_onu - Provisiona ONU
• sgp_desprovisionar_onu - Desprovisiona ONU
• sgp_reiniciar_onu - Reinicia ONU
• sgp_status_onu - Status em tempo real
• sgp_listar_olts - Lista OLTs
• sgp_detalhes_olt - Detalhes de uma OLT
• sgp_listar_caixas - Lista caixas (CTO/CEO)
• sgp_detalhes_caixa - Detalhes de uma caixa
• sgp_listar_splitters - Lista splitters
• sgp_detalhes_splitter - Detalhes de um splitter

Estoque

• sgp_listar_produtos - Lista produtos
• sgp_detalhes_produto - Detalhes de um produto
• sgp_listar_movimentacoes - Lista movimentações
• sgp_cadastrar_movimentacao - Registra entrada/saída
• sgp_listar_fornecedores - Lista fornecedores
• sgp_listar_categorias_estoque - Lista categorias
• sgp_listar_inventarios - Lista inventários
• sgp_detalhes_inventario - Detalhes de um inventário

RADIUS

• sgp_listar_usuarios_radius - Lista usuários RADIUS
• sgp_detalhes_usuario_radius - Detalhes de um usuário
• sgp_bloquear_usuario_radius - Bloqueia usuário
• sgp_desbloquear_usuario_radius - Desbloqueia usuário
• sgp_resetar_senha_radius - Reseta senha
• sgp_listar_sessoes_radius - Lista sessões
• sgp_detalhes_sessao_radius - Detalhes de uma sessão
• sgp_encerrar_sessao_radius - Encerra sessão
• sgp_listar_grupos_radius - Lista grupos
• sgp_listar_nas - Lista servidores NAS
• sgp_detalhes_nas - Detalhes de um NAS
• sgp_listar_accounting_radius - Histórico de accounting

📄 Licença

MIT

🤝 Suporte

Para dúvidas sobre a API do SGP, consulte a documentação oficial.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: thiagojbs
• Source: thiagojbs/mcp-sgp
• License: MIT

Install and usage instructions live in the source repository linked above.