Ana içeriğe geç

Gemini'yi digna'ya Bağlayın

Bu kılavuz, Google'ın Gemini araçlarını 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.

Aracınızı Seçin

Araç Kimin için Yapılandırma
Antigravity CLI, IDE ve uygulama Google'ın ajan araçları. Antigravity CLI, Haziran 2026'da bireysel Google hesapları için Gemini CLI'ın yerini aldı mcp_config.json
Gemini CLI Gemini Code Assist Standard ve Enterprise lisansları ile ücretli Gemini API anahtarları settings.json veya gemini mcp add
Gemini Enterprise uygulaması — Desteklenmez. Özel MCP bağlayıcısı OAuth veya bir Google Cloud hizmet hesabıyla oturum açarken digna MCP Server API anahtarlarıyla kimlik doğrulaması yapar

Bu araçların tümü üzerinde çalıştıkları makineden bağlanır; bu nedenle o makine uç noktaya ulaşabildiği sürece şirket ağınızın içindeki digna ile çalışırlar.

Antigravity

Antigravity, MCP sunucularını CLI, IDE ve uygulama tarafından paylaşılan mcp_config.json dosyasından okur.

1. mcp_config.json Dosyasını Açın

Kapsam Dosya
Tüm projeleriniz ~/.gemini/config/mcp_config.json
Tek bir çalışma alanı Çalışma alanındaki .agents/mcp_config.json

Kullanılan dosyayı açmak için:

  • CLI: MCP yöneticisini açmak için /mcp yazın ve Enter tuşuna basın.
  • IDE: ajan yan panelinde … menüsünü açın, MCP Servers'ı, ardından Manage MCP Servers'ı, ardından View raw config'i seçin.
  • Uygulama: Customizations > Installed > MCP Servers bölümüne gidin ve Copy Config File Path seçeneğini kullanın.

2. digna Sunucusunu Ekleyin

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

{
  "mcpServers": {
    "digna": {
      "serverUrl": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <api key>"
      }
    }
  }
}

Antigravity uzak sunuculara yalnızca digna MCP Server'ın kullandığı streamable HTTP üzerinden ulaşır. Uç noktayı serverUrl olarak yazın; Gemini CLI'ın httpUrl anahtarı desteklenmez.

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

CLI'da /mcp yazın: MCP yöneticisi digna sunucusunu durumu ve araçlarıyla birlikte gösterir, ayrıca yapılandırmayı yeniden yükleyebilir ve bağlantı günlüklerini gösterebilir. IDE'de sunucu Manage MCP Servers altında görünür.

Dosyayı Koruyun

mcp_config.json, API anahtarını düz metin olarak tutar. Çalışma alanındaki .agents/mcp_config.json dosyasını sürüm kontrolünün dışında tutun ve genel dosyayı yalnızca kendi hesabınızın okuyabilmesini sağlayın.

Gemini CLI

1. Sunucuyu Ekleyin

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

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

Komutu çalıştırdığınızda kabuğunuz $DIGNA_API_KEY değerini yerine koyar, böylece Gemini CLI anahtarı kendi ayarlarında saklar. --scope user olmadan sunucu yalnızca geçerli projeye eklenir.

2. Veya settings.json Dosyasını Düzenleyin

Yukarıdaki komut settings.json dosyasına yazar. Dosyayı kendiniz düzenlemek için:

Kapsam Dosya
Tüm projeleriniz ~/.gemini/settings.json
Tek bir proje Projedeki .gemini/settings.json 
{
  "mcpServers": {
    "digna": {
      "httpUrl": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <api key>"
      }
    }
  }
}

Streamable HTTP için anahtar olan httpUrl'yi kullanın. Benzer url anahtarı, digna MCP Server'ın sunmadığı eski SSE aktarımını seçer. Sunucu adında alt çizgi kullanmayın.

Trust'ı Kapalı Bırakın

Sunucuda "trust": true yoksa Gemini CLI her araç çağrısından önce sorar. digna için trust'ı kapalı bırakın, böylece bir ajanın yapılandırmanızda yaptığı her değişikliği siz onaylarsınız.

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

Kabuğunuzdan:

gemini mcp list

digna sunucusu bağlı olarak görünmelidir. Bir Gemini CLI oturumunun içinde, sunucuyu ve araçlarını görmek için /mcp komutunu çalıştırın.

Gemini Sorunlarını Giderme

Sunucu Bağlantısız Görünüyor

  • Uç noktanın /mcp ile bittiğini ve makinenizden erişilebilir olduğunu kontrol edin.
  • Anahtar adını kontrol edin: Antigravity'de serverUrl, Gemini CLI'da httpUrl.
  • 401, anahtarın reddedildiği anlamına gelir; bkz. 401 Unauthorized.

Gemini CLI Hesabım İçin Artık Başlamıyor

Haziran 2026'dan bu yana bireysel Google hesapları Gemini CLI yerine Antigravity CLI kullanır. digna girişini Antigravity bölümünde açıklandığı gibi mcp_config.json dosyasına taşıyın ve httpUrl'yi serverUrl olarak yeniden adlandırın.

Ayrıca Bakınız