Sorun Giderme

Connfig MCP bağlantı ve araç hatalarının belirtileri, sebepleri ve çözümleri

Hatalar iki katmanda ortaya çıkar: HTTP katmanı (bağlantı hiç kurulamaz — 401, 403, 429) ve araç katmanı (bağlantı çalışır ama tek bir araç çağrısı hata döner).

401 — Kimlik doğrulama hataları

Belirti: `Missing or malformed Authorization header`

Sebep: İstekte Authorization başlığı yok veya Bearer TOKEN biçiminde değil.
Çözüm: İstemci yapılandırmanızda başlığın tam olarak Authorization: Bearer cnfg_... biçiminde olduğunu doğrulayın. Kurulum blokları için: /docs/tr/mcp/setup

Belirti: `Invalid API key`

Sebep: Anahtar sistemde bulunamadı — yanlış kopyalanmış, eksik karakter içeriyor ya da hiç üretilmemiş olabilir.
Çözüm: Anahtarı Profil → API Anahtarları'ndan yeniden üretin ve tamamını (baştaki cnfg_ dahil) kopyaladığınızdan emin olun.

Belirti: `API key has been revoked`

Sebep: Anahtar iptal edilmiş.
Çözüm: Profil → API Anahtarları'ndan yeni bir anahtar üretin ve istemci yapılandırmanızı güncelleyin.

Belirti: `API key has expired`

Sebep: Anahtarın son kullanma tarihi geçmiş.
Çözüm: Yeni bir anahtar üretin; ihtiyaç halinde süresiz anahtar seçin.

Claude.ai gibi OAuth destekleyen istemciler 401 yanıtındaki WWW-Authenticate başlığı üzerinden yetkilendirme sunucusunu otomatik keşfeder ve sizi Connfig giriş ekranına yönlendirir. Claude.ai kullanıyorsanız 401'lerin çoğu "bağlayıcıyı yeniden yetkilendir" ile çözülür.

403 — Abonelik engelleri

Belirti: `API access requires an active subscription`

Sebep: Aboneliğiniz engelleyen bir durumda (iptal edilmiş, pasif veya devre dışı).
Çözüm: Uygulamadaki abonelik durumunuzu kontrol edin; gerekirse fiyatlandırma sayfasından aboneliğinizi yenileyin.

Belirti: `Subscription has expired`

Sebep: Abonelik dönemi bitmiş ve yenileme gerçekleşmemiş.
Çözüm: Ödeme yönteminizi kontrol edip aboneliği yenileyin. Yenileme sonrası anahtarınız değişmeden çalışmaya devam eder.

Belirti: `No Connfig account exists for this user` (yalnızca OAuth)

Sebep: OAuth ile oturum açan kullanıcıya bağlı bir Connfig hesabı bulunamadı.
Çözüm: claude.ai bağlayıcısında, Connfig'e kayıt olurken kullandığınız hesapla oturum açtığınızdan emin olun.

429 — Rate limit

Belirti: `Rate limit exceeded. Try again in a minute.`

Sebep: Anahtar başına dakikada 120 istek sınırı aşıldı.
Çözüm: Bir dakika bekleyip devam edin. Asistanın gereksiz döngüye girip aynı aracı tekrar tekrar çağırmadığını kontrol edin.

Belirti: `RATE_LIMITED: Too many start_scrape calls. Try again in a minute.`

Sebep: Ağır araçlar (start_scrape, create_and_send_campaign, send_test_mail) araç başına dakikada 10 çağrıyla sınırlıdır. Test maili için ek kurallar: günde 20 adet ve gönderimler arası 60 saniye bekleme.
Çözüm: Hata mesajında belirtilen süre kadar bekleyin.

Araç katmanı hataları

Bu hatalar HTTP 200 ile döner ama araç sonucu KOD: mesaj biçiminde bir hata içerir.

Kod	Örnek mesaj	Sebep ve çözüm
`QUOTA_EXCEEDED`	`Monthly lead quota reached (25/25).`	Aylık kazıma kotanız doldu — dönem sıfırlanmasını bekleyin veya planı yükseltin.
`QUOTA_EXCEEDED`	`Monthly mail limit reached (500/500 in the last 30 days).`	Son 30 günün mail limiti doldu. Limit `0` ise mesaj kampanya gönderiminin planda olmadığını söyler — planı yükseltin.
`QUOTA_EXCEEDED`	`CRM record limit reached (25/25). Upgrade the plan or remove manual records.`	Manuel CRM kayıt limiti doldu.
`QUOTA_EXCEEDED`	`Seat limit reached (1/1). Upgrade the plan to invite more members.`	Koltuk limiti doldu — üye davet etmek için plan yükseltin.
`QUOTA_EXCEEDED`	`Workspace limit reached (1/1). Upgrade the plan or remove a workspace.`	Workspace limiti doldu.
`SCRAPE_IN_PROGRESS`	`A lead-generation job is already running for this account.`	Aynı anda tek kazıma çalışır — `get_scrape_status` veya `list_scrape_jobs` ile bitmesini bekleyin.
`FORBIDDEN`	`Leads enrichment is only available on Pro and Team plans`	Zenginleştirme Pro/Team özelliğidir.
`FORBIDDEN`	`You do not have access to this workspace`	Workspace size ait değil veya üyeliğiniz yok — `list_workspaces` ile erişebildiklerinizi görün.
`FORBIDDEN`	`Only the workspace owner can manage members`	İşlem sahiplik ya da ek izin (örn. `can_manage_tasks`) gerektiriyor.
`NOT_FOUND`	—	Verilen ID'li kayıt yok; asistan yanlış ID kullanmış olabilir, önce listeleme aracıyla doğrulatın.
`INVALID_INPUT`	—	Araç parametreleri şemaya uymuyor; komutu daha net kurarak tekrar deneyin.
`INTERNAL_ERROR`	`Something went wrong`	Sunucu tarafında beklenmeyen hata — kısa süre sonra tekrar deneyin, sürerse destekle iletişime geçin.

Diğer

Belirti: 405 `Method not allowed`

Sebep: Endpoint'e GET veya DELETE isteği gitti. Connfig MCP yalnızca Streamable HTTP (POST) kabul eder; eski SSE taşımasını desteklemez.
Çözüm: İstemci yapılandırmasında taşıma tipinin http (Streamable HTTP) olduğundan emin olun.

Belirti: Bağlantı kuruluyor ama araçlar görünmüyor

Çözüm: İstemciyi yeniden başlatın ve https://mcp.connfig.com/mcp adresini (sondaki /mcp dahil) doğru yazdığınızı kontrol edin.

Sorun devam ederse abonelik ve kota durumunuzu asistan üzerinden get_my_subscription ve get_workspace_usage araçlarıyla sorgulayın — çoğu engelin sebebi bu iki çıktıda görünür.

Bu sayfada