Português · English · API REST

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

Emitir, registar pagamentos, anular e emitir notas de crédito são atos com valor legal comunicados à Autoridade Tributária. O assistente mostra-lhe sempre uma pré-visualização e só executa depois da sua confirmação explícita; se o documento mudar entretanto, a operação é recusada.

Ferramentas

Ferramenta	O que faz	Permissão
`get_company`	Empresa ligada, códigos CAE e permissões concedidas	`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	`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	`invoicing.issue`
`prepare_credit_note / issue_credit_note`	Pré-visualizar e emitir uma nota de crédito (reversão total)	`invoicing.issue`
`list_bank_connections`	Contas bancárias ligadas	`bank.read`
`find_bank_transactions`	Movimentos de uma conta bancária	`bank.read`

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

Issuing, recording payments, cancelling and issuing credit notes are legally binding acts reported to the Portuguese tax authority. The assistant always shows you a preview and executes only after your explicit confirmation; if the document changes in between, the operation is refused.

Tools

Tool	What it does	Permission
`get_company`	Connected company, activity codes and granted permissions	`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	`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 cancel an issued document	`invoicing.issue`
`prepare_credit_note / issue_credit_note`	Preview and issue a credit note (full reversal)	`invoicing.issue`
`list_bank_connections`	Connected bank accounts	`bank.read`
`find_bank_transactions`	Transactions of one bank account	`bank.read`

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.