QuoteBill

npx add-mcp 'https://quotebill.com/mcp'

Servidor MCP QuoteBill

Elabore cotações e faturas a partir do assistente de IA que você já usa. O servidor MCP remoto do QuoteBill dá ao ChatGPT, Claude, Gemini e qualquer outro cliente MCP:

• 133 modelos de cotação e fatura para ofícios, serviços profissionais, países e idiomas
• Regras fiscais para 195 países, cada uma com a fonte oficial de onde foi lida e a data em que foi verificada
• Totais calculados com a mesma aritmética do editor QuoteBill, arredondados para a moeda
• Um link para o documento finalizado: build_document retorna uma URL que abre a cotação ou fatura elaborada, preenchida, em quotebill.com, pronta para baixar como Excel ou Word ou salvar como PDF

Endpoint	https://quotebill.com/mcp
Transporte	HTTP Streamable (respostas JSON)
Autenticação	OAuth 2.1 com uma conta QuoteBill gratuita. Seu aplicativo de IA encontra o login sozinho: ele abre o QuoteBill, você faz login (o Google funciona) e escolhe Permitir
Protocolo	2026-07-28, e as revisões de handshake 2025-03-26 a 2025-11-25
Idiomas	Respostas em 33 idiomas
Guia para pessoas	Usar QuoteBill no ChatGPT, Claude e Gemini
Registro MCP	io.github.auto1225/quotebill

Conectar

Na primeira vez que você conectar, seu aplicativo de IA abre o QuoteBill no navegador. Entre ou cadastre-se gratuitamente, verifique qual aplicativo está solicitando e escolha Permitir. Você faz isso uma vez por aplicativo; você pode desconectar um aplicativo a qualquer momento em Aplicativos de IA conectados nas configurações da empresa do QuoteBill.

Claude (claude.ai, desktop e mobile) — Configurações → Conectores → Adicionar conector personalizado. Nome QuoteBill, URL https://quotebill.com/mcp, depois Conectar. Ou abra este link: adicionar QuoteBill ao Claude.

ChatGPT (chatgpt.com) — ative o modo de desenvolvedor nas Configurações, depois crie um aplicativo na página de aplicativos: URL do servidor MCP https://quotebill.com/mcp, autenticação OAuth. Entre no QuoteBill e permita, depois adicione o QuoteBill pelo menu + em um chat.

Claude Code

claude mcp add --transport http quotebill https://quotebill.com/mcp

Depois execute /mcp, escolha quotebill e entre.

Codex — ~/.codex/config.toml, depois codex mcp login quotebill

[mcp_servers.quotebill]
url = "https://quotebill.com/mcp"

Gemini CLI — instale este repositório como uma extensão:

gemini extensions install https://github.com/auto1225/quotebill-mcp

ou adicione-o a ~/.gemini/settings.json:

{ "mcpServers": { "quotebill": { "httpUrl": "https://quotebill.com/mcp" } } }

Depois execute /mcp auth quotebill uma vez para entrar.

Cursor — .cursor/mcp.json (o Cursor abre o login quando você habilita o servidor)

{ "mcpServers": { "quotebill": { "url": "https://quotebill.com/mcp" } } }

VS Code — .vscode/mcp.json (o VS Code pede que você entre quando o servidor inicia)

{ "servers": { "quotebill": { "type": "http", "url": "https://quotebill.com/mcp" } } }

Plugin Claude Code — este repositório também é um marketplace de plugins:

/plugin marketplace add auto1225/quotebill-mcp
/plugin install quotebill@quotebill

Como funciona o login

Uma solicitação sem token recebe 401 com WWW-Authenticate: Bearer resource_metadata="https://quotebill.com/.well-known/oauth-protected-resource/mcp". Esses metadados (RFC 9728) nomeiam o servidor de autorização, Supabase Auth em https://wgpfbcfiontxqusseoyv.supabase.co/auth/v1, cujos metadados (RFC 8414) oferecem registro dinâmico de clientes, PKCE e o escopo email. Clientes MCP que seguem a especificação de autorização MCP não precisam de mais nada.

Ferramentas

Ferramenta	O que faz
search_templates	Encontra modelos por palavras, tipo de documento ou categoria, no idioma solicitado, com exemplos de itens de linha e a página em que cada um abre.
get_template	O registro completo para um slug de modelo.
get_tax_rule	A taxa publicada, seu nome, a moeda e a fonte de onde foi lida, para qualquer um dos 195 países. Países sem uma taxa nacional única, como os Estados Unidos, são informados como precisando de uma jurisdição em vez de receber um número inventado.
calculate_totals	Soma itens de linha, aplica descontos e o imposto do país, arredondando cada componente de imposto separadamente para a moeda.
build_document	Constrói uma cotação ou fatura completa, calcula o total e retorna um link que a abre preenchida. language é o idioma do documento; interfaceLanguage o idioma em que a página abre.
list_guides	Os guias de instruções do QuoteBill, como converter uma cotação em fatura ou o que uma fatura alemã, japonesa ou coreana deve conter.
list_reference	As categorias, layouts, idiomas e códigos de país que as outras ferramentas aceitam.

Toda ferramenta publica um inputSchema e um outputSchema, e é anotada readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false. Argumentos inválidos retornam como um erro de ferramenta que diz o que corrigir.

Exemplos de solicitações

• "Faça uma fatura no QuoteBill para meu cliente no Japão: design de site ¥480.000, mais três meses de manutenção a ¥25.000 por mês, com 5% de desconto na manutenção."
• "Use o QuoteBill para fazer uma cotação de 12 horas de consultoria a €95 por hora para um cliente na Alemanha."
• "Encontre um modelo QuoteBill para uma cotação de encanamento e preencha com estes serviços."
• "Qual é a taxa de IVA na França, e de onde o QuoteBill a obtém?"

Privacidade

O servidor verifica se o chamador é um membro QuoteBill conectado, depois apenas consulta modelos e regras fiscais e faz aritmética. O token de login que um aplicativo de IA possui não pode ler os documentos salvos, perfil ou arquivos do membro; o banco de dados recusa todo token emitido para um aplicativo. O servidor não salva nada e não mantém nomes de clientes ou valores; seu log registra a ferramenta, se respondeu e o nome do cliente, nunca os argumentos ou a conta. Um documento elaborado viaja dentro do link retornado, após o #, que navegadores nunca enviam a um servidor, e o link carrega uma soma de verificação para que uma cópia alterada seja recusada em vez de aberta com um valor errado. Chamadas são limitadas por conta usando um hash salgado que muda a cada minuto; essas contagens são excluídas em uma hora. Veja o aviso de privacidade.

Limites

• 60 chamadas de ferramenta por minuto por conta
• Até 200 itens de linha e valores de até 100.000.000.000 por linha e por documento
• Uma taxa de imposto publicada é um ponto de partida, não aconselhamento fiscal: registro, local de fornecimento e o tratamento dos bens ou serviços ainda precisam ser confirmados

Suporte

auto0104@gmail.com · quotebill.com/en/contact

Licença

Os arquivos de configuração neste repositório são licenciados sob MIT. O serviço QuoteBill é operado em quotebill.com.