# FineProxy Agent Pack

バージョン：2026-09-22

このファイルは、既存のプロキシ連携をFineProxyへ移行できるか評価するために使用します。APIキー、アカウントデータ、非公開エンドポイントは含まれていません。

## 正式な情報源

- インタラクティブなクライアントAPIドキュメント：`https://fineproxy.org/account_new/docs`
- MCP設定：`https://fineproxy.org/account_new/mcp`
- 現在のクライアント向けOpenAPI仕様：顧客ダッシュボードのAPIドキュメントからダウンロードしてください。
- APIキーの作成と管理：`https://fineproxy.org/account_new/settings`
- MCPエンドポイント：`https://fineproxy.org/account_new/api/v1/mcp`

この概要からエンドポイントを推測で作らないでください。リクエストパス、スキーマ、パラメーター、レスポンスについては、現在のOpenAPI仕様を使用してください。

## プラットフォーム概要

- REST API：OpenAPI 3.1、文書化された顧客向けオペレーション49件。
- MCP：ステートレスなJSON-RPC 2.0とStreamable HTTPを介した49個のツール。
- 認証：顧客ダッシュボードで作成するBearer APIキー。
- APIとMCPは、同じスコープ指定された権限を使用します。
- パートナーAPIドキュメントは、アクティブなパートナーステータスを持つアカウントにのみ表示されます。

## 対応ワークフロー

### 購入とプロビジョニング

- 国とリアルタイムのIP在庫を一覧表示する。
- 購入せずに、正確な複数国パッケージを見積もる。
- 価格ガードと冪等性キーを使用し、ダッシュボードのウォレットから購入する。

標準的なMCP購入手順は次のとおりです：

1. `list_countries`
2. `quote_composite`
3. `order_composite`

### サービス管理

- サービスを確認、管理する。
- 対応している場合、更新、一時停止、復元、またはキャンセルする。
- 自動更新を有効または無効にする。
- IPアドレスを交換または追加する。
- サービスの認証情報を変更する。
- 許可リストの制限を確認、管理する。
- 対応するアドオンを一覧表示、購入、キャンセルする。

### 分析と診断

- 使用状況の概要と時系列データ。
- 主な接続先。
- エラーカテゴリー。
- 運用上の推奨事項。

### 請求とサポート

- 請求書を確認し、請求書PDFをダウンロードする。
- 決済ゲートウェイを一覧表示する。
- ウォレットへの入金を開始し、その状態を確認する。
- サポートチケットを作成、確認、返信、クローズする。

### プロキシアクセスとアカウント

- ローテーションプロキシの接続設定を読み取る。
- サービスのログイン名とパスワードを変更する。
- 許可リストでIPごとの接続数上限を管理する。
- プロフィール情報、呼び出し元IP、ログイン履歴を読み取る。
- Webhookを設定する。

## 権限スコープ

- `customer:read` — 顧客情報とアカウント情報を読み取る。
- `customer:write` — 顧客情報を更新する。
- `wallet:read` — ウォレット情報を読み取る。
- `wallet:deposit` — 入金を作成、監視する。
- `wallet:spend` — ウォレット資金を使用する。財務権限として扱うこと。
- `services:read` — サービスとプロキシ設定を読み取る。
- `services:write` — サービスとアドオンを作成または変更する。
- `tickets:read` — サポートチケットを読み取る。
- `tickets:write` — チケットを作成、返信、更新、またはクローズする。
- `catalog:read` — 製品、オプション、国、在庫を読み取る。
- `usage:read` — 使用状況と診断を読み取る。
- `webhooks` — Webhookサブスクリプションを管理する。

移行監査は読み取り専用権限で開始してください。書き込み権限または財務権限は、提案された変更を確認した後にのみ追加してください。

## 安全性に関する動作

- 財務ツールには`wallet:spend`が必要です。
- 購入には、見積もりで示された予想合計額を使用します。価格が一致しない場合、操作は拒否されます。
- 取り消せない操作には明示的な確認が必要です。
- 財務リクエストの再試行には冪等性キーを使用し、同じ操作に二重請求されないようにします。
- リアルタイムの在庫、プランの適格性、アカウント権限により、それ以外は有効な操作が実行できない場合があります。
- FineProxy MCPが操作するのは顧客アカウントです。ユーザーがコーディングエージェントにリポジトリへのアクセスを別途付与しない限り、ソースコードへアクセスすることはありません。

## MCP設定テンプレート

```json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}
```

実際のキーは環境変数またはシークレットマネージャーに保存してください。MCP設定と一緒にコミットしないでください。

## 移行互換性チェックリスト

既存の連携について、次の項目を調査してください：

1. プロバイダークライアントの初期化と、プロバイダー固有のすべてのインポート。
2. 認証ヘッダー、認証情報、環境変数、シークレット保存。
3. 購入、更新、キャンセル、IP交換のワークフロー。
4. 国の識別子と在庫に関する前提。
5. プロキシリストの形式、プロトコル、ポート、ユーザー名、パスワード、IP許可リスト。
6. ページネーションとフィルタリング。
7. 再試行の動作、タイムアウト処理、冪等性。
8. エラーモデルとレート制限の処理。
9. 使用状況分析と診断。
10. 請求、請求書、入金。
11. サポートチケット連携。
12. Webhookとイベントペイロードに関する前提。
13. 現在のプロバイダーに結び付いたテスト、フィクスチャ、モック、CIシークレット。

各ワークフローを次のように分類してください：

- 変更なしで互換性あり。
- 設定変更により互換性あり。
- アダプターまたはデータ変換が必要。
- 別の運用ワークフローが必要。
- 現在のドキュメントでは未対応、または確認できない。

## 必須の監査出力

監査には次の内容を含めてください：

1. 現在のプロバイダーへの依存関係の完全な一覧。
2. ワークフローごとの互換性評価。
3. 必要なFineProxyスコープ。
4. 変更対象となる正確なファイルとコードパス。
5. 認証とシークレット管理の変更。
6. 現在のOpenAPI仕様またはサポートによる確認が必要な未解決事項。
7. ロールバックを含む段階的な移行計画。
8. 切り替え前に必要な結合テスト。

最初の監査パスではコードを変更しないでください。