Português · English · API REST · Markdown

FIZ para o Claude e o ChatGPT

A FIZ é um servidor MCP (Model Context Protocol): ligue-o ao seu assistente de IA e ele passa a consultar os seus documentos, preparar faturas e — só depois de confirmar cada uma — emiti-las.

URL do servidor: https://api.fiz.co/mcp

Como ligar

Claude (web, desktop, telemóvel)

Definições → Conectores → Adicionar conector personalizado.
Cole https://api.fiz.co/mcp e guarde.
Na conversa, ative o conector FIZ: será pedido que entre na FIZ e escolha a empresa e as permissões.

ChatGPT

Definições → Apps e conectores → Criar.
Cole https://api.fiz.co/mcp, autenticação OAuth, guarde.
Entre na FIZ quando for pedido e escolha a empresa e as permissões.

Claude Code

claude mcp add --transport http fiz https://api.fiz.co/mcp

Depois, na sessão, /mcp → fiz → Authenticate.

Permissões

No ecrã de autorização escolhe uma empresa e as permissões a delegar. Pode desmarcar qualquer uma; a ligação vale apenas para essa empresa.

company.read — Consultar empresa
invoicing.read_all — Consultar todos os dados de faturação
invoicing.read — Ler faturas, clientes e artigos
invoicing.write — Criar e editar rascunhos
invoicing.issue — Emitir documentos fiscais
bank.read — Ler movimentos bancários
expenses.read — Ler despesas
support.write — Enviar feedback ao suporte

Emitir, registar pagamentos, anular e emitir notas de crédito são atos com valor legal. Com a sincronização com a AT ativa, a FIZ comunica de imediato à Autoridade Tributária os documentos emitidos e anulados e as notas de crédito; uma empresa que entrega o SAF-T mensal por si comunica-os nesse SAF-T. Os recibos, criados ao registar um pagamento, nunca são enviados à AT. O assistente mostra-lhe sempre uma pré-visualização e só executa com a confirmação de uso único dessa pré-visualização, depois do seu sim explícito.

Ferramentas

Ferramenta	O que faz	Permissão
`get_company`	Empresa ligada, códigos CAE, definições de IVA, permissões concedidas e se já pode emitir (o que falta, com a página da FIZ)	`company.read`
`find_customers`	Pesquisar clientes por nome, NIF ou email	`invoicing.read`
`get_customer`	Detalhes de um cliente	`invoicing.read`
`find_items`	Pesquisar artigos e serviços do catálogo	`invoicing.read`
`find_invoices`	Pesquisar documentos por tipo, estado e texto	`invoicing.read`
`get_invoice`	Um documento com linhas, totais e estado na AT	`invoicing.read`
`find_proposals`	Pesquisar pro formas por estado e texto Apenas ligações pessoais e chaves API; indisponível para aplicações registadas.	`invoicing.read`
`get_proposal`	Uma pro forma com linhas, totais e faturas geradas Apenas ligações pessoais e chaves API; indisponível para aplicações registadas.	`invoicing.read`
`list_series`	Séries de numeração da empresa	`company.read`
`create_customer`	Criar um cliente	`invoicing.write`
`create_item`	Criar um artigo ou serviço (com retenção na fonte de IRS, para trabalhadores independentes, ou com a taxa de IVA de outro país da UE, para vendas OSS)	`invoicing.write`
`create_invoice_draft`	Criar um documento em rascunho (não comunicado à AT)	`invoicing.write`
`update_invoice_draft`	Alterar um rascunho	`invoicing.write`
`create_proposal`	Criar uma pro forma (numerada, sem efeitos fiscais) Apenas ligações pessoais e chaves API; indisponível para aplicações registadas.	`invoicing.write`
`prepare_issue_invoice / issue_invoice`	Pré-visualizar e, após a sua confirmação, emitir um rascunho	`invoicing.issue`
`prepare_record_payment / record_payment`	Pré-visualizar e registar um pagamento (emite recibo)	`invoicing.issue`
`prepare_cancel_invoice / cancel_invoice`	Pré-visualizar e anular um documento emitido, com motivo (erros formais como NIF, nome ou morada, ou operação inexistente; alterações da operação regularizam-se com nota de crédito)	`invoicing.issue`
`prepare_credit_note / issue_credit_note`	Pré-visualizar e emitir uma nota de crédito, total ou parcial (quantidade devolvida ou novo preço por linha)	`invoicing.issue`
`find_transport_documents`	Pesquisar guias de transporte por tipo, estado e texto	`invoicing.read`
`get_transport_document`	Uma guia com locais de carga e descarga, mercadoria e código AT	`invoicing.read`
`create_transport_document_draft`	Criar uma guia de transporte em rascunho, valorizada ou não (não comunicada à AT)	`invoicing.write`
`update_transport_document_draft`	Alterar uma guia em rascunho	`invoicing.write`
`prepare_issue_transport_document / issue_transport_document`	Pré-visualizar e, após a sua confirmação, emitir e comunicar uma guia à AT (antes da hora de carga)	`invoicing.issue`
`prepare_cancel_transport_document / cancel_transport_document`	Pré-visualizar e anular uma guia emitida, antes do início do transporte	`invoicing.issue`
`list_bank_connections`	Contas bancárias ligadas	`bank.read`
`find_bank_transactions`	Movimentos de uma conta bancária	`bank.read`
`find_expenses`	Despesas importadas do e-Fatura, com classificação e IVA dedutível	`expenses.read`
`get_expense_stats`	Totais das despesas de um período	`expenses.read`
`send_feedback`	Enviar um relato de erro ou sugestão ao suporte FIZ, depois de o confirmar	`support.write`

Desligar

Em app.fiz.co/settings/integrations, secção Assistentes de IA ligados: Desligar revoga o acesso imediatamente. Apagar a conta FIZ revoga todas as ligações.

Dados

Os dados devolvidos ao assistente (nomes de clientes, NIFs, valores) são tratados pelo fornecedor do assistente (Anthropic ou OpenAI) segundo as respetivas condições. A FIZ não guarda o conteúdo das conversas. Não há chaves API envolvidas: o acesso é uma ligação OAuth com tokens de curta duração.

FIZ for Claude and ChatGPT

FIZ is an MCP (Model Context Protocol) server: connect it to your AI assistant and it can look up your documents, draft invoices and — only after you confirm each one — issue them.

Server URL: https://api.fiz.co/mcp

How to connect

Claude (web, desktop, mobile)

Settings → Connectors → Add custom connector.
Paste https://api.fiz.co/mcp and save.
Enable the FIZ connector in a chat: you will be asked to sign in to FIZ and choose the company and permissions.

ChatGPT

Settings → Apps & Connectors → Create.
Paste https://api.fiz.co/mcp, OAuth authentication, save.
Sign in to FIZ when prompted and choose the company and permissions.

Claude Code

claude mcp add --transport http fiz https://api.fiz.co/mcp

Then, in the session, /mcp → fiz → Authenticate.

Permissions

On the authorization screen you pick one company and the permissions to delegate. Untick any of them; the connection is valid for that company only.

company.read — Read company settings
invoicing.read_all — Read all company invoicing data
invoicing.read — Read invoices, customers and items
invoicing.write — Create and edit drafts
invoicing.issue — Issue fiscal documents
bank.read — Read bank transactions
expenses.read — Read expenses
support.write — Send feedback to support

Issuing, recording payments, cancelling and issuing credit notes are legally binding acts. With AT sync on, FIZ reports issued and cancelled documents and credit notes to the Portuguese tax authority (AT) at once; a company that files its monthly SAF-T by hand reports them in that SAF-T. Receipts, created when you record a payment, are never sent to the AT. The assistant always shows you a preview and executes only on the single-use confirmation of that preview, after your explicit yes.

Tools

Tool	What it does	Permission
`get_company`	Connected company, activity codes, VAT settings, granted permissions, and whether it can issue now (what is missing, with the FIZ page)	`company.read`
`find_customers`	Search customers by name, tax number or email	`invoicing.read`
`get_customer`	One customer in full	`invoicing.read`
`find_items`	Search the catalogue of products and services	`invoicing.read`
`find_invoices`	Search documents by type, status and text	`invoicing.read`
`get_invoice`	One document with lines, totals and tax-authority status	`invoicing.read`
`find_proposals`	Search pro formas by status and text Personal connections and API keys only; unavailable to registered applications.	`invoicing.read`
`get_proposal`	One pro forma with lines, totals and the invoices raised from it Personal connections and API keys only; unavailable to registered applications.	`invoicing.read`
`list_series`	The company’s numbering series	`company.read`
`create_customer`	Create a customer	`invoicing.write`
`create_item`	Create a catalogue item (with IRS withholding, for self-employed individuals, or at another EU country's VAT rate, for OSS sales)	`invoicing.write`
`create_invoice_draft`	Create a draft document (not reported to the AT)	`invoicing.write`
`update_invoice_draft`	Change a draft	`invoicing.write`
`create_proposal`	Create a pro forma (numbered, no fiscal effect) Personal connections and API keys only; unavailable to registered applications.	`invoicing.write`
`prepare_issue_invoice / issue_invoice`	Preview and, after your confirmation, issue a draft	`invoicing.issue`
`prepare_record_payment / record_payment`	Preview and record a payment (issues a receipt)	`invoicing.issue`
`prepare_cancel_invoice / cancel_invoice`	Preview and annul an issued document, with a reason (formal errors such as NIF, name or address, or an operation that never happened; changes to the operation are corrected with a credit note)	`invoicing.issue`
`prepare_credit_note / issue_credit_note`	Preview and issue a credit note, full or partial (returned quantity or new price per line)	`invoicing.issue`
`find_transport_documents`	Search transport documents (guias) by type, status and text	`invoicing.read`
`get_transport_document`	One transport document with loading and unloading places, goods and AT code	`invoicing.read`
`create_transport_document_draft`	Create a draft transport document, with or without prices (not reported to the AT)	`invoicing.write`
`update_transport_document_draft`	Change a draft transport document	`invoicing.write`
`prepare_issue_transport_document / issue_transport_document`	Preview and, after your confirmation, issue a transport document and report it to the AT (before the loading time)	`invoicing.issue`
`prepare_cancel_transport_document / cancel_transport_document`	Preview and annul an issued transport document, before the transport starts	`invoicing.issue`
`list_bank_connections`	Connected bank accounts	`bank.read`
`find_bank_transactions`	Transactions of one bank account	`bank.read`
`find_expenses`	Expenses imported from e-Fatura, with categorisation and deductible VAT	`expenses.read`
`get_expense_stats`	Expense totals for a period	`expenses.read`
`send_feedback`	Send a bug report or suggestion to FIZ support, after you confirm it	`support.write`

Disconnect

At app.fiz.co/settings/integrations, section Connected AI assistants: Disconnect revokes access immediately. Deleting the FIZ account revokes every connection.

Data

Data returned to the assistant (customer names, tax numbers, amounts) is processed by the assistant’s provider (Anthropic or OpenAI) under their terms. FIZ does not store conversation content. No API keys are involved: access is an OAuth connection with short-lived tokens.