Chainabit MCP Sunucusu

Claude Desktop, Cursor, Windsurf veya MCP uyumlu herhangi bir yapay zeka istemcisini Chainabit çalışma alanınıza bağlayın. Bağlandıktan sonra yapay zeka istemcisi bitlerini arayabilir, zincirleri yönetebilir, bağlayıcıları çalıştırabilir, çalışma alanı üyelerini inceleyebilir ve çok daha fazlasını doğal dil aracılığıyla yapabilir.

Chainabit MCP sunucusunun sunduğu özellikler

Sunucu, Model Context Protocol'u HTTP POST (/api/v1/mcp) üzerinden uygular. Kimlik doğrulamasının ardından yapay zeka istemcisi çalışma alanınızda mevcut tüm araçları otomatik olarak keşfeder:

• Yerel Chainabit çalışma alanı araçları
• Çalışma alanınızdaki aktif bağlayıcı araçları (GitHub, Notion, Slack ve diğerleri)

Araç listesi çalışma alanı yapılandırmanıza göre belirlenir — etkinleştirdiğiniz bağlayıcılar otomatik olarak görünür.

Kimlik doğrulama seçenekleri

Seçenek A — API anahtarı

1. app.chainabit.com adresine giriş yapın
2. Ayarlar → API Anahtarları bölümüne gidin
3. Yeni anahtar oluştur'a tıklayın ve kopyalayın — bir daha görüntüleyemezsiniz

Bu anahtarı Authorization başlığında Bearer token olarak kullanın.

Seçenek B — OAuth 2.0 + PKCE (Claude Desktop için önerilen)

Chainabit, OAuth 2.0 Yetkilendirme Kodu + PKCE'yi destekler. OAuth'u destekleyen MCP istemcileri (yeni Claude Desktop sürümleri gibi) statik bir API anahtarı olmadan kimlik doğrulaması yapabilir.

OAuth keşif uç noktası:

GET https://api.chainabit.com/.well-known/oauth-authorization-server

RFC 8414 desteği olan Claude Desktop ve diğer MCP istemcileri akışı otomatik olarak keşfeder. Manuel kurulum için aşağıdaki OAuth akışı bölümüne bakın.

Seçenek C — OAuth istemci kimlik bilgileri (Claude.ai ve arka uç araçları için)

Claude.ai'nin uzak MCP bağlayıcısı OAuth İstemci Kimliği ve OAuth İstemci Gizli Anahtarı gerektirir. Chainabit, bunları doğrudan hesap ayarlarınızdan oluşturmanıza olanak tanır.

Chainer ve Architect planlarında kullanılabilir.

1. app.chainabit.com adresine giriş yapın
2. Ayarlar → API → MCP OAuth İstemcileri bölümüne gidin
3. Yeni istemci oluştur'a tıklayın — bir ad ve yönlendirme URI'nizi girin (örn. https://claude.ai/callback)
4. İstemci Kimliği ve İstemci Gizli Anahtarı'nı kopyalayın — gizli anahtar yalnızca bir kez gösterilir

Ardından Claude.ai'nin Özel bağlayıcı ekle formunda:

• Uzak MCP sunucusu URL'si: https://api.chainabit.com/api/v1/mcp
• OAuth İstemci Kimliği: (oluşturduğunuz istemci kimliği)
• OAuth İstemci Gizli Anahtarı: (oluşturduğunuz gizli anahtar)

Claude.ai tüm OAuth akışını otomatik olarak yönetir — sizi Chainabit'in onay ekranına yönlendirir ve token'ları otomatik olarak değiştirir.

Yapay zeka istemcinizi bağlayın

Claude Desktop (API anahtarı)

macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json dosyasını açın ve şunu ekleyin:

{
  "mcpServers": {
    "chainabit": {
      "url": "https://api.chainabit.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer CHAINABIT_API_ANAHTARINIZ"
      }
    }
  }
}

Claude Desktop'ı yeniden başlatın. Araçların mevcut olduğu bir çekiç simgesiyle gösterilir.

Cursor

Cursor Ayarları → MCP → Sunucu Ekle bölümüne giderek şunları girin:

• Ad: Chainabit
• URL: https://api.chainabit.com/api/v1/mcp
• Auth başlığı: Authorization: Bearer CHAINABIT_API_ANAHTARINIZ

Windsurf

Windsurf Ayarları → Uzantılar → MCP Sunucuları bölümüne giderek şunu ekleyin:

{
  "name": "chainabit",
  "url": "https://api.chainabit.com/api/v1/mcp",
  "headers": {
    "Authorization": "Bearer CHAINABIT_API_ANAHTARINIZ"
  }
}

OAuth 2.0 akışı

OAuth 2.0 Yetkilendirme Kodu + PKCE'yi yerel olarak destekleyen istemciler için Chainabit yetkilendirme sunucusu olarak hareket eder. Akış:

1. İstemci GET /api/v1/mcp/oauth/authorize'ı client_id, redirect_uri, code_challenge (S256) ve scope=mcp:tools ile çağırır
2. Chainabit, app.chainabit.com/consent adresindeki onay arayüzüne yönlendirir
3. İsteği onaylarsınız — Chainabit redirect_uri?code=... adresine geri yönlendirir
4. İstemci kodu POST /api/v1/mcp/oauth/token ile code_verifier kullanarak değiştirir
5. İstemci access_token (1 saatlik TTL) ve refresh_token (30 günlük TTL) alır
6. İstemci token'ları yenilemek için POST /api/v1/mcp/oauth/token'ı grant_type=refresh_token ile çağırır

İstemci Kimliği: chainabit-mcp (gizli anahtar gerekmez — genel istemci) İzin verilen kapsamlar: mcp:tools openid profile:read

Çalışma alanı araç politikaları

Çalışma alanı başına hangi araçların yapay zeka istemcileri tarafından kullanılabileceğini kontrol edebilirsiniz:

Politika	Davranış
allow	Araç onay istemi olmadan çalışır
ask	Araç çalışmadan önce her zaman onayınızı gerektirir
block	Araç devre dışı bırakılır — yapay zeka istemcisi hata alır

Politikaları şuradan yönetin: Ayarlar → Çalışma Alanı → Araç İzinleri

Veya API aracılığıyla: PUT /api/v1/workspaces/{workspaceId}/tool-policies/{toolKey}

# Yıkıcı bir aracı engelle
curl -X PUT https://api.chainabit.com/api/v1/workspaces/WS_KIMLIGINIZ/tool-policies/bits.delete \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"policy": "block"}'

Örnek istemler

Bağlandıktan sonra şunları deneyin:

Sprint planlamasıyla ilgili bitlerimi ara.

Çalışma alanımdaki bağlayıcı örneklerini listele. Hangileri GitHub'dan?

Hangi zincirlerim var? "Sabah İncelemesi" adlı zincirin ayrıntılarını getir.

Çalışma alanımın üyeleri kimler ve rolleri neler?

Sağlık kontrolü

curl -X POST https://api.chainabit.com/api/v1/mcp \
  -H "Authorization: Bearer CHAINABIT_API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"ping","id":1}'

Beklenen yanıt:

{"jsonrpc":"2.0","id":1,"result":{}}

Mevcut araçları listele

curl -X POST https://api.chainabit.com/api/v1/mcp \
  -H "Authorization: Bearer CHAINABIT_API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'