Conectar o ProposalDesk a um app de IA
O que o conector faz
Depois de conectado, o app de IA consulta sua conta do ProposalDesk quando você pede: propostas, clientes, contratos, faturas e catálogo. Ele também pode criar um cliente novo ou um rascunho de proposta.
Nada é enviado aos seus clientes pelo app de IA, e ele não cobra nem move dinheiro. Você revisa e envia cada proposta pelo próprio ProposalDesk.
Como conectar
O endereço do servidor é:
https://app.proposaldesk.io/mcp
Claude
- Abra Configurações, depois Conectores, e escolha Adicionar conector personalizado.
- Dê o nome ProposalDesk, cole o endereço do servidor e confirme.
- Entre e permita (veja abaixo).
ChatGPT
- Abra Configurações, depois Apps ou Conectores, e ative o modo desenvolvedor.
- Adicione um novo conector, cole o endereço do servidor e escolha OAuth como autenticação.
- Entre e permita (veja abaixo).
Grok
- Abra grok.com/connectors e escolha Add a custom connector.
- Cole o endereço do servidor e salve.
- Entre e permita (veja abaixo).
Outros clientes MCP
Adicione um servidor MCP remoto (Streamable HTTP) com o mesmo endereço. O servidor usa OAuth, então um cliente compatível encontra a tela de login sozinho.
Entrar e permitir
O app abre a tela de login do ProposalDesk. Entre com seu e-mail e senha do ProposalDesk, confira a tela de permissão e aprove. O app de IA recebe um token de acesso. Ele nunca vê a sua senha.
Você escolhe o nível de acesso na tela de permissão:
- Só leitura: o app consulta, mas não altera nada.
- Leitura e escrita: também cria clientes e rascunhos de proposta. Nada além disso pode ser gravado.
Se a assinatura venceu e a conta está somente leitura, o app ainda consulta, mas não cria nada até você assinar de novo.
As 10 ferramentas
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_account_overview | Nome e moeda da conta, propostas por status, o que espera resposta, aprovações recentes. | Leitura |
search_proposals | Lista propostas, as mais novas primeiro; filtra por status, cliente ou palavra do título ou número. | Leitura |
get_proposal | Uma proposta completa: cliente, status, itens, totais, planos de pagamento e fases. | Leitura |
search_clients | Lista clientes por nome, empresa ou e-mail. | Leitura |
get_client | Um cliente com contato, resumo financeiro e propostas recentes. | Leitura |
search_contracts | Lista contratos; filtra por status, cliente ou texto. | Leitura |
search_invoices | Lista faturas; filtra por status (em aberto, vencidas, pagas e outros), cliente e vencimento. | Leitura |
search_catalog | Lista os itens do catálogo com nome, preço e moeda. | Leitura |
create_client | Cria um cliente. Nada é enviado ao cliente. | Escrita |
create_proposal_draft | Cria uma proposta em rascunho para um cliente existente e devolve o link para revisar no ProposalDesk. Nunca é enviada. | Escrita |
Exemplos de pedidos
Os pedidos podem ser em português. Alguns exemplos:
- "Me dê uma visão geral da minha conta do ProposalDesk."
- "Mostre a proposta P-2026-0001 com os totais e os planos de pagamento."
- "Quais faturas estão em aberto ou vencidas?"
- "Crie um rascunho de proposta para o Café Aurora com um item, 'Redesign do site', de R$ 2.000."
Como desconectar
No ProposalDesk, abra Configurações, depois Apps conectados, e escolha Desconectar ao lado do app. O acesso acaba na hora. Trocar a senha do ProposalDesk também desconecta todos os apps. Para usar o conector de novo, conecte outra vez.
Privacidade e segurança
- A conexão usa um token, não a sua senha, e o token só vale para a sua própria conta.
- Você escolhe só leitura ou leitura e escrita, e pode revogar o acesso quando quiser.
- O conector não envia propostas nem contratos, não cobra clientes e não move dinheiro.
- O que o app de IA lê é tratado pelos termos e pela política de privacidade do próprio app. Conecte só apps em que você confia para isso.
Veja a política de privacidade para saber como o ProposalDesk trata os dados. Dúvidas ou problemas: [email protected].