Sorun Giderme

401 Missing authentication token

Uç nokta geçerli bir JWT veya OAuth bearer anahtarı görmedi. Yanıt şunu içerir:

WWW-Authenticate: Bearer realm="mcp",
  resource_metadata="https://<api>/.well-known/oauth-protected-resource"

Claude.ai bu başlığı OAuth keşfini başlatmak için kullanır — sunucu tarafında düzeltilecek bir şey yoktur. curl ile test ediyorsanız Authorization: Bearer <anahtar> gönderin.

403 Feature not included in plan: mcp.access

Hesabınız Free planında. Plus veya üzerine yükseltin.

403 Tool 'update_agent' requires mcp.tools.write (not in plan)

update_agent, mcp.tools.write ile korunan tek araçtır ve bu yetki Pro planından itibaren gelir. Diğer tüm araçlar mcp.tools.read tüketir.

403 Feature not included in plan: mcp.oauth_client.manage

OAuth istemcisi oluşturmak Pro veya üzerini gerektirir. Mevcut bir istemciyi kullanın ya da planınızı yükseltin.

429 Rate limit exceeded for mcp.access

Dakika başına uç nokta bütçesini aştınız. Yanıt şunları içerir:

• Retry-After: <saniye>
• X-RateLimit-Limit: <bütçe>

Bekleyip yeniden deneyin. Bu sınıra düzenli olarak takılıyorsanız yükseltin — Pro'nun yüksek kapasiteli sürümünün bütçesi Plus'ın 10 katıdır.

429 Rate limit exceeded for mcp.tools.read

Saatlik okuma bütçesini tükettiniz. tools/call sıklığınızı düşürün ya da bir saat bekleyin.

OAuth /authorize girişe yönlendiriyor ama geri dönmüyor

Giriş sayfasının, özgün sorgu dizesi bozulmadan /api/v1/mcp/oauth/authorize?... adresine geri yönlendirmesi gerekir. Web uygulamanızın redirect sorgu parametresini düşürdüğünü görüyorsanız bu bir web uygulaması yapılandırma hatasıdır, MCP sorunu değildir.

Bir araç adı "unknown tool" döndürüyor

Bazı araçlar sunucuda bulunur ancak sunulmaz; bunları adıyla çağırmak başarısız olur. Araç Referansı sayfasına bakın — bağlanmış ama henüz etkinleştirilmemiş araçlar o sayfanın sonunda listelenir. Özellikle list_connector_instances ve execute_connector_tool sunulmaz; bunların yerine connectors_list ve connectors_get kullanın.