Nota4You

Assistentes de IA

Peça a nota em linguagem natural: "Emita uma nota de R$ 1.500 para a Acme pela manutenção de outubro." O assistente usa o nosso servidor MCP (Model Context Protocol).

Endereço do servidor

https://app-staging.nota4you.com.br/mcp

Transporte Streamable HTTP. Autenticação por OAuth 2.1 (claude.ai, ChatGPT) ou por chave de API com o escopo mcp (Claude Code, Cursor, VS Code).

Mensagem para começar

Leia https://staging.nota4you.com.br/skill.md e siga as instruções.

Com o servidor já conectado: "Quero emitir minha primeira NFS-e. Use as ferramentas do servidor nota4you e siga o prompt first_invoice."

Claude (claude.ai e app)

Em Configurações > Conectores, escolha "Adicionar conector personalizado", cole o endereço do servidor e entre com a sua conta do Nota4You quando o Claude pedir. Na tela de autorização, escolha os escopos e as empresas que o assistente pode usar.

ChatGPT

Em Configurações > Aplicativos e conectores, ative o modo desenvolvedor, crie um conector com o endereço do servidor e autorize o acesso com a sua conta do Nota4You.

Claude Code

Com OAuth (o Claude Code abre o navegador para você autorizar):

claude mcp add --transport http nota4you https://app-staging.nota4you.com.br/mcp

Com uma chave de API:

claude mcp add --transport http nota4you https://app-staging.nota4you.com.br/mcp --header "Authorization: Bearer <sua chave>"

Cursor e VS Code

No app, a página "Comece com IA" tem os botões de instalação. Ou configure à mão:

{
  "mcpServers": {
    "nota4you": {
      "type": "http",
      "url": "https://app-staging.nota4you.com.br/mcp",
      "headers": { "Authorization": "Bearer <sua chave>" }
    }
  }
}

Ferramentas

Ferramenta O que faz
get_setup_status Mostra o que falta para a primeira nota e o próximo passo.
lookup_company Consulta o CNPJ no cadastro público.
create_taxpayer Cadastra a empresa a partir do CNPJ.
search_service_codes Busca códigos de tributação nacional.
create_service, list_services Cadastra e lista serviços.
search_customers, create_customer Busca e cadastra clientes.
request_certificate_upload Gera um link de uso único para enviar o certificado.
list_taxpayers Lista as empresas que o assistente pode usar.
preview_invoice Valida a nota e estima os tributos, sem emitir.
emit_invoice Emite a nota que você aprovou na prévia.
get_invoice, list_invoices Consulta a situação, o número, os eventos e o DANFSe.
cancel_invoice Cancela uma nota autorizada, depois da sua confirmação. Precisa do escopo invoices:cancel.

Prompts: first_invoice (da empresa à primeira nota), emit_invoice e monthly_billing (várias notas de uma lista).

Regras de segurança