mcp-facturapi

MCP FacturAPI

FacturAPI 用 MCP サーバー — メキシコの CFDI 電子請求書プラットフォーム（ブラジルの NFe に相当します）。

クイックスタート

# Set your API key
export FACTURAPI_API_KEY="sk_..."

# Run via stdio
npx tsx packages/mexico/facturapi/src/index.ts

# Run via HTTP
npx tsx packages/mexico/facturapi/src/index.ts --http

環境変数

変数	必須	説明
FACTURAPI_API_KEY	はい	FacturAPI ダッシュボードから取得する API キー
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" を設定します
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（20）

ツール	用途
create_invoice	CFDI 請求書を作成します
get_invoice	ID で請求書を取得します
list_invoices	フィルターを指定して請求書を一覧表示します
cancel_invoice	請求書をキャンセルします
download_invoice_pdf	請求書を PDF でダウンロードします（ダウンロード URL を返します）
download_invoice_xml	請求書を XML でダウンロードします（ダウンロード URL を返します）
send_invoice_email	請求書（PDF + XML）を顧客または指定した宛先にメールで送信します
create_customer	請求用の顧客を作成します
get_customer	ID で顧客を取得します
list_customers	オプションのフィルターを指定して顧客を一覧表示します
update_customer	既存の顧客を更新します（一部更新）
delete_customer	顧客を削除します
create_product	請求用の商品を作成します
get_product	ID で商品を取得します
list_products	商品を一覧表示します
update_product	既存の商品を更新します（一部更新）
delete_product	商品を削除します
create_receipt	領収書（recibo de venta）を作成します。顧客は後で領収書の folio を使って、自分で請求書を発行できます
list_receipts	フィルターを指定して領収書を一覧表示します
list_webhooks	設定済みの webhook を一覧表示します

認証

Bearer トークン認証を使用します。API キーは FacturAPI ダッシュボード から取得してください。

API リファレンス

• FacturAPI ドキュメント

---

エンタープライズ

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

認証

サーバーを起動する前に、次の環境変数を設定してください。

• FACTURAPI_API_KEY (必須、シークレット) — FacturAPI の API キー

プロバイダーの開発者ポータルで認証情報を発行してください：https://docs.facturapi.io。

ライセンス

MIT