ponte erp

Guia de conexão

Conecte o Ponte ERP no seu assistente

Leva uns dois minutos por pessoa. Você não instala nada: adiciona um endereço no Claude ou no ChatGPT, entra com o seu e-mail e já pode pedir as coisas do Bling pela conversa.

Endereço do conector (URL do servidor MCP remoto) https://ponte.programason.com.br/mcp

No Claude (claude.ai, Desktop e celular)

Você adiciona uma vez, no site ou no aplicativo do computador. Depois o conector aparece sozinho em todos os lugares onde você entra com a mesma conta, inclusive no celular.

Plano: no plano gratuito do Claude dá para ter 1 conector personalizado. Pro e Max não têm esse limite. Em Team ou Enterprise, quem adiciona é o dono da organização (veja abaixo) e cada pessoa só clica em Conectar.

  1. Abra Conectores

    No claude.ai ou no Claude Desktop, abra o menu e vá em Personalizar e depois em Conectores.

    Atalho: claude.ai/customize/connectors

    claude.ai/customize/connectors
    Habilidades
    Conectores
    Estilos

    Conectores

    Google Drive
    Gmail Conectar
    Desenho simplificado. Os nomes no seu Claude podem estar em inglês: Customize → Connectors.

  2. Adicione um conector personalizado

    Clique no + (no topo da lista) e escolha Adicionar conector personalizado (Add custom connector).

    claude.ai/customize/connectors
    Habilidades
    Conectores
    Estilos

    Conectores

    +
    Navegar pelos conectores
    Adicionar conector personalizado
    Desenho simplificado.

  3. Cole o endereço

    Nome: Ponte ERP. Endereço (URL): https://ponte.programason.com.br/mcp.

    Não precisa preencher ID nem segredo do cliente (as opções avançadas ficam em branco). Clique em Adicionar.

    Adicionar conector personalizado
    NomePonte ERP
    URL do servidor MCP remotohttps://ponte.programason.com.br/mcp
    Configurações avançadas (deixe em branco)
    Adicionar
    Desenho simplificado.

  4. Conecte e entre com o seu e-mail

    Na lista, clique em Conectar no Ponte ERP. Abre a página do Ponte ERP: informe o e-mail que o administrador cadastrou, digite o código de 6 dígitos que chega e clique em Autorizar.

    Se o administrador te passou um token pessoal, use "Tenho um token" e cole ele ali. O Claude volta sozinho para a conversa.

    ponte.programason.com.br/login

    Entrar no Ponte ERP

    O Claude quer acessar o Bling da sua empresa.
    Seu e-mailana@suaempresa.com.br
    Receber código Tenho um token
    Página do Ponte ERP. O seu e-mail e o seu token não ficam guardados no Claude.

  5. Teste

    Abra uma conversa nova e confira se o Ponte ERP está ligado no menu de ferramentas (o botão + ou o ícone de ferramentas, embaixo da caixa de texto). Depois peça:

    "Status da integração com o Bling". A resposta mostra o seu nome e a empresa.

    claude.ai/new
    Status da integração com o Bling
    Conectado à empresa Sua Empresa Ltda como ana. Você pode consultar e alterar pedidos e propostas.
    Responder…+ Ponte ERP ✓
    Desenho simplificado.

Claude Team ou Enterprise

O dono da organização vai em Configurações da organização → Conectores, clica em Adicionar e cola o mesmo endereço. Depois disso, cada pessoa abre Personalizar → Conectores, encontra o Ponte ERP na lista e clica em Conectar, entrando com o próprio e-mail. Cada uma entra com o seu acesso e as suas permissões.

No celular

Não precisa fazer nada no aplicativo: o conector adicionado no site já aparece lá. Conecte primeiro pelo computador.

Primeiros pedidos para testar

Consultar

"Quanto tenho em estoque do papel A4?"

"Pedidos da Construtora Horizonte nos últimos 30 dias"

Montar

"Monta um pedido para a Construtora Horizonte: 4 cadeiras de escritório, boleto 30/60"

Conferir

"Prepara a nota fiscal do pedido 2310 e me diz se falta algo"

Antes de gravar qualquer coisa no Bling, o Ponte ERP mostra uma prévia do que vai mudar e espera você confirmar. Veja tudo o que ele faz.

No ChatGPT

No ChatGPT, conectores próprios ficam no modo desenvolvedor. Funciona no site (chatgpt.com), não no aplicativo do celular.

Plano: para o conector alterar dados (criar pedido, editar proposta), o ChatGPT pede plano Business, Enterprise ou Edu. No Business, só administradores do espaço de trabalho ligam o modo desenvolvedor e criam o app; depois publicam para a equipe. No Plus e no Pro, o ChatGPT só deixa o conector fazer consultas.

  1. Ligue o modo desenvolvedor

    Em Configurações → Apps → Configurações avançadas, ligue Modo desenvolvedor (Settings → Apps → Advanced settings → Developer mode).

    No Enterprise, o administrador precisa liberar antes, em Permissões e funções.

    chatgpt.com · Configurações
    Geral
    Personalização
    Apps
    Segurança

    Configurações avançadas

    Modo desenvolvedor
    Permite adicionar apps (servidores MCP) próprios.
    Desenho simplificado. O ChatGPT muda esses menus com frequência; em algumas contas o caminho é Plugins → + → Create custom MCP server.

  2. Crie o app

    Em Configurações → Apps, clique em Criar (Create). Preencha:

    Nome: Ponte ERP · Descrição: Bling da empresa · URL do servidor MCP: https://ponte.programason.com.br/mcp · Autenticação: OAuth.

    chatgpt.com · Novo app
    NomePonte ERP
    URL do servidor MCPhttps://ponte.programason.com.br/mcp
    AutenticaçãoOAuth
    ☑ Eu entendo os riscos e quero continuar
    Criar
    Desenho simplificado. Não precisa de ID nem segredo do cliente: o Ponte ERP se registra sozinho.

  3. Entre com o seu e-mail

    O ChatGPT abre a página do Ponte ERP. Entre com o e-mail cadastrado pelo administrador (chega um código de 6 dígitos) ou com o seu token pessoal, e clique em Autorizar. O ChatGPT lê a lista de ferramentas e conclui a criação.

    ponte.programason.com.br/login

    Entrar no Ponte ERP

    O ChatGPT quer acessar o Bling da sua empresa.
    Código enviado para ana@suaempresa.com.br4 8 2 1 9 0
    Autorizar
    Página do Ponte ERP.

  4. Use na conversa

    Numa conversa nova, escolha o Ponte ERP no menu de ferramentas (o + da caixa de texto) ou escreva @Ponte ERP no começo da mensagem. No ChatGPT, isso vale por mensagem: chame de novo quando precisar.

    Teste com "Status da integração com o Bling".

    chatgpt.com
    @Ponte ERP quais propostas estão em aberto?
    Encontrei 3 propostas em aberto, somando R$ 12.480,00. A mais antiga é a 1042, da Construtora Horizonte.
    Pergunte alguma coisa+
    Desenho simplificado.

Para liberar para a equipe (Business e Enterprise)

Depois de testar, o administrador vai em Configurações do espaço de trabalho → Apps → Rascunhos e clica em Publicar. Cada pessoa da equipe então conecta com o próprio e-mail, e o Ponte ERP aplica as permissões dela.

Quando o Ponte ERP ganhar ferramentas novas: o ChatGPT guarda uma foto da lista de ferramentas. O administrador abre o app e clica em Atualizar (Refresh). No Business, se não houver essa opção, é preciso recriar e publicar de novo.

Permissões: quem pode fazer o quê

No Bling, a autorização para aplicativos vale para a empresa inteira: ou o app acessa tudo, ou nada. Por isso quem controla o acesso de cada pessoa é o Ponte ERP. Você decide, por pessoa e por área, se ela só consulta ou também altera.

Como funciona, em quatro frases

1. Cada pessoa entra com o próprio e-mail

O administrador cadastra a pessoa e o e-mail dela. Ninguém usa a senha do Bling nem divide login.

2. Permissão é área × ação

São 7 áreas (abaixo). Em cada uma, a pessoa pode não ter acesso, só consultar, ou consultar e alterar.

3. O que não pode, nem aparece

O assistente da pessoa não enxerga as ferramentas que ela não pode usar. Se tentar mesmo assim, o pedido é recusado e fica registrado.

4. Mudou, vale na hora

A permissão nova vale já na próxima mensagem da pessoa, sem reconectar. Tirar o acesso corta na hora.

As 7 áreas

ÁreaConsultar permiteAlterar permite
ProdutosBuscar produtos, ver detalhes, preços e camposCadastrar, editar, variações, kits, imagens, excluir e restaurar
EstoqueVer saldo por depósitoEntrada, saída e balanço; lançar e estornar o estoque de um pedido
ContatosBuscar e ver clientes e fornecedoresCadastrar, atualizar, excluir e restaurar
PedidosListar, ver e montar rascunhosCriar, mudar situação, duplicar, converter proposta em pedido
PropostasListar, ver e montar rascunhosCriar, editar e mudar situação
Notas fiscaisListar, ver, consultar situação na SEFAZ e conferir antes de gerarGerar, emitir, excluir rascunho, lançar nota de entrada
Financeiro—Lançar as contas a receber de uma nota

Sempre liberado para quem está conectado: ver o status da integração e confirmar ou cancelar uma alteração que a própria pessoa preparou. Só o administrador cadastra pessoas, muda permissões, tira acesso e mexe nas configurações da empresa.

Sugestões de perfil

PerfilO que darComo pedir no chat
VendasPedidos, propostas e contatos: alterar. Produtos e estoque: consultar.pedidos + propostas + contatos + produtos.ler + estoque.ler
Financeiro / fiscalNotas e financeiro: alterar. Pedidos e contatos: consultar.notas + financeiro + pedidos.ler + contatos.ler
Estoque / comprasProdutos e estoque: alterar. Pedidos: consultar. Notas de entrada.produtos + estoque + pedidos.ler + notas
Só consultaVer tudo, sem alterar nada.leitura
AdministradorTudo, incluindo pessoas e configurações.admin

Na prática: o administrador faz tudo pelo chat

Cadastra a Ana, ana@suaempresa.com.br, com perfil de vendas.
Prévia: criar a pessoa ana (e-mail ana@suaempresa.com.br). Pode alterar pedidos, propostas e contatos; só consulta produtos e estoque. Sem acesso a notas e financeiro.Confirma?
Confirma.
Pronto. A Ana recebeu o convite por e-mail e já pode conectar.
Libera notas fiscais só para consulta para ela.
Prévia: a Ana passa a consultar notas fiscais (sem gerar nem emitir). Vale na próxima mensagem dela.Confirma?

Outros pedidos que funcionam: "Quem tem acesso?", "O que a Ana pode fazer?", "Tira o financeiro do Bruno", "Tira o acesso do Carlos, ele saiu da empresa".

Permissão não é carta branca

Mesmo quem pode alterar vê uma prévia antes de cada gravação no Bling e precisa confirmar. Nota fiscal pede confirmação sempre. Cada alteração fica registrada com quem pediu, o que mudou e quando.

E o histórico do próprio Bling?

Por padrão, as alterações aparecem no Bling com o usuário da empresa que conectou o Ponte ERP, e o registro de quem pediu fica no Ponte ERP. Se a pessoa quiser que o Bling também mostre o nome dela, ela conecta o próprio usuário do Bling uma vez: entra no Bling com o usuário dela, abre ponte.programason.com.br/bling/conectar, cola o token pessoal e autoriza. As permissões do Ponte ERP continuam valendo do mesmo jeito.

Se der problema

O que apareceO que fazer
Não chegou o código no e-mailConfira a caixa de spam e se o e-mail é o mesmo que o administrador cadastrou. O código vale 10 minutos.
"Não autorizado" ou o assistente diz que precisa reconectarEm Conectores (Claude) ou Apps (ChatGPT), desconecte o Ponte ERP e conecte de novo. Isso acontece se o seu acesso foi trocado ou ficou 30 dias sem uso.
Alguma ação não aparece para mimVocê não tem permissão para aquela área. Peça ao administrador.
O assistente não usa o Ponte ERPConfira se ele está ligado no menu de ferramentas da conversa. No ChatGPT, chame com @Ponte ERP.
No ChatGPT, só consegue consultarO seu plano do ChatGPT só permite consultas por conector. Para alterar, é preciso Business ou Enterprise, ou use o Claude.
Ferramenta nova não aparece no ChatGPTO administrador abre o app e clica em Atualizar.

Ainda com dúvida? Fale com a gente.