Fakto.app - wFirma MCP Server

Fakto.app — wFirma と Fakturownia 用 MCP サーバー

ポーランド語版 / Polish version → README.pl.md

Fakto.app は、AI アシスタント（Claude、ChatGPT、n8n、Make、およびその他のあらゆる MCP クライアント）を、ポーランドで最も人気のある 2 つの会計プラットフォームに接続する、ホスト型の Model Context Protocol（MCP）サーバーです。

• wFirma.pl — 45 個の MCP ツール
• Fakturownia.pl — 37 個の MCP ツール

AI アシスタントに自然な言葉で指示するだけで、請求書の発行、取引先の検索、財務分析、在庫の確認、キャッシュフローの予測ができます。

このリポジトリには、fakto.app のホスト型サービス向けのドキュメント、例、プロンプトが含まれています。サーバー自体は管理されたクローズドソースのサービスであり、ご自身で何かを実行する必要はありません。

エンドポイント

システム	エンドポイント	トランスポート
wFirma	https://fakto.app/wfirma/stream	HTTP Streamable（JSON-RPC）
Fakturownia	https://fakto.app/fakturownia/stream	HTTP Streamable（JSON-RPC）

どちらも Dynamic Client Registration（RFC 7591）を使用した OAuth 2.0 に対応しているため、Claude と ChatGPT はクライアントを手動で設定せずに接続できます。

クイックスタート

1. アカウントを作成する

fakto.app で登録します。無料プラン（クレジットカード不要）もあります。ダッシュボードで、ご自身の wFirma または Fakturownia の API キーを接続してください。

2. クライアントを接続する

Claude（デスクトップまたは claude.ai）

1. Settings → Connectors → Add custom connector
2. URL：https://fakto.app/wfirma/stream（または /fakturownia/stream）
3. Connect をクリックします。OAuth の手続きに進み、API キーを一度入力するよう求められます。

ChatGPT

1. Settings → Connectors → MCP サーバーを追加
2. サーバー URL：https://fakto.app/wfirma/stream
3. Discovery URL：https://fakto.app/.well-known/openid-configuration
4. Client ID/Secret は空欄のままにします。ChatGPT が自動的に登録します（RFC 7591）。

n8n / Make / カスタム自動化

fakto.app のダッシュボードで生成した Bearer トークンを使用するか、ヘッダーに認証情報を渡します。

POST https://fakto.app/wfirma/stream
Authorization: Bearer <token from dashboard>
Content-Type: application/json

すぐに使える n8n ワークフローは examples/n8n/ にあります。JSON をインポートして環境変数を設定すれば完了です。手順を追ったガイド（ポーランド語）：

• Claude クイックスタート
• ChatGPT クイックスタート
• n8n クイックスタート
• Make クイックスタート

3. 試してみる

「最新の請求書を 3 件表示して」 · 「ACME Sp. z o.o. 宛てに、コンサルティングサービス、税抜 5000 PLN の請求書を作成して」 · 「支払期限を過ぎた請求書はどれ？」 · 「先月の売上をまとめて」

ツール

請求書、取引先、経費、倉庫、支払い、税務台帳/KPiR、財務分析、予測、自動化など、82 個のツールすべての自動生成リストは TOOLS.md にあります。

AI 会計プロンプト

prompts/asystent-ksiegowy-pl.md には、実績のあるポーランド語の AI 会計エージェント向けシステムプロンプト（n8n AI Agent、Claude Projects、カスタム GPT 向け）が含まれています。ポーランドの VAT 税率、納税期限、応答形式、安全規則も網羅しています。

セキュリティ

• 認証情報は AES-256-GCM で保存時に暗号化され、ログに記録されることはありません。
• すべての通信に TLS を使用します。サーバーは EU 内でホストされ、GDPR に準拠しています。
• 接続するのはご自身の wFirma/Fakturownia API キーです。データは AI クライアント、Fakto.app、会計システムの間を直接流れます。

料金

無料プラン（読み取り専用、月 100 リクエスト）に加え、請求書の作成、倉庫、分析、予測に対応した有料プランがあります：fakto.app/mcp/pricing。

サポート

• ガイド（PL）：fakto.app/mcp/poradniki
• FAQ：fakto.app/mcp/faq
• メール：[email protected]

ライセンス

このリポジトリの内容（ドキュメント、ワークフローの例、プロンプト）は、MIT Licenseの下で公開されています。Fakto.app サービス自体はプロプライエタリです。