Factuarea

Factuarea MCP

バックオフィス全体を、MCP サーバーひとつで。
VeriFactu 対応の請求書発行、購入、カタログ、税務申告、勤怠管理、自動化を
スペインの事業者向けに、Claude、ChatGPT、Cursor、VS Code、あらゆる MCP クライアントのツールとして提供します。

英語 · スペイン語

650以上のツール · 41のドメイン · 9つの税務ガードレール · 5つのガイド付きワークフロー · ライブ環境とサンドボックス環境

Factuareaは、スペインの事業者やフリーランサー向けの請求書発行・管理プラットフォームです。これは、公式の Model Context Protocolサーバーです。Factuareaチームが本番環境で運用しているサービスそのものであり、その上に構築されたラッパーではありません。 FactuareaのダッシュボードやREST APIでできることなら何でも、エージェントが会話を通じて実行できます。VeriFactuの請求書発行から、今朝誰が出勤打刻したかの確認まで対応します。

接続

サーバーは https://mcp.factuarea.com で稼働しています。クライアントに追加し、Factuarea アカウントでサインインしてください。インストールもキーのコピーも不要です。同意画面で、会社、環境（ライブ または テスト）、付与する権限を選択します。

MCP アクセスは、トライアル期間中も含め、すべての Factuarea プランに含まれています。

claude mcp add --transport http factuarea https://mcp.factuarea.com \
  --header "Authorization: Bearer fact_test_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "factuarea": {
      "command": "npx",
      "args": ["-y", "@factuarea/mcp"],
      "env": { "FACTUAREA_API_KEY": "fact_test_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

「昨日の納品書をもとにTalleres Ruizへの請求書を作成して、メールで送ってください。」

「今四半期の請求書のうち、未払いのものはどれですか？それぞれの顧客に督促メールを送ってください。」

「見積書 2026-014 を請求書に変換して、支払期日を30日に変更してください。」

「この仕入先の請求書を登録し、銀行振込で支払い済みとしてマークしてください。」

「卸売価格表のすべての価格を5 %引き上げてください。」

「第3四半期の Modelo 303 ワークブックを準備してください。」

「WooCommerce の注文 #1042 から請求書が作成されなかったのはなぜですか？」

「今日、チームの中でまだ出勤打刻をしていないのは誰ですか？」

「プロジェクト DEV に明日までのタスクを作成して、Ana に割り当ててください。」

「Talleres Ruiz に送るすべての見積書に、ロゴ入りの新しいテンプレートを使ってください。」

対応範囲

ツールに加えて、サーバーは9つの税務ガイドをリソース （factuarea://guardrails/…：発行、取消と訂正の違い、請求書の種類、明細と金額、VAT 制度キー、シリーズ、購入者の識別、VeriFactu の前提条件、複数の会社）として公開し、 5つのガイド付きワークフローをプロンプトとして提供します：請求書の発行、失敗した請求書の修正、納税者番号による顧客登録、オンラインストアの接続、請求書が発行されていない注文の追跡です。

実際の金銭を扱うエージェント向けに設計

税務記録を損なうことはありません。 税務当局向けの請求書が存在すると、元に戻せないミスがあります。発行済みの請求書を取り消さずに削除する、下書きではなくなった請求書を編集する、訂正請求書を無効にする、といった操作です。サーバーは処理が実行される前にこうした呼び出しを拒否します。拒否内容（mcp_guardrail_violation）には、違反したルール（rule_id）と正しい手順を説明するガイド（guardrail_uri）が記載されるため、エージェントは自力で軌道修正できます。

再試行しても請求書が二重に作成されることはありません。 元に戻せない操作ではidempotency_keyを受け付けます。タイムアウト後にエージェントが呼び出しを繰り返した場合、重複書類ではなく、リプレイとしてマークされた元の結果が返されます。

許可された範囲だけを参照します。 各認証情報には、スコープで許可されたツールだけが表示され、すべての呼び出しがその都度再検証されます。OAuth 経由で接続されたサードパーティ製アプリには、厳選されたカタログが提供されます。VeriFactu への書き込み、GDPR に基づく消去、支払い、API キー、管理対象の会社といった、特に機密性の高い操作には、所有者自身の API キーが必要です。付与されていない会社のデータにアクセスできる認証情報はありません。

まずはコピーで試してください。 テスト用認証情報は、会社のプランを引き継ぐサンドボックス上の複製で動作します。AEAT への送信、顧客へのメール送信、Webhook の送信は行われず、FACe への提出はシミュレーションされます。

セキュリティとプライバシー

PKCE とローテーションされる更新トークンを使用する OAuth 2.1、表示は一度きりでハッシュ化して保存される API キー（有効期限と IP 許可リストは任意）、ダッシュボードから取り消し可能な接続済みアプリ。
プライバシーポリシー：factuarea.com/privacidad。
脆弱性については、SECURITY.mdに従って報告してください。

開発者向けの Factuarea 関連情報

• ドキュメント — REST API リファレンス、ガイド、エラーコード、llms.txt
• SDK — TypeScript と PHP
• CLI — ターミナルから API を操作
• Claude Code プラグイン — このサーバーと、インテグレーション構築用のスキル
• インテグレーション — n8n と WooCommerce

よくある質問

コントリビューション

このリポジトリには npm パッケージとレジストリマニフェストが含まれています。サーバー自体は Factuarea のプラットフォームで稼働しています。プロジェクトのセットアップ方法はCONTRIBUTING.mdを（コーディングエージェントを使用する場合はAGENTS.mdも）お読みください。また、参加する前に行動規範をご確認ください。変更内容は変更履歴に記載されています。

ライセンス

このリポジトリのコードはMITライセンスです。ホストされたサーバーと Factuarea の利用には、Factuarea の利用規約が適用されます。