# Ponte ERP

> Conector (servidor MCP remoto) que liga o ChatGPT e o Claude ao Bling, o sistema de gestão (ERP) brasileiro. A pessoa pede em português pela conversa (pedidos, propostas, notas fiscais, estoque, produtos, contatos) e, antes de gravar qualquer coisa no Bling, vê uma prévia e confirma. Cada pessoa entra com o próprio e-mail e tem permissões por área.

Este arquivo resume o produto para assistentes de IA. Se alguém pedir ajuda para conectar o Ponte ERP, use as instruções abaixo.

## Endereço do conector

- URL do servidor MCP remoto: `https://ponte.programason.com.br/mcp` (transporte Streamable HTTP)
- Autenticação: OAuth 2.1 com registro dinâmico de cliente (DCR) e PKCE. Não há client id nem client secret para preencher: deixe em branco.
- Login: na página do Ponte ERP, a pessoa entra com o e-mail cadastrado pelo administrador da empresa (código de 6 dígitos) ou com um token pessoal.

## Como conectar no Claude (claude.ai, Claude Desktop, app do celular)

1. Abra Personalizar > Conectores (Customize > Connectors): https://claude.ai/customize/connectors
2. Clique em + e em "Adicionar conector personalizado" (Add custom connector).
3. Nome: Ponte ERP. URL: `https://ponte.programason.com.br/mcp`. Deixe as opções avançadas em branco. Clique em Adicionar.
4. Clique em Conectar, entre com o e-mail (ou token) na página do Ponte ERP e autorize.
5. Numa conversa nova, ligue o Ponte ERP no menu de ferramentas e peça "status da integração com o Bling".

Plano gratuito: 1 conector personalizado. Team/Enterprise: o dono da organização adiciona em Configurações da organização > Conectores; cada pessoa clica em Conectar. O conector adicionado na web aparece no Desktop e no celular.

## Como conectar no ChatGPT

1. Configurações > Apps > Configurações avançadas: ligue Modo desenvolvedor (Settings > Apps > Advanced settings > Developer mode). Em algumas contas o caminho é Plugins > + > Create custom MCP server.
2. Configurações > Apps > Criar (Create). Nome: Ponte ERP. URL do servidor MCP: `https://ponte.programason.com.br/mcp`. Autenticação: OAuth. Aceite o aviso e clique em Criar.
3. Entre com o e-mail (ou token) na página do Ponte ERP e autorize.
4. Na conversa, escolha o Ponte ERP no menu de ferramentas ou escreva @Ponte ERP.

Alterar dados (escrita) pelo conector exige ChatGPT Business, Enterprise ou Edu, e só funciona no site (não no app do celular). Plus e Pro: só consultas. Quando o Ponte ERP ganhar ferramentas novas, o administrador clica em Atualizar (Refresh) no app.

## Permissões

O Bling autoriza aplicativos para a empresa inteira; o controle por pessoa é do Ponte ERP. São 7 áreas (produtos, estoque, contatos, pedidos, propostas, notas, financeiro), cada uma com ler (consultar) e escrever (alterar). Atalhos: `area` sozinha = ler e escrever; `leitura` = consultar tudo; `admin` = tudo, incluindo pessoas e configurações. Ferramentas sem permissão não aparecem para a pessoa. O administrador gerencia pelo chat: "Cadastra a Ana, ana@empresa.com.br, com pedidos + propostas + produtos.ler". Mudanças valem na próxima mensagem.

## Segurança

- Toda alteração no Bling passa por prévia e confirmação; nota fiscal sempre pede confirmação.
- Cada alteração fica registrada com quem pediu, o que mudou e quando.
- Os dados continuam no Bling; cada empresa é isolada.

## Planos

Essencial R$ 99/mês, Profissional R$ 199/mês, Sob medida. 14 dias grátis sem cartão, sem fidelidade. Detalhes: https://ponte.programason.com.br/#planos

## Páginas

- [Página inicial](https://ponte.programason.com.br/)
- [Como conectar, com telas](https://ponte.programason.com.br/como-conectar)
- [Todas as ferramentas](https://ponte.programason.com.br/ferramentas)


## Ferramentas (60)


### Produtos

- `buscar_produtos`: Encontra produtos pelo nome (em qualquer ordem das palavras) ou pelo código. (só consulta)
- `detalhar_produto`: Mostra a ficha completa de um produto: preço, custo, NCM, pesos, variações e saldo. (só consulta)
- `listar_campos_produto`: Lista todos os campos de produto que dá para preencher ou alterar. (só consulta)
- `planejar_produto`: Planeja um cadastro antes de criar: confere duplicados e o que falta preencher. (só consulta)
- `adicionar_variacao`: Acrescenta variações (cor, tamanho) a um produto que já tem variações. (mostra prévia e pede confirmação)
- `converter_em_variacoes`: Transforma um produto simples em produto com variações. (mostra prévia e pede confirmação)
- `criar_produto`: Cadastra um produto novo. (mostra prévia e pede confirmação)
- `definir_componentes`: Monta um kit: define quais produtos e quantidades o compõem. (mostra prévia e pede confirmação)
- `definir_imagens`: Coloca ou troca as imagens e o vídeo de um produto, na ordem que você quiser. (mostra prévia e pede confirmação)
- `editar_produto`: Altera preço, descrição, NCM ou qualquer outro campo de um produto. (mostra prévia e pede confirmação)
- `excluir_produto`: Exclui um produto (dá para restaurar depois). (mostra prévia e pede confirmação)
- `restaurar_produto`: Traz de volta um produto excluído ou inativo. (mostra prévia e pede confirmação)

### Estoque

- `consultar_estoque`: Mostra o saldo de um produto, no total e por depósito. (só consulta)
- `estornar_estoque_pedido`: Devolve ao estoque os itens de um pedido. (mostra prévia e pede confirmação)
- `lancar_estoque_pedido`: Dá baixa no estoque dos itens de um pedido. (mostra prévia e pede confirmação)
- `movimentar_estoque`: Lança entrada, saída ou balanço de estoque, com o saldo antes e depois. (mostra prévia e pede confirmação)

### Clientes e fornecedores

- `buscar_contatos`: Encontra clientes e fornecedores pelo nome, CPF/CNPJ ou telefone. (só consulta)
- `detalhar_contato`: Mostra o cadastro completo de um contato: documentos, endereços, telefones. (só consulta)
- `listar_campos_contato`: Lista todos os campos de contato que dá para preencher ou alterar. (só consulta)
- `atualizar_contato`: Altera dados de um cliente ou fornecedor. (mostra prévia e pede confirmação)
- `criar_contato`: Cadastra um cliente ou fornecedor. (mostra prévia e pede confirmação)
- `excluir_contato`: Exclui um contato (dá para restaurar depois). (mostra prévia e pede confirmação)
- `restaurar_contato`: Traz de volta um contato excluído ou inativo. (mostra prévia e pede confirmação)

### Pedidos de venda

- `detalhar_pedido_venda`: Mostra um pedido completo: itens, frete, desconto, parcelas e situação. (só consulta)
- `listar_pedidos_venda`: Lista pedidos por período, cliente ou situação, com os totais. (só consulta)
- `montar_pedido`: Monta o rascunho de um pedido a partir do que você disse ou de uma conversa colada. (só consulta)
- `alterar_situacao_pedido`: Muda a situação de um pedido (em aberto, atendido, cancelado). (mostra prévia e pede confirmação)
- `converter_proposta_em_pedido`: Transforma uma proposta aprovada em pedido de venda. (mostra prévia e pede confirmação)
- `criar_pedido_venda`: Grava no Bling o pedido montado. (mostra prévia e pede confirmação)
- `duplicar_pedido`: Cria um pedido novo copiando um anterior, para reposição. (mostra prévia e pede confirmação)

### Propostas comerciais

- `detalhar_proposta_comercial`: Mostra uma proposta completa: itens, parcelas, prazo e garantia. (só consulta)
- `listar_propostas_comerciais`: Lista propostas por período, situação ou cliente. (só consulta)
- `montar_proposta`: Monta o rascunho de uma proposta (orçamento) a partir do que você disse. (só consulta)
- `alterar_situacao_proposta`: Muda a situação de uma proposta (aprovada, não aprovada, aguardando). (mostra prévia e pede confirmação)
- `criar_proposta_comercial`: Grava no Bling a proposta montada. (mostra prévia e pede confirmação)
- `editar_proposta_comercial`: Altera uma proposta existente: itens, quantidades, frete, pagamento. (mostra prévia e pede confirmação)

### Notas fiscais

- `consultar_situacao_nfe`: Diz se uma nota foi autorizada, rejeitada ou está pendente na SEFAZ. (só consulta)
- `detalhar_nfe`: Mostra uma NF-e completa, com itens, impostos e links do DANFE. (só consulta)
- `listar_nfe`: Lista notas fiscais por período, situação ou cliente. (só consulta)
- `preparar_nfe_de_pedido`: Confere um pedido antes de gerar a nota e aponta o que falta. (só consulta)
- `preparar_nota_entrada`: Lê a nota de um fornecedor (XML, PDF ou texto) e monta o rascunho da entrada. (só consulta)
- `emitir_nfe`: Transmite a NF-e para a SEFAZ. (fiscal: sempre pede confirmação)
- `excluir_rascunho_nfe`: Exclui uma nota que ainda não foi transmitida. (fiscal: sempre pede confirmação)
- `gerar_nfe_de_pedido`: Gera a NF-e de um pedido no Bling, ainda sem transmitir. (fiscal: sempre pede confirmação)
- `lancar_nota_entrada`: Registra no Bling a nota de entrada do fornecedor. (fiscal: sempre pede confirmação)

### Financeiro

- `lancar_contas_nfe`: Cria no financeiro as contas das parcelas de uma nota (a receber ou a pagar). (mostra prévia e pede confirmação)

### Administração

- `conectar_bling_empresa`: Gera o link para conectar (ou reconectar) o Bling da empresa. (só consulta)
- `listar_usuarios`: Mostra quem tem acesso, o que cada pessoa pode fazer e o último uso. (só consulta)
- `ver_configuracoes`: Mostra as configurações da empresa: vendedor, loja e situações padrão. (só consulta)
- `criar_usuario`: Cadastra uma pessoa com as permissões dela (ou gera um token novo). (mostra prévia e pede confirmação)
- `definir_configuracao`: Muda uma configuração da empresa, conferida no Bling. (mostra prévia e pede confirmação)
- `definir_email`: Registra o e-mail com que a pessoa entra e manda o convite. (mostra prévia e pede confirmação)
- `definir_permissoes`: Muda o que uma pessoa pode consultar e alterar. (mostra prévia e pede confirmação)
- `revogar_usuario`: Tira o acesso de uma pessoa na hora. (mostra prévia e pede confirmação)

### Sempre disponível

- `atualizar_indice`: Atualiza a lista de produtos e contatos usada nas buscas por nome. (só consulta)
- `cancelar_operacao`: Descarta uma alteração que você não quer mais. (só consulta)
- `listar_operacoes_pendentes`: Lista as alterações que estão esperando a sua confirmação. (só consulta)
- `registrar_escolha`: Anota qual opção você escolheu quando a busca achou mais de uma. (só consulta)
- `status_integracao`: Mostra se o Bling está conectado, quem é você e em qual empresa. (só consulta)
- `confirmar_operacao`: Grava no Bling a alteração que você aprovou na prévia. (depois da sua confirmação)