fiscal

---

概要

Brasil NFe MCP は、ブラジルの税務インフラ全体を、MCP 対応のあらゆるクライアント（Claude Desktop、Cursor、Windsurf、VS Code Copilot、Zed、Continue.dev、JetBrains、自社アプリケーションなど）向けのツール、リソース、プロンプトとして公開する、初の MCP（Model Context Protocol）サーバーです。

サーバーを MCP クライアントに接続すると、AI エージェントが会話の中で自然言語を使って直接、税務書類を発行できるようになります。「この CPF 宛てに R$ 89,90 の NFC-e を発行して」と伝えると、書類が SEFAZ に送信されます。AI は自動的にツールを見つけ、スキーマに基づいてペイロードを作成し、SEFAZ のエラーをわかりやすい言葉に変換します。

REST API と MCP のどちらを選ぶべきですか？

どちらも Brasil NFe の主要製品であり、同じ税務インフラを公開しています。SEFAZ バックエンド、SLA、人的サポートも共通です。選択の基準は統合方法であり、品質ではありません。

REST API を使う場合	MCP を使う場合
ERP、業務管理システム、または発行フローがすでに定義された独自アプリがある	AI アシスタント、コパイロット、エージェントに発行のタイミングや方法を判断させたい
バッチ処理、スケジュール処理、またはキュー／Webhook イベントによる処理を行う	ユーザー（またはエージェント）が各ステップを指示する対話型のフローである
統合が決定論的で、UI/UX をピクセル単位で制御したい	顧客が会計士の Claude／Cursor／Copilot を業務に直接接続したい
大量処理、最適化された並列処理、安定したペイロード契約が必要	自然言語による対話型、探索型、アドホックなセッションが必要

どちらも同じバックエンドと連携します。ERP を REST で統合しつつ、会計士の AI を MCP に接続することもできます。REST API に新しいルートが追加されると、自動的に MCP ツールにもなります。税務ロードマップは共通で、利用チャネルが 2 つあります。

公開エンドポイント

https://api.brasilnfe.com.br/services/Mcp

リソース	メソッド	パス
JSON-RPC	POST	/services/Mcp
SSE ストリーム	GET	/services/Mcp
セッション終了	DELETE	/services/Mcp
ディスカバリー	GET	/.well-known/mcp
ヘルスチェック	GET	/services/Mcp/info

• トランスポート： Streamable HTTP
• 仕様： MCP 2025-06-18
• 認証： Bearer トークン（Authorization: Bearer <TOKEN>）
• レート制限： トークンごとに 1 分あたり 60 リクエスト（デフォルト）

公開されている内容

8カテゴリに30以上のツール

カテゴリ	ツール	機能
NF-e / NFC-e	nfe_emitir, nfe_emitir_complementar, nfe_previsualizar	B2B製品（モデル55）または小売用レシート（モデル65）を発行し、DANFEのプレビューを生成します
NFS-e	nfse_emitir, nfse_consultar	サービス請求書を発行・照会します（5,500以上の自治体ルールを内蔵）
CT-e	cte_emitir, cte_desacordo	輸送書類を発行し、荷受人の異議を登録します
MDF-e	mdfe_emitir, mdfe_encerrar	貨物マニフェストを発行し、輸送終了時に閉鎖します
DC-e	dce_emitir	内容申告書（個人／MEI）を発行します
NF-EnerCom	nfenercom_gerar_arquivo, nfenercom_emitir	販売電力のNFを発行します
税務イベント	evento_cancelar, evento_carta_correcao, evento_manifestar, evento_inutilizar	取り消し、訂正（CC-e）、受取人による申し立て、番号の無効化を行います
SEFAZ照会	sefaz_status, cadastro_consultar, nota_listar, imposto_calcular	サービス状況、IE、請求書一覧、税額シミュレーター
登録情報	cliente_consultar/criar/editar, produto_consultar/criar/editar, tributacao_consultar/criar/editar	顧客、製品、税務ルールの完全なCRUD（連邦歳入庁へのフォールバック付き）
ファイル	arquivo_baixar, arquivo_baixar_evento, arquivo_baixar_periodo	XML／PDFの個別ファイル、または期間分のZIPをダウンロードします
補助ツール	fci_gerar, health	FCI（輸入内容）を生成し、ヘルスチェックを実行します

5つのリソース（URIスキーム brasilnfe://）

• brasilnfe://empresa/atual - ログイン中の企業のスナップショット
• brasilnfe://nfe/{chave}/xml - 認可済みXML
• brasilnfe://nfe/{chave}/danfe - PDF形式のDANFE
• brasilnfe://evento/{chave}/{seq} - シーケンス番号で指定したイベント
• brasilnfe://recebidas/{periodo} - 期間内に受領した請求書

5つのすぐに使えるプロンプト

• emitir_nfe_simples - NF-e発行のガイド付きワークフロー
• cancelar_nota - 期限確認付きのキャンセル
• diagnostico_emissao - 発行前の完全なチェック
• relatorio_periodo - 期間ごとの税務レポート
• carta_correcao - 許可された項目の確認付きCC-eワークフロー

クイックスタート

1. トークンを取得する

brasilnfe.com.brで無料アカウントを作成し、パネルでトークンをコピーします。検証モードは無料です。本番環境のSEFAZに送信されることなく、テスト書類を好きなだけ発行できます。

2. MCP クライアントを設定する

examples/から適切なファイルを取得し、クライアントの設定に貼り付けます。

• Claude Desktop
• Cursor
• Windsurf
• VS Code Copilot
• Zed
• 純粋なcURL（JSON-RPC）

SEU_TOKEN_AQUIを実際のトークンに置き換え、クライアントを再起動します。

3. AIに話しかける

"Liste o status da SEFAZ pra SP."
"Consulte o CNPJ 39.658.743/0001-99."
"Emite uma NFC-e de R$ 89,90 pro consumidor com CPF 123.456.789-00."
"Cancela a chave 35..., justificativa: erro de digitação no valor."

これで完了です。AIがツールを自動で見つけ、不足情報を尋ね、入力データを検証して組み立て、SEFAZに送信し、キー、プロトコル、XML、PDFを返します。

登録不要のデモ

**brasilnfe.com.br/ai**を開き、ブラウザーから税務アシスタントと直接チャットできます。本番環境のSEFAZには送信されませんが、チャットの横にDANFEがリアルタイムで表示される、完全なワークフローを確認できます。

ベストプラクティス

• 本番環境で使う前に、必ず検証環境（tipoAmbiente: 2）で実行してください。 テスト書類では許可されたCNPJと別の番号体系を使用するため、税務上のリスクはありません。
• 登録情報を作成する前に、顧客／製品／税務情報を照会してください。 *_consultarツールで重複を防ぎ、既存の登録情報を再利用できるようAIにコンテキストを提供できます。
• 破壊的な操作は確認してください。 キャンセルと無効化は取り消せません。AIには確認するよう指示されていますが、ワークフロー内でも確認してください。
• アイドル状態のセッションを終了してください。 DELETE /services/Mcpを実行すると、クォータを早く解放できます。
• 監査ログは自動的に作成されます。 すべてのMCP呼び出しは、企業のパネルに5年間記録されます（LGPD準拠）。

サポート

• ドキュメント： brasilnfe.com.br/mcp
• ライブデモ： brasilnfe.com.br/ai
• WhatsApp： +55 (31) 9 7168-5947（営業時間内）
• メール： [email protected]（24時間年中無休）
• LGPD/DPO： [email protected]

概要

Brasil NFe LTDA（CNPJ 39.658.743/0001-99）が運営しています。2019年にMaxsuel LimaによってIpatinga/MGで設立されました。ブラジルの税務自動化を専門としており、6種類の税務書類、5,500件以上の自治体NFS-eルール、543件のSEFAZコードを内蔵し、PCI DSSに準拠しています。また、24時間年中無休で人によるサポートを提供しています。

ライセンス

MIT - このリポジトリ（設定、サンプル、ドキュメント）は自由に使用、変更、配布できます。MCP サーバー自体はBrasil NFe LTDAが運営するサービスです。利用規約とプライバシーポリシーをご覧ください。