# 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 및 로그인 내역을 조회합니다.
- 웹후크를 구성합니다.

## 권한 범위

- `customer:read` — 고객 및 계정 정보를 조회합니다.
- `customer:write` — 고객 정보를 업데이트합니다.
- `wallet:read` — 지갑 정보를 조회합니다.
- `wallet:deposit` — 입금을 생성하고 모니터링합니다.
- `wallet:spend` — 지갑 잔액을 사용합니다. 금융 권한으로 취급하세요.
- `services:read` — 서비스 및 프록시 설정을 조회합니다.
- `services:write` — 서비스 및 추가 기능을 생성하거나 변경합니다.
- `tickets:read` — 지원 티켓을 조회합니다.
- `tickets:write` — 티켓을 생성하고 답변, 업데이트 또는 종료합니다.
- `catalog:read` — 제품, 옵션, 국가 및 재고를 조회합니다.
- `usage:read` — 사용량 및 진단을 조회합니다.
- `webhooks` — 웹후크 구독을 관리합니다.

마이그레이션 감사는 읽기 전용 권한으로 시작하세요. 제안된 변경 사항을 검토한 후에만 쓰기 또는 금융 권한을 추가하세요.

## 안전 동작

- 금융 도구에는 `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. 공급업체 클라이언트 초기화 및 모든 공급업체별 import.
2. 인증 헤더, 자격 증명, 환경 변수 및 보안 비밀 저장소.
3. 구매, 갱신, 취소 및 IP 교체 워크플로.
4. 국가 식별자 및 재고 가정.
5. 프록시 목록 형식, 프로토콜, 포트, 사용자 이름, 비밀번호 및 IP 허용 목록.
6. 페이지네이션 및 필터링.
7. 재시도 동작, 시간 초과 처리 및 멱등성.
8. 오류 모델 및 속도 제한 처리.
9. 사용량 분석 및 진단.
10. 결제, 인보이스 및 입금.
11. 지원 티켓 통합.
12. 웹후크 및 이벤트 페이로드에 대한 가정.
13. 현재 공급업체에 연결된 테스트, 픽스처, 모의 객체 및 CI 보안 비밀.

각 워크플로를 다음과 같이 분류하세요:

- 변경 없이 호환됨.
- 구성 변경을 통해 호환됨.
- 어댑터 또는 데이터 변환이 필요함.
- 다른 운영 워크플로가 필요함.
- 현재 문서에서 지원되지 않거나 확인되지 않음.

## 필수 감사 결과물

감사에는 다음 항목이 포함되어야 합니다:

1. 현재 공급업체에 대한 모든 종속성 목록.
2. 워크플로별 호환성 평가.
3. 필요한 FineProxy 권한 범위.
4. 변경해야 할 정확한 파일 및 코드 경로.
5. 인증 및 보안 비밀 관리 변경 사항.
6. 현재 OpenAPI 사양 또는 지원팀의 확인이 필요한 미해결 질문.
7. 롤백을 포함한 단계별 마이그레이션 계획.
8. 전환 전에 필요한 통합 테스트.

첫 번째 감사 검토에서는 코드를 수정하지 마세요.