Notavia Central de Ajuda Documentação da API →

Assistentes de IA (Claude, ChatGPT, Gemini, Grok)

Você pode ligar o assistente de IA que já usa — Claude, ChatGPT, Gemini, Grok ou outro que aceite o padrão MCP — à sua conta da Notavia. Depois de conectado, você conversa com ele em linguagem natural: "quais notas foram rejeitadas esta semana?", "qual a minha cota do mês?", "simule o imposto deste produto".

Recurso em liberação gradual. Está disponível só para contas que a Notavia habilitou e apenas nos planos pagos. Para pedir a liberação, fale com o suporte (veja Falar com o suporte).

O que o assistente pode fazer

Ele pode Quando
Consultar notas, situação na SEFAZ, cadastros, cota do plano e o simulador de impostos Sempre que você autoriza a conexão
Emitir notas fiscais Só se o Admin da conta permitiu emissão por assistentes de IA e você marcou essa permissão ao conectar
Cancelar notas fiscais Só com a mesma permissão do Admin e a sua marcação específica de cancelamento

Três regras valem sempre:

Como o Admin libera

  1. Liberação do recurso na conta: feita pelo suporte da Notavia (funcionalidade mcp-clientes).
  2. Emissão e cancelamento: por padrão o assistente só lê. Para permitir mais, abra Administração → Assistentes de IA e ligue "Permitir que assistentes de IA emitam e cancelem notas" (o Admin confirma antes de ligar; para desligar não há confirmação e vale na hora). Sem essa permissão, a opção de emissão aparece desabilitada na tela de autorização e nos tokens pessoais.

Tudo o que se faz com os assistentes fica em Administração → Assistentes de IA (só o Admin enxerga): a URL do servidor para copiar, a permissão de emissão, os assistentes conectados e os tokens de acesso pessoal.

Como conectar

O endereço do servidor é sempre o mesmo:

https://mcp.notavia.com.br/mcp

Ao conectar, o assistente abre uma página da Notavia pedindo o seu login (Google, Microsoft ou e-mail) e a sua autorização. Ela mostra qual assistente quer acesso, a conta, as empresas que ele poderá ver e o que poderá fazer.

Claude (claude.ai e aplicativo)

  1. Em Configurações → Conectores, escolha Adicionar conector personalizado.
  2. Informe o nome (por exemplo, "Notavia") e a URL acima.
  3. Clique em Conectar e conclua o login e a autorização na página da Notavia.

ChatGPT

  1. Ative o modo desenvolvedor em Configurações → Conectores → Avançado.
  2. Crie um conector com a URL acima e autenticação OAuth.
  3. Conclua o login e a autorização.

Gemini (Gemini CLI)

O aplicativo de consumo do Gemini não aceita servidores MCP personalizados; use o Gemini CLI. No arquivo settings.json do CLI:

{
  "mcpServers": {
    "notavia": { "httpUrl": "https://mcp.notavia.com.br/mcp" }
  }
}

Na primeira chamada o CLI abre o navegador para o login e a autorização.

Grok (API da xAI)

A API do Grok usa o servidor MCP remoto informado na chamada, mas não faz o login no navegador. Ela precisa de um token de acesso pessoal da Notavia, criado em Administração → Assistentes de IA → Criar token:

  1. Dê um nome (por exemplo "Grok — fechamento do mês").
  2. Marque o que o token pode fazer. Consultar é sempre incluído; emitir e cancelar só ficam disponíveis se a permissão de emissão estiver ligada na mesma tela.
  3. Escolha a validade (30, 90, 180 ou 365 dias — não existe token sem validade).
  4. Copie o valor na hora: ele só aparece uma vez e não pode ser consultado depois. Se perder, revogue e crie outro.

O token age como o usuário que o criou, com as mesmas empresas e o mesmo papel dele, e nunca com mais do que a conta permite no momento da chamada. Envie-o no cabeçalho Authorization: Bearer ntv_mcp_….

DeepSeek

O DeepSeek não tem suporte nativo a MCP. É possível usar o modelo DeepSeek dentro de um cliente de terceiros que fale MCP (por exemplo Cherry Studio, LibreChat ou Open WebUI), apontando o cliente para a URL acima. A conexão segue o mesmo fluxo de login e autorização.

Como revogar

Limites

Privacidade

Ao conversar com o assistente, as respostas da Notavia (por exemplo, a lista de notas e valores) passam pelo provedor de IA que você escolheu (Anthropic, OpenAI, Google, xAI etc.), sob os termos e a política de privacidade dele. A Notavia entrega os dados porque você autorizou aquela conexão; o provedor não é suboperador da Notavia. Conecte apenas assistentes em que você confia e evite pedir a ele dados de que não precisa.

A Notavia registra, na auditoria da conta, qual assistente acessou, com que usuário, em qual empresa e quando. Veja a Política de Privacidade para os detalhes.

Dicas e cuidados