Conectar sua IA ao notas.dev

O endereço do servidor

https://notas.dev/mcp

Transporte HTTP (Streamable HTTP, sem SSE). Dois jeitos de autenticar: OAuth (login + tela de autorização, usado pelo Claude e pelo ChatGPT) ou chave de API no header X-API-Key (Claude Code, Cursor, VS Code e scripts). A chave é gerada no painel, em Chaves de API.

Abriu este endereço no navegador? Ele está certo, mas é para colar no app de IA, não no navegador. O navegador recebe esta página; o app recebe o protocolo.

Antes de conectar

1. Crie a conta em notas.dev/login (link ou código por e-mail, sem senha).
2. Suba o certificado A1 (.pfx e senha) no painel.
3. Tenha créditos de nota: as 10 grátis saem ao cadastrar o cartão e autorizar o reabastecimento.

Dá para conectar antes do certificado: a IA consegue ver o saldo e listar o que já existe, mas só emite com o A1 cadastrado.

Claude (claude.ai, desktop e celular)

1. Abra Configurações → Conectores e escolha Adicionar conector personalizado.
2. Nome: notas.dev. URL: https://notas.dev/mcp. Não precisa preencher client ID nem secret.
3. Clique em Conectar, entre com o seu e-mail e clique em Permitir na tela de autorização do notas.dev.
4. Numa conversa nova, ative o conector no menu de ferramentas.

O conector adicionado no claude.ai aparece também no app desktop e no celular. Em contas Team e Enterprise, quem adiciona conector é o administrador.

ChatGPT

1. Em Configurações → Apps e conectores, abra as configurações avançadas e ligue o modo de desenvolvedor.
2. Clique em Criar, dê o nome notas.dev, cole https://notas.dev/mcp e escolha autenticação OAuth.
3. Faça login e clique em Permitir. Na conversa, escolha o notas.dev nas ferramentas.

O ChatGPT pede confirmação antes de ações de escrita. Ainda assim, quem decide a emissão é a prévia: sem o seu OK, nada sai.

Claude Code

Com chave de API (gere em Chaves de API):

claude mcp add --transport http notas-dev https://notas.dev/mcp \
  --header "X-API-Key: nmcp_..."

Ou sem chave, pelo login: rode claude mcp add --transport http notas-dev https://notas.dev/mcp e depois /mcp dentro do Claude Code para autenticar no navegador.

Cursor

Em ~/.cursor/mcp.json (ou .cursor/mcp.json no projeto):

{
  "mcpServers": {
    "notas-dev": {
      "url": "https://notas.dev/mcp",
      "headers": { "X-API-Key": "nmcp_..." }
    }
  }
}

VS Code (Copilot)

Em .vscode/mcp.json. A chave é pedida na primeira vez e fica guardada pelo VS Code, fora do arquivo:

{
  "inputs": [{ "type": "promptString", "id": "notas-dev-chave",
               "description": "Chave de API do notas.dev", "password": true }],
  "servers": {
    "notas-dev": {
      "type": "http",
      "url": "https://notas.dev/mcp",
      "headers": { "X-API-Key": "${input:notas-dev-chave}" }
    }
  }
}

O primeiro pedido

Para testar a conexão sem emitir nada, peça:

Quantas notas eu tenho no notas.dev?

A IA chama saldo e responde com as notas disponíveis e o preço. Depois, uma emissão de verdade:

Emite uma nota de R$ 800,00 pra Acme Digital, CNPJ 11.222.333/0001-81,
consultoria de outubro.

A IA chama emitir_nota e mostra a prévia. A nota só sai quando você responde "pode emitir".

As 10 ferramentas

"Fiscal" é o que tem efeito na SEFIN e exige o seu OK na conversa. A IA nunca baixa o PDF: ela entrega o link, que você abre logado no painel.

O que é MCP

MCP (Model Context Protocol) é o padrão aberto que deixa uma IA usar ferramentas de verdade em vez de só escrever texto. É a diferença entre a IA explicar como emitir uma nota e a IA emitir a nota, com a sua confirmação.

Sem IA? A mesma emissão existe como API REST, para n8n, Make ou backend próprio.