Tecnologia e automação fiscal
API MCP do FazNota: use o emissor e a gestão conversando com a IA
Cadastrar 50 produtos, conferir quanto entra no caixa na semana, faturar o pedido que o cliente acabou de fechar. Tarefas assim agora cabem numa frase. A API MCP do FazNota está no ar: você pede em português para um assistente de IA, e ele usa o FazNota por você.
Resposta rápida: A API MCP do FazNota liga o emissor e a gestão do FazNota a assistentes de inteligência artificial pelo MCP (Model Context Protocol). São mais de 90 ferramentas de notas fiscais, produtos, pedidos, financeiro e estoque, cada uma correspondente a um endpoint da API, com as mesmas regras e permissões. Hoje funciona no Claude Desktop, no Cursor e em agentes próprios, com o endereço do MCP e a chave de integração da empresa. Vem em todos os planos.
Até aqui, usar inteligência artificial com o sistema da empresa quase sempre era um trabalho de copiar e colar: exportar um relatório, levar para a conversa, trazer a resposta de volta e digitar no sistema. Com a API MCP, o assistente passa a usar o FazNota diretamente, com as mesmas regras que valem para quem opera pela tela.
Este artigo conta o que mudou, o que já dá para pedir, como conectar hoje e quais cuidados tomar. A parte técnica completa, com endereços e permissões, está na página da API MCP do FazNota.
O que é a API MCP, em poucas palavras
O MCP (Model Context Protocol) é um padrão aberto que permite a uma IA usar um sistema por conversa. O sistema oferece uma lista de ferramentas: "consultar contas a receber", "faturar pedido", "emitir NFC-e". O assistente lê essa lista, entende o seu pedido e escolhe qual ferramenta chamar.
No FazNota, cada ferramenta corresponde a um endpoint da API. Na prática, isso quer dizer três coisas:
- Mesmas regras: a nota pedida à IA passa pelas mesmas validações da nota emitida pela tela, com a tributação vinda do cadastro.
- Mesmas permissões: a IA só faz o que a credencial usada na conexão permite.
- Mesmos limites: as notas contam no plano e os limites de uso são os da API.
Se quiser entender o conceito com mais calma, com exemplos de fluxo e a diferença entre consultar e emitir, leia IA para emitir notas: como assistentes de IA usam o emissor via MCP.
O que você já pode pedir
São mais de 90 ferramentas, e a lista cresce junto com a API. Um resumo por área, com exemplos de pedido:
| Área | O que a IA faz | Exemplo de pedido |
|---|---|---|
| Produtos | Cadastra e atualiza produtos, ajusta preço em lote, cuida de categorias, fotos e dados fiscais e sugere NCM, CEST, CFOP e IBS/CBS pelo nome do produto | "Cadastre estes 50 produtos com o NCM certo." |
| Financeiro e caixa | Consulta contas a pagar e a receber, lançamentos, fechamentos e saldo do caixa | "Quanto tenho a receber esta semana?" |
| Pedidos e orçamentos | Cria pedidos e orçamentos, mexe nos itens, converte orçamento em pedido e fatura em NF-e | "Fature o pedido 123." |
| Notas fiscais | Cria, emite, consulta e cancela NF-e e NFC-e, explica rejeições, traz DANFE e XML; continua a emissão de NFS-e; consulta MDF-e | "Por que a última nota foi rejeitada?" |
| Estoque | Ajustes, entrada de mercadoria, inventário e transferência entre empresas do grupo | "Registre a entrada destes itens do fornecedor." |
| Clientes e empresa | Cadastro de clientes, validade do certificado digital, configuração fiscal da empresa e usuários | "Quando vence o meu certificado digital?" |
Um destaque é a classificação fiscal automática. Ao cadastrar um produto, o FazNota sugere NCM, CEST, CFOP e a classificação de IBS e CBS a partir do nome, com nível de confiança e avisos. É um ponto de partida que economiza tempo, não um substituto do contador: a classificação final de cada produto deve ser revisada por ele. Para entender os campos novos da reforma, veja o que é cClassTrib.
Quer fazer a primeira pergunta ao seu FazNota?
Crie a conta de teste, gere a chave de integração e conecte o assistente. A API MCP vem em todos os
planos.
Como conectar hoje, passo a passo
Hoje, a conexão é feita informando o endereço do MCP e a chave de integração da empresa no assistente. Funciona no Claude Desktop, no Cursor, em outros clientes MCP que aceitam o cabeçalho de chave e em agentes que você mesmo monta.
- Gere a chave de integração. No painel do FazNota, gere a chave de integração da empresa. É a mesma chave (token) da API do FazNota. Trate como uma senha. Gerar uma nova chave substitui a anterior e derruba as integrações que usam a antiga.
- Adicione o FazNota como servidor MCP. No arquivo de configuração local de servidores MCP do
seu aplicativo (no Claude Desktop, não pelo botão "Adicionar conector"), informe o endereço da API MCP e a chave no cabeçalho
X-API-Key. Os endereços estão na página da API MCP do FazNota. - Teste em homologação, se quiser. Existe um ambiente de homologação para validar a configuração antes de usar o endereço de produção.
- Comece pelas consultas. Pergunte o que você já tira de relatórios hoje e compare as respostas. Depois passe para cadastros e, por último, para emissão.
E o ChatGPT e o claude.ai? Os dois só aceitam conectores remotos com login pelo navegador (OAuth). Esse conector direto do FazNota está chegando; até lá, use um dos caminhos acima.
Segurança: quem controla o que a IA faz
A IA entra no FazNota pela mesma porta da API, com as mesmas travas. Vale conhecer as três peças:
A credencial define o alcance
Hoje, o acesso é pela chave de integração da empresa, que libera todas as ferramentas da empresa. Por isso ela deve ficar com quem já pode operar o sistema inteiro. O acesso por usuário, limitado por áreas (financeiro, vendas, estoque, cadastros, fiscal) e pelas permissões de cada pessoa, chega junto com o conector direto.
Tudo fica registrado
Cada chamada da IA vai para o log de auditoria, e dá para registrar qual pessoa delegou a tarefa ao assistente. Se algo sair diferente do esperado, você sabe o que foi feito e quando.
A responsabilidade continua sendo da empresa
Uma nota emitida por pedido à IA tem o mesmo efeito fiscal de uma nota emitida com cliques. Por isso, peça ao assistente que mostre o resumo e espere o seu "sim" antes de emitir ou cancelar, e mantenha o cadastro fiscal revisado pelo contador. A automação reduz erro quando a regra está certa no cadastro, como explica o artigo sobre como a automação fiscal reduz erros operacionais.
Benefícios no dia a dia
- Menos tela, mais resposta: o saldo do caixa, as contas da semana ou as notas de ontem chegam na conversa, sem procurar relatório.
- Trabalho em lote: cadastrar uma planilha de produtos ou reajustar uma lista de preços vira um pedido só.
- Cadastro fiscal mais rápido: a sugestão de NCM, CEST, CFOP e IBS/CBS adianta o trabalho que depois o contador confere.
- Rejeição explicada: em vez de decifrar o código da Sefaz, você pergunta o motivo e a correção. As causas mais frequentes estão em rejeições mais comuns da NF-e.
- Mesmo plano de sempre: a API MCP vem em todos os planos. As notas emitidas pela IA contam no limite do plano, como qualquer outra. Ver planos.
API MCP ou API: quando usar cada uma
As duas convivem. A API MCP é para pessoas conversando com uma IA: o dono, o gerente, o contador, ou um agente que você monta para uma tarefa específica. A API é para sistemas conversando com sistemas: a loja virtual que emite nota quando o pedido é pago, o ERP que manda as notas do dia, sem conversa no meio. Se a sua necessidade é "emitir toda vez que X acontecer", o caminho é a API do FazNota; o artigo API fiscal: o que é e como integrar explica como funciona.
Pronto para conversar com o seu emissor?
Teste o FazNota grátis e conecte a API MCP ao Claude Desktop, ao Cursor ou ao seu agente.
Perguntas frequentes
Dá para usar a API MCP no ChatGPT ou no claude.ai?
Ainda não. O ChatGPT e o claude.ai na web só aceitam conectores remotos com login pelo navegador (OAuth), e esse conector direto do FazNota está chegando. Hoje, o caminho que funciona é configurar o endereço do MCP e a chave de integração no Claude Desktop, no Cursor, em outro cliente MCP que aceite o cabeçalho X-API-Key ou no seu próprio agente.
A IA pode emitir nota fiscal pelo FazNota?
Pode. Entre as ferramentas estão criar e emitir NF-e e NFC-e, faturar pedidos em NF-e e cancelar notas. A emissão passa pelas mesmas validações do sistema, e a tributação vem do cadastro. Como a nota tem efeito fiscal, o recomendado é configurar o assistente para mostrar o resumo e pedir a sua confirmação antes de emitir ou cancelar.
As notas emitidas pela IA contam no meu plano?
Sim. A API MCP vem em todos os planos, do Starter ao Enterprise, e as notas emitidas pela IA contam no limite de notas do plano, da mesma forma que as emitidas pela tela ou pela API de integração. Os limites de uso por minuto também são os mesmos da API.
Como eu testo sem mexer na minha operação?
Além do endereço de produção, existe um ambiente de homologação do MCP. Você pode apontar o assistente para ele, fazer as primeiras perguntas e conferir se a configuração está certa antes de trocar para o endereço de produção. Se tiver dúvida sobre os dados de teste, fale com o suporte.
Conteúdo informativo, escrito com base nas normas vigentes na data de publicação. Regras fiscais mudam e variam por estado, município, atividade e regime tributário: confirme a aplicação no seu caso com o seu contador.
Quer emitir suas notas sem complicação?
O FazNota emite NF-e, NFC-e, NFS-e, CT-e e MDF-e com PDV, estoque e financeiro
num sistema só — no computador, no celular e na maquininha.