Emitfy
Docs
MCP remoto · Novidade

Sua emissão fiscal,
agora no Claude, Cursor e ChatGPT

Conecte a Emitfy às IAs que você já usa via Model Context Protocol. Configure o CNPJ, consulte tabelas fiscais e emita notas em linguagem natural — com OAuth 2.1, sem colar API key no client.

https://mcp.emitfy.com/mcp
Ver como instalar Documentação técnica →
Exemplo na conversa

Liste minhas empresas, verifique o status fiscal e emita uma NFS-e de R$ 2.500 para o cliente com CNPJ 12.345.678/0001-90.

Pronto — empresa em homologação ok, cliente cadastrado e nota enfileirada. ID 01HXYZ… · status processing. Acompanho pelo webhook ou consulto de novo.

O que você pode pedir

Pergunte qualquer coisa sobre a emissão fiscal

Tools do MCP remoto para setup, referência fiscal e emissão — com companyId obrigatório nas operações de empresa.

Referência fiscal

NCM, NBS, CFOP, CNAE, CEST, LC 116, CEP, CNPJ e códigos da reforma — busque antes de emitir.

Empresa e certificado

Liste CNPJs, veja o status, configure fiscal, ambiente e certificado A1 com escopo opt-in.

Catálogo

Clientes, produtos, serviços e split — no mesmo fluxo da API pública.

Emissão de notas

Crie NFS-e e NF-e, consulte status, baixe XML/PDF, CC-e e inutilização quando aplicável.

Webhooks

Cadastre e gerencie endpoints da assinatura para acompanhar autorização e rejeição.

Homologação primeiro

Fluxo canônico: status → setup → emitir em homologação → só então produção.

Qual o status fiscal desta empresa?Busque o NCM de notebookCadastre este cliente e emita a NFS-eListe as notas do mêsBaixe o PDF da última nota autorizada

Segurança

Como o acesso funciona

OAuth 2.1 com PKCE. Você autoriza no browser; a IA opera com escopos que você escolheu.

Login com sua conta Emitfy

O client abre o consent no browser. Você autentica na Emitfy e escolhe os escopos antes de autorizar.

Escopos granulares

Leitura, setup, emissão e webhooks no padrão. Certificado e cancelamento ficam opt-in no consent.

Secret só no servidor

Ao autorizar, o X-Api-Secret da conta é rotacionado e vinculado à conexão MCP — não vai para o chat.

Revogue quando quiser

Painel → API & Webhooks → Conexões MCP → Revogar. A conexão deixa de operar na hora.

Instalação

Configure em minutos

Use a mesma URL em todos os clients. https://mcp.emitfy.com/mcp

Claude

Claude.ai ou Claude Desktop, via conector MCP remoto.

  1. 1Abra Configurações → Conectores.
  2. 2Adicione um conector personalizado com a URL do endpoint Emitfy.
  3. 3Salve e, numa conversa nova, ative o conector.
  4. 4Conclua o OAuth no browser (login Emitfy → autorizar escopos).
https://mcp.emitfy.com/mcp

Cursor

Settings → MCP, server remoto com OAuth.

  1. 1Abra Settings → MCP.
  2. 2Adicione um server remoto com a URL do endpoint.
  3. 3Escolha autenticação OAuth.
  4. 4Autorize no browser quando o Cursor solicitar.
https://mcp.emitfy.com/mcp

ChatGPT

Apps / conectores MCP remotos (disponibilidade conforme o workspace).

  1. 1Confirme que seu workspace expõe conectores MCP remotos.
  2. 2Crie um conector com a URL do endpoint Emitfy.
  3. 3Ative o conector na conversa.
  4. 4Conclua o OAuth 2.1 com PKCE no navegador.
https://mcp.emitfy.com/mcp

As telas dos clients mudam com frequência. Se algum passo estiver diferente, procure por “conectores” ou “MCP” nas configurações. Guia técnico completo →

Dúvidas

Dúvidas comuns sobre o MCP

Preciso ser cliente Emitfy para usar o MCP?

Sim. O MCP opera a assinatura Emitfy via OAuth. Crie a conta, tenha um plano com acesso à API (Emerald ou superior) e autorize o client de IA.

A IA pode emitir ou cancelar notas?

Com o escopo de emissão, sim — a IA pode configurar e emitir. Cancelamento e certificado exigem escopos opt-in no consent. Você controla o que autoriza e pode revogar a qualquer momento.

Em quais planos o MCP funciona?

Nos planos com API inclusa: Emerald, Amethyst, Diamond e superiores. No Ruby o MCP não está disponível.

Minha API key fica no Claude ou no ChatGPT?

Não. O fluxo é OAuth 2.1 com PKCE. O secret fica vinculado server-side à conexão MCP; o token OAuth não é encaminhado à API REST como credencial.

O que é MCP?

Model Context Protocol é o padrão aberto que conecta assistentes de IA a sistemas externos de forma segura. Claude, Cursor, ChatGPT e Gemini usam o mesmo protocolo para acessar tools remotas.

O MCP substitui a API REST e os SDKs?

Não. O MCP é ideal para a IA operar o CNPJ no dia a dia. Para integrar seu produto ou ERP, use a API REST, OpenAPI e os SDKs oficiais.

Ainda não tem conta Emitfy?

Crie a conta, assine um plano com API (Emerald ou superior) e autorize o MCP no Claude, Cursor ou ChatGPT. 7 dias grátis para testar.

Criar conta grátis Ver planos →