Ir para o conteúdo

OUT1515% off na primeira cobrança com o cupom OUT15.15% off na 1ª cobrançaVer planos

Model Context Protocol

Sua nota fiscal, dentro do seu agente.

Conecte Claude, ChatGPT ou Cursor à Emitfy e peça em português: conferir a empresa, buscar o NCM, cadastrar o cliente, emitir e acompanhar NF-e, NFS-e e NFC-e.

Servidorhttps://mcp.emitfy.com/mcp
ClaudeEmitfy MCP conectado

Emita uma NFS-e de R$ 250,00 para a Clara Mendes, do serviço de consultoria.

  1. list_companies1 empresa
  2. list_customersClara Mendes
  3. list_servicesConsultoria
  4. create_nfsecompanyId · externalId · bodyprocessing
  5. get_nfseidauthorized

Pronto. A NFS-e da Clara Mendes foi autorizada pela prefeitura. Quer que eu envie o PDF por e-mail?

NFS-e · ConsultoriaR$ 250,00Clara MendesAutorizada
Exemplo ilustrativo · dados fictícios · ferramentas reais do servidor

01Conectar

Escolha o seu assistente e cole a configuração.

Sem instalar nada e sem copiar chave: a autorização acontece no navegador, com o seu login da Emitfy. Leva poucos minutos.

  1. Abra Configurações → Conectores.

  2. Clique em Adicionar conector personalizado e cole a URL.

  3. Entre na Emitfy no navegador, revise as permissões e autorize.

URL do conector
https://mcp.emitfy.com/mcp
  • Sem chave no chatOAuth 2.1 com PKCE. Cada conexão tem credenciais próprias no servidor.
  • Nada para instalarServidor remoto por Streamable HTTP. O cliente se conecta pela URL.
  • Revogue quando quiserPainel → API & Webhooks → Conexões MCP. A API REST continua igual.
URL do servidor
https://mcp.emitfy.com/mcp
Transporte
Streamable HTTP (remoto)
Autorização
OAuth 2.1 · PKCE S256 · registro dinâmico de cliente
Metadados do recurso
https://mcp.emitfy.com/.well-known/oauth-protected-resource
Servidor de autorização
https://mcp.emitfy.com/.well-known/oauth-authorization-server

02Exemplos de pedidos

Peça do jeito que você falaria.

Abaixo de cada pedido, as ferramentas que o agente costuma usar para resolver. Os nomes e valores são fictícios.

  • A Ateliê Ventura já está pronta para emitir NF-e?

    Ferramentas

    • list_companies
    • get_company_status
    • get_certificate_status
  • Qual NCM devo usar para camiseta de algodão?

    Ferramentas

    • search_ncm
  • Emita uma NFS-e de R$ 250,00 para a Clara Mendes, do serviço de consultoria.

    Ferramentas

    • list_customers
    • list_services
    • create_nfse
  • Por que a última NF-e foi rejeitada? Corrija e tente de novo.

    Ferramentas

    • list_nfe
    • list_nfe_events
    • update_nfe_draft
    • emit_nfe
  • Reenvie a nota do Rafael Teixeira por e-mail e me mande o PDF.

    Ferramentas

    • list_nfse
    • send_nfse_email
    • get_nfse_pdf
  • Crie um webhook para avisar meu sistema quando uma NFS-e for autorizada.

    Ferramentas

    • create_webhook

03Como funciona

Um conector entre o seu assistente e a sua conta fiscal.

MCP (Model Context Protocol) é um padrão aberto para assistentes de IA usarem ferramentas de outros sistemas. Você conecta uma vez; depois, é só pedir.

Você conversa

Seu assistente

Entende o pedido e decide quais ferramentas usar.

Emitfy MCP

Ferramentas com permissão

Cada ação passa pelos escopos que você autorizou. O agente nunca vê a sua senha nem a chave da API.

mcp.emitfy.com
Sua conta

Emitfy

Empresas, clientes, catálogo e notas. As mesmas regras fiscais do painel e da API.

api.emitfy.com

04Ferramentas

O que o agente consegue fazer por você.

As ferramentas chamam a API pública da Emitfy, com as mesmas validações. Toda ferramenta de empresa, catálogo ou nota trabalha com a empresa indicada (companyId).

Notas fiscais: NF-e, NFS-e e NFC-e

mcp:read · mcp:emit

Cada documento tem as suas ferramentas: emitir, listar, consultar, corrigir rascunho, reenviar, reconsultar no órgão, cancelar, eventos, PDF e XML. O padrão se repete nos três tipos: abaixo, as da NFS-e e as exclusivas de NF-e e NFC-e.

  • create_nfse
  • list_nfse
  • get_nfse
  • emit_nfse
  • update_nfse_draft
  • consult_nfse
  • cancel_nfse
  • list_nfse_events
  • get_nfse_pdf
  • get_nfse_xml
  • send_nfse_email
  • create_correction_letter
  • get_nfe_rejection_xml
  • inutilize_nfe_numbers
  • transmit_nfce
  • inutilize_nfce_numbers

Referência fiscal

mcp:read

O agente busca os códigos em vez de inventar.

  • search_ncm
  • search_nbs
  • search_cfop
  • search_cnae
  • search_cest
  • search_federal_services
  • search_tax_class_code
  • search_ibs_operation_indicator
  • get_fiscal_suggestions
  • lookup_cnpj
  • lookup_zipcode

Empresa e certificado

mcp:setup · mcp:certificate

Cadastro, dados fiscais, inscrições estaduais, logos e certificado A1.

  • list_companies
  • get_company
  • get_company_status
  • create_company
  • update_company
  • update_company_fiscal
  • list_state_registrations
  • create_state_registration
  • upload_company_logo
  • upload_danfe_logo
  • get_certificate_status
  • upload_certificate
  • delete_certificate

Clientes e catálogo

mcp:read · mcp:setup

Clientes, produtos, serviços e itens de split, com listar, ver, criar, editar e remover.

  • list_customers
  • create_customer
  • update_customer
  • list_products
  • create_product
  • list_services
  • create_service
  • list_split_items
  • list_nfse_custom_services

Transporte e webhooks

mcp:emit · mcp:webhooks

CT-e, CT-e OS e MDF-e, além dos webhooks da assinatura.

  • create_cte
  • create_cte_os
  • consult_cte
  • create_mdfe
  • add_mdfe_driver
  • add_mdfe_document
  • close_mdfe
  • list_webhooks
  • create_webhook
  • set_webhook_active

Lista resumida. O catálogo completo, com todas as variações por documento, está no guia do MCP. O servidor também traz roteiros prontos para configurar uma empresa do zero e emitir a primeira NF-e ou NFS-e.

05Segurança e permissões

Você decide o que o agente pode fazer.

  • Sem chave no chat. O login é na Emitfy, pelo navegador, com OAuth 2.1 e PKCE.
  • Credencial por conexão. Cada autorização gera credenciais próprias no servidor; o X-Api-Secret da conta não muda.
  • Confirmação nas ações sensíveis. O servidor orienta o agente a pedir o seu aval antes de cancelar, inutilizar numeração ou remover certificado.
  • Registro de uso. A Emitfy registra cada chamada de ferramenta, com empresa e resultado.
  • Revogação pelo painel. Em API & Webhooks → Conexões MCP, você desconecta qualquer assistente.
Escopos na tela de autorizaçãovocê pode desmarcar
mcp:read

Consultar empresas, catálogo, notas e tabelas fiscais

Padrão
mcp:setup

Criar e editar empresa, dados fiscais, clientes e produtos/serviços

Padrão
mcp:emit

Emitir e reprocessar notas, inutilizar numeração e carta de correção

Padrão
mcp:webhooks

Gerenciar webhooks da assinatura

Padrão
mcp:certificate

Enviar ou remover certificado A1

Opcional
mcp:cancel

Cancelar notas fiscais

Opcional

Plano

Incluído em todos os planos.

O MCP usa o mesmo acesso da API: vem em todos os planos, a partir de R$ 47/mês, e também nas 10 notas grátis da conta nova.

Limitações desta versão

O que ainda fica fora do MCP.

  • Notas recebidas, marketplaces, equipe e cobrança não estão no MCP.
  • Não há pacote local (STDIO): a conexão é sempre pelo servidor remoto.
  • O MCP é um cliente da API pública. Para integrar sistemas, use a API REST ou os SDKs.

FAQ

Dúvidas sobre o MCP.

O que é MCP?

Model Context Protocol é um padrão aberto para assistentes de IA usarem ferramentas externas. Com o MCP da Emitfy, o seu assistente passa a consultar e operar a sua conta fiscal pela conversa, com as permissões que você autorizar.

Preciso colar minha chave de API no chat?

Não. A conexão usa OAuth 2.1: você entra na Emitfy pelo navegador e autoriza os escopos. Cada conexão recebe credenciais próprias no servidor, e o X-Api-Secret da sua conta não muda.

O agente emite notas de verdade?

Sim. A emissão pelo mcp.emitfy.com é em produção, com validade fiscal, igual à API. Por isso vale revisar o pedido antes de confirmar; cancelamento, inutilização e remoção de certificado pedem confirmação explícita sua.

E se a IA inventar um NCM ou uma alíquota?

O servidor orienta o agente a buscar NCM, CFOP, LC 116 e alíquotas nas ferramentas de referência, nunca a deduzir. E todo pedido de emissão é validado antes do envio: se faltar ou sobrar um campo, a resposta diz exatamente qual corrigir.

Ele pode cancelar uma nota sem eu saber?

Cancelar notas e mexer no certificado A1 ficam desmarcados na tela de autorização: só entram se você marcar. Mesmo com a permissão, o servidor orienta o agente a pedir a sua confirmação antes.

Funciona com mais de uma empresa?

Sim. Toda ferramenta de empresa, catálogo ou nota trabalha com a empresa indicada. Se a sua conta tem vários CNPJs, o agente pergunta em qual emitir antes de seguir.

Em quais planos o MCP está disponível?

Em todos os planos, a partir de R$ 47/mês (Quartz), e também nas 10 notas grátis da conta nova.

Substitui a integração pela API?

Não. O MCP é um cliente da API pública, pensado para operar pela conversa. Para integrar o seu sistema e emitir no automático, use a API REST ou os SDKs.

Como desconecto um assistente?

No painel da Emitfy, em API & Webhooks → Conexões MCP, revogue a conexão. As chaves da API REST continuam como estão.

Preciso instalar algum pacote?

Não. O servidor é remoto, em https://mcp.emitfy.com/mcp. Não existe pacote local (STDIO); o cliente se conecta pela URL.

Emitfy MCP

Peça a próxima nota na conversa.

10 notas grátis no total, sem cartão. Ao assinar, 7 dias de garantia.

  1. Crie a conta

    Sem cartão. As 10 notas grátis já vêm com API e MCP liberados.

  2. Cole a URL no seu assistente

    Claude, ChatGPT, Cursor, Claude Code ou outro cliente compatível.

  3. Autorize e peça

    Escolha as permissões no navegador e peça a primeira nota em português.