# Mcp Sgp

> MCP Server do SGP

- **Type:** MCP server
- **Install:** `agentstack add mcp-thiagojbs-mcp-sgp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [thiagojbs](https://agentstack.voostack.com/s/thiagojbs)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [thiagojbs](https://github.com/thiagojbs)
- **Source:** https://github.com/thiagojbs/mcp-sgp

## Install

```sh
agentstack add mcp-thiagojbs-mcp-sgp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
# 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

```bash
cd sgp-mcp-server
npm install
```

### 3. Configure as credenciais

Edite o arquivo `wrangler.toml` ou use secrets:

```bash
# 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

```bash
# 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 auth_type=token) | Condicional |
| `SGP_APP` | Nome do app (se auth_type=token) | Condicional |
| `SGP_USERNAME` | Usuário (se auth_type=basic) | Condicional |
| `SGP_PASSWORD` | Senha (se auth_type=basic) | Condicional |

### Exemplo de wrangler.toml

```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`:

```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

```bash
# Rodar localmente
npm run dev

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

Para testar com o MCP Inspector:
```bash
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](https://documenter.getpostman.com/view/6682240/UzXKVyUs).

## 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](https://github.com/thiagojbs)
- **Source:** [thiagojbs/mcp-sgp](https://github.com/thiagojbs/mcp-sgp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-thiagojbs-mcp-sgp
- Seller: https://agentstack.voostack.com/s/thiagojbs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.