Servidor MCP
O MCP remoto permite pedir consultas e emissões conversando com clientes compatíveis, como Claude, ChatGPT ou Cursor.
O endpoint é POST /api/mcp e usa autenticação por API key.
Como conectar
- Em Integrações, crie uma chave com escopo LEITURA para consultas ou EMISSAO quando o assistente também precisar emitir.
- No cliente MCP, adicione um servidor HTTP com o endereço
https://www.notaspj.com.br/api/mcp. - No campo de autenticação do cliente, informe a chave criada. Não a coloque em mensagens, URLs ou arquivos compartilhados.
- Teste primeiro uma consulta, como listar as empresas ou verificar o uso do mês.
Ferramentas do servidor MCP
| Ferramenta | Descrição |
|---|---|
listar_empresas | Lista as empresas emissoras ativas da conta. |
listar_clientes | Lista clientes ativos, com busca opcional por nome ou CNPJ/CPF e paginação. |
listar_perfis_tributarios | Lista perfis cadastrados na tela Perfis tributários; escolha um e informe perfilTributarioId em emitir_nfse. |
sugerir_perfil_tributario | Sugere entre os perfis cadastrados na tela Perfis tributários; escolha um e informe perfilTributarioId em emitir_nfse. |
consultar_nfse | Consulta NFS-e da conta por empresa, período de emissão, status ou tomador. |
obter_nfse | Obtém os dados detalhados de uma NFS-e pela chave de acesso, incluindo o link da DANFSe. |
emitir_nfse | Esta ferramenta emite uma nota fiscal REAL. perfilTributarioId aplica a alíquota, retenções e exigibilidade cadastradas. Antes de chamar, confirme com o usuário os dados essenciais (empresa emissora, tomador, valor, descrição do serviço). |
status_uso | Consulta a franquia de NFS-e do mês atual e o limite do plano. |
A emissão é real
Usar a ferramenta de emissão gera uma nota fiscal real. Confira empresa emissora, tomador, valor e descrição antes de confirmar.