NotaMCP

io.github.CssEoCAO由 GitHub 账号 CssEoCAO 发布v1.0.0更新于 Oct 29, 2026

Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

远程 MCP 服务器，让 AI 对话开具巴西服务发票（NFS-e Nacional），带预览、显式确认与预付额度。

可以做什么
  • 准备发票：生成含确认令牌的预览，可复用已保存的服务、CNAE、NBS 与税务组合
  • 确认并正式开具发票，查询单张发票状态或列出账户历史
  • 填写原因并显式确认后取消已授权的发票
  • 管理常用客户：按名称搜索已保存的收票方，保存或更新
  • 查看剩余额度、单张价格、环境与每日上限，并生成 Pix/银行卡付款链接购买额度
适用场景
适合已持有 A1 数字证书和 NotaMCP 账户的巴西服务提供者，希望以对话方式起草、开具、跟踪和取消 NFS-e 发票。
运行要求
远程 streamable HTTP 端点 notamcp.com.br，无需安装包或环境变量。需要 NotaMCP 账户及用户本人的 A1 数字证书；调用任何工具都会触发 NotaMCP 登录流程。
安装前请注意
开具发票具有法律效力且不可撤销：服务器要求助手仅在用户明确同意后确认，取消也不会退回开具所扣的额度。每张被授权的发票都会扣除预付额度，购买额度会生成真实付款链接。助手无法下载或读取返回的 PDF/XML 链接。

安装

在 SourceWeft 中

  1. 打开 控制台中的 NotaMCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.CssEoCAO%2Fnotamcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "notamcp": {
      "type": "http",
      "url": "https://notamcp.com.br/mcp"
    }
  }
}

工具

10

emitir_nota

Preparar emissão de NFS-e (prévia)

Prepara uma NFS-e e devolve a PRÉVIA + confirmacao_token. NÃO emite nada. Mostre a prévia ao usuário e chame confirmar_emissao só depois do OK explícito dele. Tomador: informe tomador_id (salvo) OU tomador_doc + tomador_razao.

输入参数valor必填tomador_idcompetenciatomador_docconfiguracaotomador_paistomador_tipodiscriminacao必填tomador_razaoconfiguracao_id

listar_configuracoes

Listar configurações fiscais recentes

Últimas combinações realmente usadas de serviço, CNAE, NBS e tributação. Use configuracao_id em emitir_nota. Se houver ambiguidade, pergunte ao usuário — não escolha nem invente código fiscal.

输入参数limite

confirmar_emissao

Confirmar e emitir a NFS-e

Emite DE VERDADE a nota da prévia. Chame apenas depois que o usuário aprovou a prévia nesta conversa. Idempotente: o mesmo token nunca emite duas vezes. Autorizada, devolve danfse_url (PDF) e xml_url — links para o usuário abrir, que você não consegue baixar.

输入参数confirmacao_token必填

consultar_nota

Consultar uma nota

Situação de uma nota desta conta (status, número, chave de acesso, erro).

输入参数nota_id必填

listar_notas

Listar notas

Histórico de notas da conta, com filtros opcionais.

输入参数limitestatuscompetencia

cancelar_nota

Cancelar uma nota

Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis.

输入参数motivo必填nota_id必填confirmar必填codigo_motivo

listar_tomadores

Listar tomadores salvos

Tomadores salvos desta conta (use o id em emitir_nota). Passe `busca` com o NOME que o usuário falou para achar o tomador sem precisar do CNPJ — ignora acento, caixa e pontuação. Se voltar mais de um, pergunte qual antes de emitir.

输入参数busca

salvar_tomador

Salvar tomador

Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador").

输入参数docpaistiporazao必填

saldo

Créditos de notas e limites

Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade.

无需输入参数。

comprar_creditos

Adicionar créditos de notas

Gera um link de pagamento (Pix/cartão) para adicionar créditos de notas. Entregue o link ao usuário — o pagamento acontece no navegador dele e as notas entram após a confirmação.

输入参数valor_centavos必填

版本历史

1
  1. v1.0.0最新Oct 29, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库，或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用，因此这里不要求许可证。此检查项不计入百分比。