Claude'u digna'ya Bağlayın¶

Bu kılavuz Claude'u digna MCP Server'a bağlar. AI Ajanlarına Genel Bakış sayfasında açıklandığı gibi, digna kurulumunuzun MCP uç noktasına ve bir API anahtarına ihtiyacınız vardır.

Örneklerde uç nokta olarak https://digna.example.com/mcp kullanılmıştır. Bunu kendi uç noktanızla değiştirin.

Bağlantı Yöntemini Seçin¶

Şirket ağınızın içinde çalışan bir digna kurulumu için Claude Code'u veya yerel köprülü Claude Desktop'ı kullanın.

Claude Code¶

1. Sunucuyu Ekleyin¶

API anahtarını bir ortam değişkenine koyun, ardından sunucuyu ekleyin:

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

Komutu çalıştırdığınızda kabuğunuz $DIGNA_API_KEY değerini yerine koyar, böylece Claude Code anahtarı kendi yapılandırmasında saklar.

--scope, sunucunun nerede kullanılabileceğini belirler:

2. Sunucuyu Ekibinizle Paylaşın (İsteğe Bağlı)¶

Bir projedeki herkese aynı sunucuyu sağlamak için proje kök dizinine bir .mcp.json dosyası ekleyin. Anahtarı dosyaya yazmayın. Claude Code, ${DIGNA_API_KEY} değerini her kişinin kendi ortamından doldurur:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Her kişi DIGNA_API_KEY değişkenini kendi anahtarına ayarlar. Claude Code dosyayı ilk kez bulduğunda, içindeki sunucuların kullanılıp kullanılmayacağını sorar.

3. Bağlantıyı Doğrulayın¶

Kabuğunuzdan:

claude mcp list

digna sunucusu ✔ Connected göstermelidir. Bir Claude Code oturumunun içinde, sunucuyu ve araçlarını görmek için /mcp komutunu çalıştırın.

Yerel Köprülü Claude Desktop¶

Claude Desktop'ın yapılandırma dosyası, makinenizde yerel MCP sunucuları başlatır. Küçük bir köprü olan açık kaynaklı mcp-remote paketi orada çalışır ve her isteği API anahtarınızla birlikte digna uç noktasına iletir. Köprü kendi makinenizde çalıştığı için bu yöntem, şirket ağınızın içindeki digna ile de çalışır.

1. Node.js'i Kurun¶

Köprü, Node.js 18 veya üzerini gerektirir. Claude Desktop, sisteminizde kurulu olan Node.js sürümünü kullanır. Şununla kontrol edin:

node --version

2. Yapılandırma Dosyasını Düzenleyin¶

claude_desktop_config.json dosyasını açın:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

digna sunucusunu ekleyin. Dosyada zaten bir mcpServers bölümü varsa, digna girişini oraya ekleyin:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. Claude Desktop'ı Yeniden Başlatın¶

Claude Desktop'tan tamamen çıkın ve yeniden başlatın. Yeni bir sohbette +'ya tıklayın ve Connectors'ı açın: digna listelenmiş ve açık olmalıdır.

Özel Bağlayıcı¶

Özel bir bağlayıcı (custom connector), herhangi bir yerel kurulum gerektirmeden digna'yı claude.ai, Claude Desktop ve Claude mobil uygulamalarında kullanılabilir hale getirir. Uç noktaya Anthropic'in bulutu bağlanır, bu nedenle bu yöntem yalnızca şu durumlarda çalışır:

• digna uç noktası internetten HTTPS üzerinden erişilebilir
• Claude kuruluşunuzda Add custom connector iletişim kutusunda Request headers seçeneği bulunuyor. Anthropic bunu sınırlı sayıda kuruluşa beta olarak sunmaktadır

1. Bağlayıcı Ayarlarını Açın¶

• Free, Pro, Max ve Ultra planları: Customize > Connectors bölümüne gidin ve Add custom connector'a tıklayın.
• Team ve Enterprise planları: bir Owner Organization settings > Connectors bölümüne gider, Add'e, ardından Custom'a tıklar ve tür sorulursa Web'i seçer.

2. Bağlayıcı Bilgilerini Girin¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: başlık adı olarak authorization seçin, değer olarak Bearer kelimesi ve boşluk dahil Bearer <api key> girin ve Required olarak işaretleyin.
4. Add'e tıklayın.

Team ve Enterprise planlarında üyeler daha sonra Customize > Connectors altından bağlanır; burada bağlayıcı Custom etiketini taşır.

Claude, mevcut bir bağlayıcının başlığını değiştiremez. Yeni bir anahtar kullanmak için bağlayıcıyı kaldırın ve yeniden ekleyin.

Claude Sorunlarını Giderme¶

claude mcp list, Failed to connect Gösteriyor¶

Nedenini görmek için claude mcp get digna komutunu çalıştırın. 401, anahtarın reddedildiği anlamına gelir; bkz. 401 Unauthorized. Claude Code ayrıca, anahtarı kopyalarken sıkça oluşan, anahtarın başında veya sonundaki boşluklar ya da satır sonları konusunda da uyarır.

digna, Claude Desktop'ta Görünmüyor¶

• Node.js 18 veya üzerinin kurulu olduğunu kontrol edin: node --version.
• claude_desktop_config.json dosyasının geçerli JSON olduğunu kontrol edin. Eksik bir virgül, dosyadaki tüm sunucuların yüklenmesini engeller.
• Claude Desktop'tan yalnızca pencereyi kapatarak değil, tamamen çıkın ve yeniden başlatın.

Özel Bağlayıcı Sunucuya Ulaşamıyor¶

Anthropic'in bulutu uç noktaya ulaşamıyor. Uç noktanın internetten HTTPS üzerinden geçerli bir sertifikayla erişilebilir olduğunu kontrol edin veya bunun yerine Claude Code üzerinden bağlanın.

Ayrıca Bakınız¶

• AI Ajanlarına Genel Bakış: uç nokta, API anahtarı, güvenlik ve genel sorun giderme
• Gemini: Antigravity veya Gemini CLI'ı bağlayın
• digna Agentic: AI ajanlarının digna ile neler yapabildiği