gestaoclick-mcp

# GestãoClick

### GestãoClick para Claude, ChatGPT e agentes de IA

ERP GestãoClick (sistema de gestão para PMEs) via API oficial: clientes, fornecedores, produtos e serviços, orçamentos, vendas, ordens de serviço, compras, notas fiscais (produto, consumidor, serviço) e financeiro (pagamentos, recebimentos, contas bancárias, planos de contas, centros de custos). Gere o par de chaves no painel em Meus aplicativos, API.

- 📊 **127 ferramentas**
- ✏️ **Leitura e escrita**
- 💬 **Funciona com qualquer cliente MCP**: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 **Login via magic-link (sem senha)**

[English version](README.en.md) · [Documentação completa](docs/) · [Skill pra agentes](skills/)

---

## Instalar em 1 clique

### Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em `claude.ai/customize/connectors`. **O mesmo link serve pra Claude Web e Claude Desktop** (basta estar logado):

[➕ Abrir no Claude e conectar](https://claude.ai/new?modal=add-custom-connector#settings/customize-connectors)

**Manual** (se o deeplink não abrir): [claude.ai/customize/connectors](https://claude.ai/customize/connectors?surface=cowork) → **+** → **Adicionar conector personalizado** → cole **Nome** `GestãoClick` e **URL** `https://api.mcp.ai/p_gestaoclick`.

### Cursor

[➕ Instalar GestãoClick no Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=gestaoclick&config=eyJ1cmwiOiJodHRwczovL2FwaS5tY3AuYWkvcF9nZXN0YW9jbGljayJ9)

### VS Code (Copilot Chat)

[➕ Instalar GestãoClick no VS Code](vscode:mcp/install?name=gestaoclick&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.mcp.ai%2Fp_gestaoclick%22%7D)

### ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte **MCP over HTTP**. A URL do servidor é sempre:

```
https://api.mcp.ai/p_gestaoclick
```

Detalhes por cliente: [INSTALL.md](INSTALL.md).

---

## Exemplos de uso

```
Liste meus últimos clientes no GestãoClick
Quais vendas foram feitas este mês?
Mostre as contas a receber em aberto
```

---

## 127 ferramentas disponíveis

| Tool | Descrição |
|---|---|
| `gestaoclick_list_accounts` | Lista as conexões (contas) GestãoClick vinculadas a este install — id, label. |
| `gestaoclick_atributos_cadastros_create` | Campos extras de cadastros: Cadastrar (POST /api/atributos_cadastros). |
| `gestaoclick_atributos_cadastros_delete` | Campos extras de cadastros: Deletar (DELETE /api/atributos_cadastros/{id}). |
| `gestaoclick_atributos_cadastros_get` | Campos extras de cadastros: Visualizar (GET /api/atributos_cadastros/{id}). |
| `gestaoclick_atributos_cadastros_list` | Campos extras de cadastros: Listar (GET /api/atributos_cadastros). |
| `gestaoclick_atributos_cadastros_update` | Campos extras de cadastros: Editar (PUT /api/atributos_cadastros/{id}). |
| `gestaoclick_atributos_financeiros_create` | Campos extras financeiros: Cadastrar (POST /api/atributos_financeiros). |
| `gestaoclick_atributos_financeiros_delete` | Campos extras financeiros: Deletar (DELETE /api/atributos_financeiros/{id}). |
| `gestaoclick_atributos_financeiros_get` | Campos extras financeiros: Visualizar (GET /api/atributos_financeiros/{id}). |
| `gestaoclick_atributos_financeiros_list` | Campos extras financeiros: Listar (GET /api/atributos_financeiros). |
| `gestaoclick_atributos_financeiros_update` | Campos extras financeiros: Editar (PUT /api/atributos_financeiros/{id}). |
| `gestaoclick_atributos_orcamentos_create` | Campos extras de orçamentos: Cadastrar (POST /api/atributos_orcamentos). |
| `gestaoclick_atributos_orcamentos_delete` | Campos extras de orçamentos: Deletar (DELETE /api/atributos_orcamentos/{id}). |
| `gestaoclick_atributos_orcamentos_get` | Campos extras de orçamentos: Visualizar (GET /api/atributos_orcamentos/{id}). |
| `gestaoclick_atributos_orcamentos_list` | Campos extras de orçamentos: Listar (GET /api/atributos_orcamentos). |
| `gestaoclick_atributos_orcamentos_update` | Campos extras de orçamentos: Editar (PUT /api/atributos_orcamentos/{id}). |
| `gestaoclick_atributos_ordens_servicos_create` | Campos extras ordens serviço: Cadastrar (POST /api/atributos_ordens_servicos). |
| `gestaoclick_atributos_ordens_servicos_delete` | Campos extras ordens serviço: Deletar (DELETE /api/atributos_ordens_servicos/{id}). |
| `gestaoclick_atributos_ordens_servicos_get` | Campos extras ordens serviço: Visualizar (GET /api/atributos_ordens_servicos/{id}). |
| `gestaoclick_atributos_ordens_servicos_list` | Campos extras ordens serviço: Listar (GET /api/atributos_ordens_servicos). |
| `gestaoclick_atributos_ordens_servicos_update` | Campos extras ordens serviço: Editar (PUT /api/atributos_ordens_servicos/{id}). |
| `gestaoclick_atributos_produtos_create` | Campos extras de produtos: Cadastrar (POST /api/atributos_produtos). |
| `gestaoclick_atributos_produtos_delete` | Campos extras de produtos: Deletar (DELETE /api/atributos_produtos/{id}). |
| `gestaoclick_atributos_produtos_get` | Campos extras de produtos: Visualizar (GET /api/atributos_produtos/{id}). |
| `gestaoclick_atributos_produtos_list` | Campos extras de produtos: Listar (GET /api/atributos_produtos). |
| `gestaoclick_atributos_produtos_update` | Campos extras de produtos: Editar (PUT /api/atributos_produtos/{id}). |
| `gestaoclick_atributos_vendas_create` | Campos extras vendas: Cadastrar (POST /api/atributos_vendas). |
| `gestaoclick_atributos_vendas_delete` | Campos extras vendas: Deletar (DELETE /api/atributos_vendas/{id}). |
| `gestaoclick_atributos_vendas_get` | Campos extras vendas: Visualizar (GET /api/atributos_vendas/{id}). |
| `gestaoclick_atributos_vendas_list` | Campos extras vendas: Listar (GET /api/atributos_vendas). |
| `gestaoclick_atributos_vendas_update` | Campos extras vendas: Editar (PUT /api/atributos_vendas/{id}). |
| `gestaoclick_centros_custos_list` | Centros de custos: Listar (GET /api/centros_custos). |
| `gestaoclick_cidades_list` | Cidades: Listar (GET /api/cidades). |
| `gestaoclick_clientes_create` | Clientes: Cadastrar (POST /api/clientes). |
| `gestaoclick_clientes_delete` | Clientes: Deletar (DELETE /api/clientes/{id}). |
| `gestaoclick_clientes_get` | Clientes: Visualizar (GET /api/clientes/{id}). |
| `gestaoclick_clientes_list` | Clientes: Listar (GET /api/clientes). |
| `gestaoclick_clientes_update` | Clientes: Editar (PUT /api/clientes/{id}). |
| `gestaoclick_compras_create` | Compras: Cadastrar (POST /api/compras). |
| `gestaoclick_compras_delete` | Compras: Deletar (DELETE /api/compras/{id}). |
| `gestaoclick_compras_gerar_parcelas_create` | Compras: Gerar parcelas (POST /api/compras/gerar_parcelas). |
| `gestaoclick_compras_get` | Compras: Visualizar (GET /api/compras/{id}). |
| `gestaoclick_compras_list` | Compras: Listar (GET /api/compras). |
| `gestaoclick_compras_update` | Compras: Editar (PUT /api/compras/{id}). |
| `gestaoclick_contas_bancarias_list` | Contas bancárias: Listar (GET /api/contas_bancarias). |
| `gestaoclick_estados_list` | Estados: Listar (GET /api/estados). |
| `gestaoclick_formas_pagamentos_list` | Formas pagamentos: Listar (GET /api/formas_pagamentos). |
| `gestaoclick_fornecedores_create` | Fornecedores: Cadastrar (POST /api/fornecedores). |
| `gestaoclick_fornecedores_delete` | Fornecedores: Deletar (DELETE /api/fornecedores/{id}). |
| `gestaoclick_fornecedores_get` | Fornecedores: Visualizar (GET /api/fornecedores/{id}). |
| `gestaoclick_fornecedores_list` | Fornecedores: Listar (GET /api/fornecedores). |
| `gestaoclick_fornecedores_update` | Fornecedores: Editar (PUT /api/fornecedores/{id}). |
| `gestaoclick_funcionarios_list` | Funcionários: Listar (GET /api/funcionarios). |
| `gestaoclick_grupos_produtos_list` | Grupos de produtos: Listar (GET /api/grupos_produtos). |
| `gestaoclick_lojas_list` | Lojas: Listar (GET /api/lojas). |
| `gestaoclick_notas_fiscais_consumidores_cancelar_create` | Notas Fiscais de Consumidores: Cancelar (POST /api/notas_fiscais_consumidores/cancelar/{id}). |
| `gestaoclick_notas_fiscais_consumidores_create` | Notas Fiscais de Consumidores: Cadastrar (POST /api/notas_fiscais_consumidores). |
| `gestaoclick_notas_fiscais_consumidores_delete` | Notas Fiscais de Consumidores: Deletar (DELETE /api/notas_fiscais_consumidores/{id}). |
| `gestaoclick_notas_fiscais_consumidores_emitir_create` | Notas Fiscais de Consumidores: Emitir (POST /api/notas_fiscais_consumidores/emitir/{id}). |
| `gestaoclick_notas_fiscais_consumidores_get` | Notas Fiscais de Consumidores: Visualizar (GET /api/notas_fiscais_consumidores/{id}). |
| `gestaoclick_notas_fiscais_consumidores_list` | Notas Fiscais de Consumidores: Listar (GET /api/notas_fiscais_consumidores). |
| `gestaoclick_notas_fiscais_consumidores_update` | Notas Fiscais de Consumidores: Editar (PUT /api/notas_fiscais_consumidores/{id}). |
| `gestaoclick_notas_fiscais_produtos_cancelar_create` | Notas Fiscais de Produtos: Cancelar (POST /api/notas_fiscais_produtos/cancelar/{id}). |
| `gestaoclick_notas_fiscais_produtos_create` | Notas Fiscais de Produtos: Cadastrar (POST /api/notas_fiscais_produtos). |
| `gestaoclick_notas_fiscais_produtos_delete` | Notas Fiscais de Produtos: Deletar (DELETE /api/notas_fiscais_produtos/{id}). |
| `gestaoclick_notas_fiscais_produtos_emitir_create` | Notas Fiscais de Produtos: Emitir (POST /api/notas_fiscais_produtos/emitir/{id}). |
| `gestaoclick_notas_fiscais_produtos_get` | Notas Fiscais de Produtos: Visualizar (GET /api/notas_fiscais_produtos/{id}). |
| `gestaoclick_notas_fiscais_produtos_list` | Notas Fiscais de Produtos: Listar (GET /api/notas_fiscais_produtos). |
| `gestaoclick_notas_fiscais_produtos_update` | Notas Fiscais de Produtos: Editar (PUT /api/notas_fiscais_produtos/{id}). |
| `gestaoclick_notas_fiscais_servicos_cancelar_create` | Notas Fiscais de Serviços: Cancelar (POST /api/notas_fiscais_servicos/cancelar/{id}). |
| `gestaoclick_notas_fiscais_servicos_create` | Notas Fiscais de Serviços: Cadastrar (POST /api/notas_fiscais_servicos). |
| `gestaoclick_notas_fiscais_servicos_dele