mcp-focus-nfe

@codespar/mcp-focus-nfe

Focus NFe 用の MCP サーバー — NFe、NFSe、NFCe の税務書類発行

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}

ツール（19）

ツール	目的
create_nfe	NFe（電子税務請求書）を作成して発行します
get_nfe	参照情報から NFe の詳細とステータスを取得します
cancel_nfe	認可済みの NFe をキャンセルします（発行後 24 時間以内）
get_nfe_pdf	NFe PDF（DANFE）のダウンロード URL を取得します
send_correction_letter	認可済みの NFe の訂正書（Carta de Correcao / CCe）を送信します
create_nfse	NFSe（サービス電子税務請求書）を作成して発行します
get_nfse	参照情報から NFSe の詳細とステータスを取得します
cancel_nfse	認可済みの NFSe をキャンセルします
create_nfce	NFCe（電子消費者税務請求書）を作成して発行します
get_nfce	参照情報から NFCe の詳細とステータスを取得します
cancel_nfce	認可済みの NFCe をキャンセルします
create_cte	貨物輸送用の CTe（電子輸送伝票）を作成して発行します
get_cte	参照情報から CTe の詳細とステータスを取得します
cancel_cte	認可済みの CTe をキャンセルします
create_mdfe	貨物輸送マニフェスト用の MDFe（電子税務書類マニフェスト）を作成して発行します
close_mdfe	旅程完了後に MDFe を閉鎖／確定します（encerramento）
register_webhook	税務書類のイベント発生時に指定 URL へ通知する Webhook トリガー（gatilho）を登録します
list_webhooks	登録済みの Webhook トリガー（gatilhos）をすべて一覧表示します
delete_webhook	ID を指定して登録済みの Webhook を削除します

認証

Focus NFe は、ユーザー名に API トークン、パスワードに空文字を使用する Basic Auth を使用します。

サンドボックス／テスト

Focus NFe は homologacao.focusnfe.com.br に検証環境を提供しています。これを使用するには、FOCUS_NFE_SANDBOX=true を設定します。

認証情報の取得

1. Focus NFe にアクセスします
2. アカウントを作成します
3. ダッシュボードから API トークンを取得します
4. FOCUS_NFE_TOKEN 環境変数を設定します

環境変数

変数	必須	説明
FOCUS_NFE_TOKEN	はい	Focus NFe の API トークン
FOCUS_NFE_SANDBOX	いいえ	検証モードを使用するには "true" に設定します

ロードマップ

v0.2（予定）

• create_cte — CT-e（電子輸送伝票）を作成します
• get_cte — ID から CT-e の詳細を取得します
• correction_letter — NF-e の訂正書を発行します
• manifest_recipient — NF-e の受取人確認を表明します
• get_nfse_pdf — サービス請求書（NFS-e）の PDF を取得します

v0.3（予定）

• batch_nfe — 1 回のリクエストで複数の NF-e を作成します
• batch_nfse — 1 回のリクエストで複数の NFS-e を作成します

貢献をご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

• Focus NFe のウェブサイト
• Focus NFe API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT