mcp-nfe-io

@codespar/mcp-nfe-io

NFe.io 用 MCP サーバー — ブラジルの NF-e／NFS-e の税務書類発行に加え、CNPJ と CEP を照会できます。

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "nfe-io": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-nfe-io"],
      "env": {
        "NFEIO_API_KEY": "your-api-key",
        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"
      }
    }
  }
}

Claude Code

claude mcp add nfe-io -- npx @codespar/mcp-nfe-io

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "nfe-io": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-nfe-io"],
      "env": {
        "NFEIO_API_KEY": "your-api-key",
        "NFEIO_COMPANY_ID": "your-company-id-or-cnpj"
      }
    }
  }
}

ツール（22）

ツール	用途
create_nfse	NFS-e（サービス請求書）を発行します。
get_nfse	ID を指定して NFS-e を取得します。
cancel_nfse	NFS-e をキャンセルします。
list_nfse	ページネーションに対応し、任意の flowStatus フィルターを指定して NFS-e を一覧表示します。
email_nfse	発行済み NFS-e の PDF を宛先にメールで送信します。
create_nfe	NF-e（製品請求書）を発行します。
get_nfe	ID を指定して NF-e を取得します。
cancel_nfe	NF-e をキャンセルします。
list_nfe	ページネーションに対応し、任意の status フィルターを指定して NF-e を一覧表示します。
get_nfe_pdf	発行済み NF-e の DANFE PDF URL を返します。
consult_cnpj	CNPJ を指定してブラジル企業の情報（商号、ステータス、住所）を照会します。
consult_cep	ブラジルの郵便番号（CEP）から住所全体を取得します。
correct_nfe	認可済み NF-e の Carta de Correção（CC-e）を発行します。
get_nfe_xml	NF-e の認可済み XML URL を返します。
get_nfse_pdf	発行済み NFS-e の PDF URL を返します。
get_nfse_xml	発行済み NFS-e の XML URL を返します。
list_companies	NFe.io アカウントに登録されている企業を一覧表示します。
get_company	ID または CNPJ を指定して企業を取得します。
create_company	NFe.io に新しい企業を登録します。
list_webhooks	企業に登録されている Webhook エンドポイント（請求書イベントのコールバック）を一覧表示します。
create_webhook	Webhook エンドポイントを登録します。
delete_webhook	ID を指定して Webhook エンドポイントを削除します。

環境変数

変数	必須	備考
NFEIO_API_KEY	はい	発行および照会のスコープが必要です。NFe.io では 2 つのキーに分けることもできます。どちらでも使用できます。
NFEIO_COMPANY_ID	いいえ	デフォルトの企業 ID（または CNPJ）です。呼び出しごとの company_id 引数がこの値より優先されます。

ホスト

NFe.io の API は 3 つのホスト名に分かれています。このサーバーは、ツールを自動的に適切なホストに割り当てます：

• api.nfse.io — 製品請求書
• api.nfe.io — サービス請求書および企業管理
• nfe.api.nfe.io — 照会（CNPJ、CEP）

デモモード

--demo を渡すか、MCP_DEMO=true を設定すると、ネットワークにアクセスせずに定型の応答を返します。ドキュメント、スクリーンキャスト、CI に便利です。

リンク

• NFe.io REST API ドキュメント
• CodeSpar MCP Brazil カタログ

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、次の環境変数を設定します：

• NFEIO_API_KEY (必須、シークレット) — NFe.io の API キー（発行および照会）
• NFEIO_COMPANY_ID — 呼び出しごとに指定されない場合に使用するデフォルトの企業 ID（CNPJ または NFe.io の企業 UUID）

認証情報はプロバイダーの開発者ポータルで発行します：https://nfe.io/docs。

ライセンス

MIT