# FineProxy Agent Pack

Sürüm: 2026-09-22

Mevcut bir proxy entegrasyonunun FineProxy'ye geçip geçemeyeceğini değerlendirmek için bu dosyayı kullanın. Dosya hiçbir API anahtarı, hesap verisi veya özel uç nokta içermez.

## Doğru bilgi kaynakları

- Etkileşimli istemci API dokümantasyonu: `https://fineproxy.org/account_new/docs`
- MCP kurulumu: `https://fineproxy.org/account_new/mcp`
- Güncel istemci OpenAPI spesifikasyonu: müşteri kontrol panelindeki API dokümantasyonundan indirin.
- API anahtarları oluşturma ve yönetme: `https://fineproxy.org/account_new/settings`
- MCP uç noktası: `https://fineproxy.org/account_new/api/v1/mcp`

Bu genel bakıştan yola çıkarak asla bir uç nokta uydurmayın. İstek yolları, şemalar, parametreler ve yanıtlar için güncel OpenAPI spesifikasyonunu kullanın.

## Platform özeti

- REST API: OpenAPI 3.1, belgelenmiş 49 müşteri işlemi.
- MCP: Durumsuz JSON-RPC 2.0 ve Streamable HTTP üzerinden 49 araç.
- Kimlik doğrulama: müşteri kontrol panelinde oluşturulan bearer API anahtarları.
- API ve MCP, kapsamı sınırlı aynı izinleri kullanır.
- İş ortağı API dokümantasyonu yalnızca etkin iş ortağı statüsüne sahip hesaplar tarafından görülebilir.

## Desteklenen iş akışları

### Satın alma ve sağlama

- Ülkeleri ve güncel IP envanterini listeleyin.
- Satın almadan çok ülkeli kesin bir paket için fiyat teklifi alın.
- Fiyat koruması ve idempotency anahtarıyla kontrol paneli cüzdanından satın alın.

Standart MCP satın alma sırası şöyledir:

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

### Hizmet yönetimi

- Hizmetleri okuyun ve yönetin.
- Desteklendiğinde yenileyin, askıya alın, geri yükleyin veya iptal edin.
- Otomatik yenilemeyi etkinleştirin veya devre dışı bırakın.
- IP adreslerini değiştirin veya ekleyin.
- Hizmet kimlik bilgilerini değiştirin.
- İzin verilen IP listesi limitlerini okuyun ve yönetin.
- Uyumlu eklentileri listeleyin, satın alın ve iptal edin.

### Analitik ve tanılama

- Kullanıma genel bakış ve zaman serileri.
- En sık erişilen hedefler.
- Hata kategorileri.
- Operasyonel öneriler.

### Faturalandırma ve destek

- Faturaları okuyun ve fatura PDF'lerini indirin.
- Ödeme ağ geçitlerini listeleyin.
- Cüzdan yatırma işlemi başlatın ve durumunu okuyun.
- Destek talepleri oluşturun, okuyun, yanıtlayın ve kapatın.

### Proxy erişimi ve hesap

- Dönen proxy bağlantı yapılandırmasını okuyun.
- Hizmet kullanıcı adını ve şifresini değiştirin.
- İzin verilen IP listesinde IP başına bağlantı limitlerini yönetin.
- Profil bilgilerini, çağıranın IP'sini ve giriş geçmişini okuyun.
- Webhook'ları yapılandırın.

## İzin kapsamları

- `customer:read` — müşteri ve hesap bilgilerini okuyun.
- `customer:write` — müşteri bilgilerini güncelleyin.
- `wallet:read` — cüzdan bilgilerini okuyun.
- `wallet:deposit` — yatırma işlemleri oluşturun ve izleyin.
- `wallet:spend` — cüzdan bakiyesini harcayın. Finansal bir izin olarak değerlendirin.
- `services:read` — hizmetleri ve proxy ayarlarını okuyun.
- `services:write` — hizmetleri ve eklentileri oluşturun veya değiştirin.
- `tickets:read` — destek taleplerini okuyun.
- `tickets:write` — destek talepleri oluşturun, yanıtlayın, güncelleyin veya kapatın.
- `catalog:read` — ürünleri, seçenekleri, ülkeleri ve stokları okuyun.
- `usage:read` — kullanım ve tanılama verilerini okuyun.
- `webhooks` — webhook aboneliklerini yönetin.

Geçiş denetimine salt okunur izinlerle başlayın. Yazma veya finansal izinleri yalnızca önerilen değişiklikler incelendikten sonra ekleyin.

## Güvenlik davranışı

- Finansal araçlar `wallet:spend` gerektirir.
- Satın alma işlemleri teklif edilen beklenen toplamı taşır. Fiyat uyuşmazlığı işlemin reddedilmesine neden olur.
- Geri alınamaz işlemler açık onay gerektirir.
- Finansal işlemler yeniden denendiğinde, aynı işlem için iki kez ücret alınmaması amacıyla bir idempotency anahtarı kullanılır.
- Güncel envanter, plan uygunluğu ve hesap izinleri, aksi durumda geçerli olan bir işlemi engelleyebilir.
- FineProxy MCP müşteri hesabını yönetir. Kullanıcı kodlama ajanına ayrıca bir depoya erişim vermediği sürece kaynak koduna erişemez.

## MCP yapılandırma şablonu

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

Gerçek anahtarı bir ortam değişkeninde veya secret yöneticisinde saklayın. MCP yapılandırmasıyla birlikte commit etmeyin.

## Geçiş uyumluluğu kontrol listesi

Mevcut entegrasyonda şunları inceleyin:

1. Sağlayıcı istemcisinin başlatılması ve sağlayıcıya özgü tüm import'lar.
2. Kimlik doğrulama başlıkları, kimlik bilgileri, ortam değişkenleri ve secret saklama.
3. Satın alma, yenileme, iptal ve IP değiştirme iş akışları.
4. Ülke tanımlayıcıları ve envanter varsayımları.
5. Proxy listesi biçimleri, protokoller, bağlantı noktaları, kullanıcı adları, şifreler ve izin verilen IP listeleri.
6. Sayfalama ve filtreleme.
7. Yeniden deneme davranışı, zaman aşımı yönetimi ve idempotency.
8. Hata modelleri ve hız limiti yönetimi.
9. Kullanım analitiği ve tanılama.
10. Faturalandırma, faturalar ve yatırma işlemleri.
11. Destek talebi entegrasyonu.
12. Webhook'lar ve olay yükü varsayımları.
13. Mevcut sağlayıcıya bağlı testler, fixture'lar, mock'lar ve CI secret'ları.

Her iş akışını şu şekilde sınıflandırın:

- Değişiklik olmadan uyumlu.
- Yapılandırma değişikliğiyle uyumlu.
- Adaptör veya veri dönüşümü gerektiriyor.
- Farklı bir operasyonel iş akışı gerektiriyor.
- Desteklenmiyor veya güncel dokümantasyon tarafından doğrulanmamış.

## Gerekli denetim çıktısı

Denetim şunları içermelidir:

1. Mevcut sağlayıcıya yönelik tüm bağımlılıkların envanteri.
2. Her iş akışı için uyumluluk değerlendirmesi.
3. Gerekli FineProxy kapsamları.
4. Değişecek dosyalar ve kod yolları.
5. Kimlik doğrulama ve secret yönetimi değişiklikleri.
6. Güncel OpenAPI spesifikasyonu veya destek onayı gerektiren açık sorular.
7. Geri alma seçeneği içeren aşamalı geçiş planı.
8. Geçişten önce gereken entegrasyon testleri.

İlk denetim incelemesinde kodu değiştirmeyin.