Assistentes de IA (MCP)

O produto tem um servidor MCP — o Claude e outros assistentes podem consultar e operar a sua conta, respeitando as permissões da chave.

Endpoint: https://app.fiscal.protoncode.com.br/mcp (Streamable HTTP)
Autenticação: Authorization: Bearer pk_live_... — crie uma chave só com as permissões que o assistente deve ter.

Conectar

Claude Code

bash

claude mcp add --transport http fiscal https://app.fiscal.protoncode.com.br/mcp \
  --header "Authorization: Bearer pk_live_xxx"

Claude Desktop / outros clientes: adicione um servidor MCP remoto com a URL acima e o header de autorização.

Ferramenta	O que faz	Permissão
`get_issuer_status`	Diz se a empresa já pode emitir e o que falta	`invoices:read`
`list_invoices`	Lista as notas (filtros: status, external_ref)	`invoices:read`
`get_invoice`	Busca uma nota	`invoices:read`
`issue_invoice`	Emite uma NFS-e (`external_ref` obrigatório: repetir não emite de novo)	`invoices:write`
`cancel_invoice`	Pede o cancelamento de uma nota autorizada	`invoices:cancel`

Tudo o que o assistente faz fica registrado na auditoria da conta e dispara os mesmos webhooks.