Kelnix Receipt Mcp Api

🧾 Kelnix Receipt MCP API

1 回の API 呼び出しで、あらゆるレシートを会計処理にすぐ使える構造化 JSON に変換します。AI ビジョンが販売店、日付、明細、税額、合計金額などをすべて抽出し、すぐに記帳できるよう総勘定元帳（GL）勘定科目を提案します。

経費管理、買掛金管理、記帳を自動化する AI エージェント向けに構築されています。ダッシュボードもログインも不要です。MCP で通信する API を利用できます。

🎁 登録時に 50 クレジットを無料で付与。クレジットカードは不要です。

🌐 稼働中： receipt-mcp-api.kelnix.org — インタラクティブドキュメント

📧 お問い合わせ： [email protected] | 🔗 kelnix.org

---

⚡ クイックスタート

1️⃣ 登録（即時、承認不要）

curl -X POST https://receipt-mcp-api.kelnix.org/register_agent \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-expense-bot"}'

✅ API キーと 50 クレジットが返されます。

2️⃣ レシートを処理する（1 クレジット）

curl -X POST https://receipt-mcp-api.kelnix.org/tools/upload_and_process \
  -H "X-API-Key: rct_your-key-here" \
  -F "[email protected]" \
  -F "mime_type=image/jpeg"

✅ 販売店、日付、明細、合計金額、税額、通貨、信頼度スコアを含む構造化 JSON が返されます。

3️⃣ 必要に応じてクレジットを追加購入する

# 💳 With card (Stripe)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000}'

# 🪙 With crypto (300+ coins)
curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "eth"}'

---

💰 料金

クレジットパック

クレジット数	価格	1 クレジットあたり
100	$5	$0.050
500	$20	$0.040
1,000	$40	$0.040
5,000	$150	$0.030
10,000	$300	$0.030

📅 サブスクリプション

プラン	クレジット数/月	価格
🆓 無料	50（登録時）	$0
⭐ Basic	200/月	$15/月
🚀 Pro	2,000/月	$99/月

🔧 ツールの利用料金

ツール	料金
receipts.process	1 クレジット
receipts.upload_and_process	1 クレジット
accounting.suggest_gl_account	1 クレジット
receipts.upload	🆓 無料
receipts.get_markdown	🆓 無料
credits.check_balance	🆓 無料
receipts.list	🆓 無料

料金の詳細は GET /pricing でも確認できます（認証不要）。

---

📖 API リファレンス

🔧 ツール

メソッド	エンドポイント	料金	説明
POST	/tools/upload_receipt	無料	レシートの画像/PDF をアップロード
POST	/tools/process_receipt	1 クレジット	構造化データを抽出
POST	/tools/upload_and_process	1 クレジット	1 回の呼び出しでアップロードと処理を実行（冪等）
POST	/tools/get_receipt_markdown	無料	処理済みレシートを Markdown 形式で取得
POST	/tools/suggest_gl_account	1 クレジット	AI が GL 勘定科目コードを提案
POST	/tools/check_balance	無料	クレジット残高とプランを確認
POST	/tools/list_receipts	無料	フィルターを指定してレシートを一覧表示
POST	/tools/process_receipt_async	1 クレジット	非同期処理をキューに追加（Redis が必要）

💳 請求

メソッド	エンドポイント	説明
POST	/billing/buy_credits	クレジットパックを購入（Stripe Checkout）
POST	/billing/subscribe	月額プランに登録
POST	/billing/buy_credits_crypto	300 種類以上の暗号資産でクレジットを購入
POST	/billing/check_payment_status	暗号資産による支払い状況を確認
GET	/billing/balance	取引履歴を含む詳細な残高を取得

📡 検出と情報

メソッド	エンドポイント	説明
GET	/mcp	スキーマ、使用例、制約を含むツールカタログ
GET	/.well-known/mcp.json	MCP サーバーの検出メタデータ
GET	/pricing	公開料金（認証不要）
GET	/legal/terms	利用規約
GET	/legal/privacy	プライバシーポリシー
GET	/integrations	LangGraph、CrewAI、AutoGen 向けコードスニペット
GET	/docs	インタラクティブな Swagger ドキュメント
GET	/health	ヘルスチェック

🔐 認証

すべてのツールおよび請求エンドポイントには、X-API-Key ヘッダーが必要です。POST /register_agent からキーを取得してください。

クレジットがなくなると、有料エンドポイントは追加購入用のリンクとともに 402 を返します。

{
  "error": "Insufficient credits: 0 available, 1 required.",
  "buy_credits_url": "/billing/buy_credits",
  "buy_credits_crypto_url": "/billing/buy_credits_crypto",
  "pricing_url": "/pricing",
  "cheapest_option": "100 credits for $5.00"
}

---

🔌 MCP プロトコル

Claude Desktop、Cursor、および MCP 互換クライアントで動作します。

{
  "mcpServers": {
    "kelnix-receipt": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
    }
  }
}

/.well-known/mcp.json からも検出でき、Smithery.ai に掲載されています。

---

🧩 フレームワークとの連携

GET /integrations では、すぐに使えるコードを以下のフレームワーク向けに提供しています。

フレームワーク	連携方法
🦜 LangGraph	ツールノードとの連携
🚢 CrewAI	BaseTool のサブクラス
🤖 AutoGen	登録済み関数
🐍 Raw Python	httpx を使用した完全なフロー

実装の詳細については、examples/ ディレクトリをご覧ください。

---

🪙 暗号資産での支払い

BTC、ETH、SOL、USDC、USDT、DOGE など、280 種類以上のコインで支払えます。クレジットの価格は USD 建てで、暗号資産の金額は現在のレートで約 20 分間固定されます。

curl -X POST https://receipt-mcp-api.kelnix.org/billing/buy_credits_crypto \
  -H "X-API-Key: rct_your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000, "preferred_coin": "btc"}'

支払いアドレスと正確な金額が返されます。確認されると、クレジットが自動的に付与されます。

---

🛠️ セルフホスティング

git clone https://github.com/kelnixsolutions/Kelnix-Receipt-MCP-API.git
cd Receipt-Accounting-Entry-MCP-Server
pip install -r requirements.txt
export ANTHROPIC_API_KEY=sk-ant-...
uvicorn app:app --host 0.0.0.0 --port 8000

Python 3.11 以降が必要です。nginx、SSL、systemd を使った本番環境へのデプロイについては、deploy/setup.sh をご覧ください。

変数	必須	説明
ANTHROPIC_API_KEY	✅ はい	Claude の画像認識用 Anthropic API キー
STRIPE_SECRET_KEY	❌ いいえ	請求処理用 Stripe シークレットキー
STRIPE_WEBHOOK_SECRET	❌ いいえ	Stripe ウェブフック署名用シークレット
NOWPAYMENTS_API_KEY	❌ いいえ	暗号資産決済用 NOWPayments API キー
REDIS_URL	❌ いいえ	非同期処理用 Redis URL

---

📜 ライセンス

MIT

---

❤️ を込めて Kelnix が開発
_{次世代の AI 経費管理エージェントを支えます}