Debitura

Debitura MCP サーバー

国際債権回収のための MCP サーバーです。 Claude、Cursor、VS Code、または MCP 互換のエージェントをDebituraに接続して、AI アシスタントから国際債権回収を管理できます。案件の状況確認、パートナーとのやり取りの閲覧、料金の確認、新しい回収案件の申請が可能です。183 か国の審査済み現地回収パートナーが、回収できた場合のみ料金が発生する方式で対応します。

• エンドポイント： https://mcp.debitura.com/mcp（ストリーミング可能な HTTP）
• 認証： XApiKey ヘッダーに Debitura API キーを指定します（または Authorization: Bearer <key>）
• キーの取得： app.debitura.comにログイン → API key page
• コネクタページ： debitura.com/integration/mcp-server

ツール

読み取り

ツール	機能
ping	接続をテストします — 「✓ {your company} として接続済み」
list_cases	回収案件の一覧を取得します（ページング、ステータスによる絞り込み、並べ替え）
get_case	ID、自社参照番号、または Debitura 案件参照番号を指定して案件を取得します
get_case_activity	案件のタイムライン — これまでの経過を確認します（{ items, currentEngagementPhase }を返します）
get_case_messages	回収パートナーとのチャットを閲覧します
get_case_payments	案件で回収された金額を取得します
get_case_contract_status	署名済み、または案件を妨げている契約を確認します
get_case_tasks	1 件の案件に関する未完了タスク（対応項目）を取得します
list_case_files	案件に添付された書類と、期間限定のダウンロード URL の一覧を取得します
get_account_summary	ライフサイクル段階ごとの案件数を表示します — ポートフォリオの概要をすばやく確認できます
list_tasks	アカウント全体の未完了タスク（対応項目）と、solutionUrl および解決アクションをすべて取得します
preview_case	申請前に料金と適格性を試算します（データは保存されません）
list_team_members	チームメンバーを取得します — メッセージの送信者の指定や案件担当者の割り当てに使用します

書き込み

ツール	説明
create_case	債権回収案件を登録します。まずプレビューを表示してユーザーから明示的な確認を得るようアシスタントに指示し、その後、冪等性を保って登録します（Idempotency-Key を自動設定し、安全に再試行でき、案件の重複登録はありません）
upload_case_file	案件に書類を添付します（請求書のコピー、契約書など。最大 25 MB）
send_case_message	案件について債権回収パートナーにメッセージを送り、氏名付きのチームメンバーの名義で送信します

各ツールには MCP アノテーション（readOnlyHint / destructiveHint）が付いており、書き込みツールには破壊的な操作としてマークされています。create_case は法務・財務上の操作です。このツールの説明では、登録前に preview_case を実行し、ユーザーから明示的な確認を得るようアシスタントに指示しています。ツールの実行前に MCP クライアントも確認を求めるかどうかは、クライアントとその設定によって異なります。

配布

Debitura はこの MCP サーバーを、https://mcp.debitura.com/mcp のホステッドサービスとして運用しています。サポートされている利用方法はこれのみです。任意の MCP クライアントをエンドポイントに接続し、Debitura API キーで認証してください（下記のインストールを参照）。公開 npm パッケージはありません。@debitura/mcp-server パッケージは非公開（"private": true）で、npm レジストリでは配布されていません。ソースコードは監査できるよう公開されており、必要であれば独自のコピーを実行できます（セルフホスト／開発を参照）。ただし、通常の利用ではホステッドエンドポイントを使用します。

インストール

Claude（ウェブ／デスクトップ）

Settings → Connectors → カスタムコネクターを追加 → URL https://mcp.debitura.com/mcp。

Anthropic は、OAuth を使わずに認証できる Request headers オプションを同じダイアログで段階的に提供しています。ただし、これは利用が制限されたベータ版です（Anthropic：「早期アクセスについてはお問い合わせください」）。そのため、ほとんどのアカウントではまだ表示されません。表示される場合は、x-api-key ヘッダーを追加し、値に Debitura API キーを設定してください。表示されない場合は、代わりに下記の Claude Code または Claude Desktop の設定ファイルを使う方法を使用してください。どちらもベータ版へのアクセス権にかかわらず、現在利用できます。

Claude Code

claude mcp add --transport http debitura https://mcp.debitura.com/mcp --header "XApiKey: YOUR_API_KEY"

Claude Desktop（Request headers のベータ版を利用できない場合）

Claude Desktop の Connectors UI を使わず、claude_desktop_config.json を直接編集します。これはウェブと同期される Connectors UI とは別の仕組みで、OAuth は不要です。mcp-remote ブリッジを使用します。

{
  "mcpServers": {
    "debitura": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.debitura.com/mcp", "--header", "XApiKey:${DEBITURA_KEY}"],
      "env": { "DEBITURA_KEY": "YOUR_API_KEY" }
    }
  }
}

ファイルの場所：macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json です。保存後、Claude Desktop を再起動してください。カスタムコネクターの追加操作をしていなくても、サーバーは Settings → Connectors → Manage connectors に表示されます。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "debitura": {
      "url": "https://mcp.debitura.com/mcp",
      "headers": { "XApiKey": "YOUR_API_KEY" }
    }
  }
}

VS Code（GitHub Copilot）

code --add-mcp '{"name":"debitura","type":"http","url":"https://mcp.debitura.com/mcp","headers":{"XApiKey":"YOUR_API_KEY"}}'

確認

アシスタントに 「Debitura に ping して」 と尋ねます → ✓ Connected as {your company} と表示されます。

プロンプトの例

• 「Debitura の案件の状況はどうなっていますか？対応が必要なものはありますか？」
• 「ドイツで €12,000 の B2B 債権を回収する場合、費用はいくらですか？」
• 「今週、債権回収パートナーから新しいメッセージは届いていますか？」
• 「Acme GmbH に対する債権回収案件をベルリンで登録してください。請求書番号は 2026-014、金額は €8,400、支払期日は 3 月 1 日です。」

セキュリティ

• 認証とテナント分離。 XApiKey ヘッダーがテナント境界です。サーバーは ステートレスです。各リクエストで、呼び出し元の API キーに紐付いた新しい MCP サーバーが作成され、そのキーは Debitura Customer API にそのまま渡されます。キーや案件データは保存されません。
• トランスポート。 ホストされたエンドポイントは Cloudflare 経由の HTTPS で提供されます。
• レート制限。 ツール呼び出しは Debitura Customer API に転送されるため、Customer API の レート制限が API キーに適用されます。 ツールによっては、1 回の呼び出しで Customer API を複数回呼び出します（例：get_account_summary はライフサイクル段階ごとに 1 回、件数を照会します）。その都度、呼び出しとしてカウントされます。
• 脆弱性の報告： SECURITY.md をご覧ください。

セルフホスト／開発

Debitura の MCP を利用する場合、サポートされている方法は上記のホストされたエンドポイントです。以下の手順は、 このリポジトリのローカル開発／監査のみを対象としています。

npm install
npm run dev          # starts on :3000, POST /mcp

環境変数	デフォルト	用途
PORT	3000	リッスンポート
DEBITURA_API_BASE_URL	https://customer-api.debitura.com	テスト環境を使う場合は https://testcustomer-api.debitura.com を指定します

初期設定用の環境変数ファイルについては .env.example をご覧ください。

npm run build && npm start        # production-style local run
docker build -t debitura-mcp . && docker run -p 3000:3000 debitura-mcp

デプロイに関する注意： ホストサービスでは、ビルド済みアプリを zip 形式で Azure App Service に デプロイします（.github/workflows/deploy.yml を参照）。本番環境で Docker イメージは実行しません。 Dockerfile はローカル／セルフホスト環境での利用向けに用意されています。

E2E テスト

テスト環境に対してすべてのツールを実行します（isTest タグ付きの案件のみを作成し、削除します）。

DEBITURA_API_BASE_URL=https://testcustomer-api.debitura.com npm run dev   # terminal 1
DEBITURA_TEST_API_KEY=<test key> MCP_URL=http://localhost:3000/mcp npx tsx scripts/e2e.ts

API 型の再生成

型と HTTP クライアントは、Customer API の OpenAPI 仕様（openapi/customer-api.json）から openapi-typescript を使って生成されます。その上にある厳選された 16 個のツールのレイヤーは 手書きです。

npm run fetch:spec   # pull latest spec + regenerate src/generated/customer-api.d.ts

新しいバージョンのリリース

バージョンは package.json に記載されています（config.ts と client.ts はそこから値を取得します）。バージョンを更新する際は、 server.json も更新してください。そちらの version フィールドは独立しており、公開されているレジストリの掲載内容と一致させる必要があります。（smithery.yaml にはバージョンフィールドがなく、Smithery がパッケージのバージョンを自動的に取得します。）

ツールを追加または削除する場合は、上記のツールカタログと scripts/e2e.ts の tools/list アサーションも更新してください（登録済みツールの正確なセットを検証します）。

Debitura について

Debitura は、183 か国を対象とするグローバルな債権回収プラットフォームです。債権者が期限を過ぎた B2B および B2C の債権を申し立てると、債務者の管轄区域で審査を受けた現地の回収パートナーが回収します。 通常、回収できなかった場合は費用が発生しません。詳しくは debitura.com をご覧ください。API ドキュメントは docs.debitura.com にあります。