Başlarken

Bu rehber sizi "Chainabit hesabım var" noktasından "Claude.ai MCP araçlarımı çağırabiliyor" noktasına götürür.

1. Planınızı doğrulayın

MCP uç noktası mcp.access yetkisiyle korunur. En az Plus planı gerekir — bkz. Planlar ve Hız Sınırları. Ücretsiz hesaplar 403 feature_not_in_plan yanıtı alır.

2. Bir OAuth istemcisi oluşturun

OAuth istemcileri, Chainabit web uygulamasında hesabınızın altından yönetilir (Ayarlar → MCP ve OAuth İstemcileri). Bu şu çağrıyı yapar:

POST /api/v1/mcp/oauth/clients
Authorization: Bearer <jwt_degeriniz>
Content-Type: application/json

{ "name": "Claude.ai", "redirectUris": ["https://claude.ai/api/mcp/auth_callback"] }

Yanıt client_id ve client_secret içerir — bunları güvenli bir yere kopyalayın; gizli anahtar yalnızca bir kez gösterilir.

Not: OAuth istemcisi yönetimi mcp.oauth_client.manage gerektirir — şu anda Pro planı. Plus kullanıcıları başkasına ait bir istemciyi (örneğin mevcut bir kurum istemcisini) kullanabilir, ancak kendi istemcilerini oluşturamaz.

3. Claude.ai'yi bağlayın

Claude.ai → Ayarlar → Entegrasyonlar → MCP Sunucusu Ekle bölümüne şunu yapıştırın:

https://<api-sunucunuz>/api/v1/mcp

Claude.ai şunları yapar:

1. Uç noktayı yoklar ve WWW-Authenticate: Bearer realm="mcp", resource_metadata="…" başlıklı bir 401 görür.
2. Yetkilendirme sunucusunu keşfetmek için /.well-known/oauth-protected-resource adresini çeker.
3. /authorize ve /token adreslerini keşfetmek için /.well-known/oauth-authorization-server adresini çeker.
4. Tarayıcınızda /api/v1/mcp/oauth/authorize adresini açar.
5. Oturumunuz açık değilse sizi girişe, ardından bir onay ekranına yönlendirir.
6. Yetkilendirme kodunu /token adresinde erişim anahtarıyla takas eder.
7. Erişim anahtarıyla tools/list çağırır ve araçlarınızı Claude içinde gösterir.

Hepsi bu kadar — Claude artık list_chains, get_agent, bits_query ve araç yüzeyinin geri kalanını çağırabilir.

4. Bir doğrulama çağrısıyla test edin

curl -X POST https://<api-sunucunuz>/api/v1/mcp \
  -H "Authorization: Bearer <erisim_anahtari>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Hesabınızın kullanabileceği araçları — planınıza göre süzülmüş hâlde — görmeniz gerekir.