Norman Finance

Norman MCP Server

Contabilidade, escrituração e impostos com IA para empresas europeias, dentro do seu assistente de IA.
Norman conecta faturamento, transações, recibos, livros contábeis, relatórios, impostos e fluxos de trabalho da empresa a qualquer IA compatível com MCP.

https://mcp.norman.finance/mcp

Claude  ·  ChatGPT  ·  Gemini  ·  Grok  ·  Perplexity  ·  Cursor  ·  Qualquer Cliente MCP

O que você pode fazer

Faturamento — Crie e edite faturas, orçamentos e agendamentos recorrentes, incluindo modelos de documentos, descontos por linha, unidades, datas de serviço, links de pagamento e e-faturas ZUGFeRD; cancele uma fatura emitida com uma Stornorechnung, credite parte dela com uma Rechnungskorrektur, ou crie uma nota de entrega (Lieferschein) a partir de uma fatura ou de um orçamento aprovado

Escrituração — Categorize transações, associe recibos e verifique lançamentos

Regras de automação — "Sempre lançar Telekom como custos de internet": visualize, crie e gerencie regras que categorizam transações correspondentes automaticamente

Gestão de Clientes — Mantenha seu banco de dados de clientes e informações de contato

Produtos e Serviços — Mantenha um catálogo do que você vende, com preços, alíquotas de IVA e unidades, e preencha linhas de fatura a partir dele

Declaração de Impostos — Gere prévias para o Finanzamt, declare IVA e acompanhe prazos

Visão Geral da Empresa — Verifique seu saldo, receita e saúde financeira de uma só vez

Abertura de Empresa — Funde uma GmbH ou UG alemã: colete os dados dos sócios, verifique o nome no Handelsregister, gere os documentos de constituição (Musterprotokoll, Gesellschafterliste), encontre um notário e acompanhe cada etapa até o registro

Documentos — Envie e anexe recibos, faturas e arquivos de suporte

create_attachment.file_url, importações em lote file_urls e importações estruturadas de documentos aceitam links de download HTTP(S), incluindo URLs S3 pré-assinadas não expiradas com parâmetros de consulta. Passe o link inteiro sem alterações; o host do arquivo deve aceitar a solicitação sem cabeçalhos de autorização adicionais. O downloader de URLs não tem lista de permissões de domínio, limite de comprimento de URL ou limite explícito de tamanho de arquivo. Seu tempo limite de conexão/leitura é de 30 segundos (não um prazo total de download). A rota separada de upload pelo navegador tem como padrão 50 MiB, configurável com MCP_UPLOAD_MAX_SIZE; a validação de arquivos da API ainda se aplica.

Falhas no download de URL retornam uma mensagem error e code: download_http_error (com http_status), download_timeout, download_network_error, download_storage_error ou download_error. Um erro 403 do host do arquivo pode significar uma assinatura expirada ou rejeitada; obtenha um novo link e verifique a resposta do host. Uploads em lote incluem download_errors para URLs com falha, indexados dentro de file_urls seguidos por entradas de URL do alias obsoleto file_paths; arquivos baixados com sucesso ainda são enviados. Importações estruturadas relatam erros por documento. Erros de download omitem URLs assinadas, e downloads temporários são limpos após o uso ou cancelamento.

Norman é construído como uma plataforma contábil europeia multi-mercado. Recursos específicos de mercado são adicionados conforme Norman se expande; a cobertura alemã atual inclui SKR03/SKR04, DATEV, ELSTER, ZUGFeRD e fluxos de trabalho GmbH/UG.

Aparência e atualizações de faturas

Use list_invoice_templates para descobrir os modelos, controles de aparência e o acesso ao plano da empresa ativa. Use get_invoice_settings para ler seu logotipo e padrões salvos.

create_invoice, create_recurring_invoice e create_offer aceitam document_design, por exemplo:

{"template": "sovereign", "logoSize": 75, "textSize": "medium", "spacing": "compact", "tableBorders": "grid"}

Omita document_design, font e color_schema para herdar a identidade visual salva. Ao criar, um design parcial usa os padrões desse modelo. Modelos pagos exigem uma assinatura ativa.

Use update_invoice para uma fatura ou orçamento, update_recurring_invoice para um agendamento e update_invoice_settings para padrões futuros de documentos. Seu objeto changes tipado aceita nomes de campos em camelCase ou snake_case. Campos não definidos permanecem inalterados; false explícito, 0, strings vazias e nulos válidos mantêm seu significado. Um design parcial de documento mantém os outros controles salvos do documento; alterar seu modelo começa a partir dos padrões desse modelo. Mantenha os IDs de linha existentes ao editar linhas. As taxas usam unidades monetárias menores; a API calcula os totais. Defina isToSend somente quando o envio for intencional.

Use cancel_invoice, create_credit_note e create_delivery_note para documentos derivados de uma fatura existente ou de um orçamento aprovado; cada um vincula de volta à sua origem, e uma fatura cancelada fica somente leitura depois disso. duplicate_invoice copia uma fatura ou orçamento para um rascunho novo sem vínculo. Chaves de API precisam de read_invoices para leituras de modelo/configurações e write_invoices para edições. Atualizações de configurações usam o endpoint específico de fatura e não podem editar outros campos da empresa. Implante os endpoints de API de fatura correspondentes antes de implantar esta versão do MCP.

💬 Experimente perguntar

Depois de conectar, converse com seus livros contábeis em linguagem simples:

• "Prepare e declare minha UStVA do mês passado."
• "Envie uma fatura de €1.200 para a ACME por consultoria."
• "Quanto gastei com software neste trimestre?"
• "Encontre deduções fiscais que eu possa ter perdido."
• "Quais faturas estão vencidas? Envie lembretes."

Interface interativa dentro do seu assistente de IA

Norman é mais do que uma coleção de ferramentas em segundo plano. Em clientes ChatGPT e Claude compatíveis com MCP Apps, Norman pode renderizar espaços de trabalho contábeis focados diretamente na conversa. Você pode filtrar e inspecionar os dados subjacentes, navegar entre visualizações relacionadas e usar Ask AI para continuar a discussão com o contexto contábil atual.

Experimente prompts como:

• "Abra minha Revisão de Documentos dos últimos 60 dias."
• "Mostre meu Painel de Conciliação e destaque documentos ou categorias ausentes."
• "Abra o Explorador de Livro Razão e mostre os lançamentos da conta 1200."
• "Abra minha declaração de IVA de julho, gere a prévia de teste do Finanzamt e explique o que devo revisar antes do envio."

A API Norman continua sendo a fonte da verdade. Abrir ou filtrar um espaço de trabalho não altera dados contábeis. Ações vinculantes, incluindo envio de impostos, permanecem como chamadas de ferramentas MCP separadas com suas verificações normais de confirmação e permissão. Clientes sem suporte a MCP Apps recebem os mesmos resultados subjacentes como saída estruturada ou de texto de ferramenta.

🏢 Abrindo uma empresa

Fundar uma GmbH ou UG (haftungsbeschränkt) alemã de ponta a ponta — Norman coleta os dados, prepara os documentos e faz a entrega a um notário:

• "Quero abrir uma GmbH em Berlim — me oriente no processo."
• "Fundar uma UG para mim e dois cofundadores, dividindo as ações em 60/40."
• "'Wunderbar Robotics' ainda está disponível no Handelsregister?"
• "Reformule meu objeto social para que esteja pronto para o registro."
• "Gere o Musterprotokoll e encontre um notário que faça notarização online."
• "O que falta antes de minha empresa ser oficialmente registrada?"

Escolher GmbH/UG também define sua conta Norman para o plano de contas corporativo SKR04, para que a escrituração e os impostos estejam prontos desde o primeiro dia. Os documentos são rascunhos para preparar a consulta notarial — não são aconselhamento jurídico.

👀 Veja em ação

Declarando IVA	Insights de transações
Sincronizando pagamentos do Stripe	Recibos do Gmail
Cobrando faturas vencidas	Enviando lembretes de pagamento

🚀 Comece agora

Antes de conectar, crie uma conta Norman gratuita se você ainda não tiver uma. Faça login com suas credenciais Norman via OAuth — sua senha nunca chega à IA.

/plugin marketplace add norman-finance/norman-mcp-server
/plugin install norman-finance@norman-finance

claude /plugin install github:norman-finance/norman-mcp-server

gemini extensions install https://github.com/norman-finance/norman-mcp-server

/mcp auth norman-finance

grok mcp add --transport http norman-finance https://mcp.norman.finance/mcp

mcp add https://mcp.norman.finance/mcp

git clone https://github.com/norman-finance/norman-mcp-server.git
cp -r norman-mcp-server/skills/* ~/.openclaw/skills/
openclaw gateway restart

pip install norman-mcp-server

openclaw mcp add norman -- norman-mcp --transport stdio

https://mcp.norman.finance/mcp

Skills

Skills prontas para uso, compatíveis com Claude Code, OpenClaw e o padrão Agent Skills.

Claude Code  —  /plugin marketplace add norman-finance/norman-mcp-server

Claude Code (local)  —  claude --plugin-dir ./norman-mcp-server

OpenClaw  —  cp -r skills/* ~/.openclaw/skills/ && openclaw gateway restart

Tem uma ideia de recurso? Compartilhe sua sugestão →

_{Torne os negócios sem esforço}

IVA misto e imposto de entrada documentado

Consulte o fluxo de trabalho de itens de IVA para tratamentos por item, IVA de entrada fixo documentado em EUR, reembolsos e correções manuais somente de IVA. Requer as migrações de API correspondentes e atualizações de cálculo.