Fixpayment

FixPayment MCP サーバー

FastMCP サーバーは、FixPayment ポータル向けに債権者向け API を提供します。
MCP 対応の AI アシスタント（Claude など）を FixPayment アカウントに接続すると、アカウントの作成、ステータスの更新、レポートの実行をすべて平易な英語で行えます。

• MCP サーバー URL：http://fixpayment.org:8000
• ドキュメント：https://fixpayment.org/mcp/fixpayment-mcp.html
• サポート：[email protected]

---

クイックスタート

# 1. Clone & install dependencies
pip install -r requirements.txt

# 2. Configure credentials
cp .env.example .env
# Edit .env and set FIXPAYMENT_DB_* variables

# 3. Run the server
python -m mcp.server
# or via FastMCP CLI:
fastmcp run mcp/server.py:mcp

---

環境変数

変数	説明	デフォルト
FIXPAYMENT_DB_HOST	PostgreSQL ホスト	localhost
FIXPAYMENT_DB_PORT	PostgreSQL ポート	54432
FIXPAYMENT_DB_NAME	データベース名	fixpayment_db
FIXPAYMENT_DB_USER	データベースユーザー	fixpayment_user
FIXPAYMENT_DB_PASS	データベースパスワード	(必須)
FIXPAYMENT_UPLOAD_PATH	アップロードのルートディレクトリ	/var/www/fixpayment/uploads/

---

認証モデル

すべての MCP ツールで api_key 引数が必要です。
このキーは、mcp_api_keys テーブル内の creditor_id と plan（basic、reports、または full）に対応します。

---

プランとツール

ツール	basic	reports	full
ping	✓	✓	✓
get_plan_info	✓	✓	✓
get_account_summary	✓	✓	✓
list_accounts_basic	✓	✓	✓
validate_account_payload	✓	✓	✓
accounts_report		✓	✓
payments_report		✓	✓
settlements_report		✓	✓
performance_report		✓	✓
create_account			✓
bulk_create_accounts			✓
update_account_status			✓
add_account_document			✓

---

プロジェクト構成

fixpayments/
├── mcp/
│   ├── __init__.py
│   ├── server.py          # FastMCP instance + entrypoint
│   ├── db.py              # DB connection helper
│   ├── auth.py            # API key validation
│   └── tools/
│       ├── __init__.py
│       ├── basic.py       # Basic plan tools (5 tools)
│       ├── reports.py     # Reports plan tools (4 tools)
│       └── accounts.py    # Full plan tools (4 tools)
├── docs/
│   └── fixpayment-mcp.html
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md

---

データベーススキーマ（必須テーブル）

• mcp_api_keys — api_key、creditor_id、plan、active、expires_at
• fixpayment_accounts — アカウントテーブル
• fixpayment_payments — 支払いテーブル
• fixpayment_settlements — 和解テーブル
• fixpayment_account_documents — ドキュメント添付ファイル

API キーの発行やプランのアップグレードについては、[email protected] までメールでお問い合わせください。