API Anahtarları ve MCP

Özet

API anahtarı, platforma arayüz üzerinden değil, dış araçlar aracılığıyla güvenli erişim sağlayan bir kimlik belgesidir. Normalde platformu tarayıcıdan giriş yaparak kullanırsınız; ancak başka bir yazılımın, bir otomasyonun ya da bir yapay zeka asistanının sizin adınıza platformla konuşmasını istediğinizde, o araca bir API anahtarı verirsiniz. Anahtar, o aracın kim olduğunu ve neye erişebileceğini tanımlar.

MCP, yapay zeka araçlarının platforma güvenli biçimde bağlanmasını sağlayan bir köprüdür. Bir yapay zeka asistanı, MCP bağlantısı ve geçerli bir API anahtarıyla platformdaki verilerinizi okuyabilir ve sizin izin verdiğiniz işlemleri gerçekleştirebilir; örneğin proje listeleyebilir veya görev oluşturabilir. Bu sayede platformu doğal dille, asistanınıza konuşarak kullanabilirsiniz.

API anahtarları hassas bilgilerdir. Bir anahtar yalnızca oluşturulduğu anda tam olarak gösterilir; sonrasında güvenlik için bir daha görüntülenemez. Bu yüzden anahtarı ürettiğiniz anda güvenli bir yere kaydetmeniz önemlidir.

Kimler kullanır

Geliştiriciler ve entegrasyon sorumluları: Platformu başka sistemlere veya otomasyonlara bağlamak için anahtar üretir ve yönetir. Anahtarları Profil menüsündeki API Anahtarları bölümünden oluşturur.
Yapay zeka asistanı kullanan ekipler: Masaüstü yapay zeka araçlarını platforma bağlamak için bir anahtar üretip aracın ayarlarına tanımlar. Böylece asistan üzerinden platformla çalışabilir.
Organizasyon yöneticileri: Hangi anahtarların var olduğunu, en son ne zaman kullanıldığını ve kullanım kayıtlarını izleyerek güvenliği gözetir; şüpheli bir durumda anahtarı iptal eder.

Adım adım süreç

API Anahtarları bölümüne gidin. Sağ üstteki profil menüsünden API Anahtarları ekranını açın. Mevcut anahtarlarınızı ve her birinin durumunu görürsünüz.
Yeni anahtar oluşturun. Yeni anahtar düğmesine tıklayın ve anahtara onu nerede kullanacağınızı hatırlatan bir ad verin (örneğin “Masaüstü Asistan” veya “Otomasyon”).
İsteğe bağlı son kullanma tarihi belirleyin. Anahtarın belirli bir tarihte otomatik olarak geçersiz olmasını isterseniz bir süre tanımlayın. Uzun süreli erişim için makul bir tarih seçmek iyi bir alışkanlıktır.
Anahtarı hemen kopyalayın. Oluşturulduğunda anahtar bir kez tam olarak gösterilir. Bu değeri kopyalayıp güvenli bir yere kaydedin; ekranı kapattıktan sonra tekrar göremezsiniz.
Aracınıza tanımlayın. Anahtarı kullanacağınız araca (yapay zeka asistanı, otomasyon veya başka bir sistem) girin. Yapay zeka asistanları için bu, aracın MCP bağlantı ayarına anahtarı eklemek anlamına gelir.
Kullanımı izleyin. Zaman zaman anahtarın kullanım kayıtlarına bakın. Beklemediğiniz bir erişim görürseniz anahtarı iptal edin ve gerekirse yenisini oluşturun.

Her araç için ayrı bir anahtar oluşturmak iyi bir uygulamadır; böylece bir anahtarı iptal etmek diğer araçları etkilemez.

Süreç akışı

flowchart TD
    A[API Anahtarları bölümüne git] --> B[Yeni anahtar oluştur]
    B --> C[Ad ve isteğe bağlı son kullanma tarihi ver]
    C --> D[Anahtarı hemen kopyala ve sakla]
    D --> E[Aracına veya asistanına tanımla]
    E --> F[Araç MCP ile güvenli bağlanır]
    F --> G[İzin verdiğin işlemleri yapar]
    G --> H{Şüpheli kullanım var mı?}
    H -- Evet --> I[Anahtarı iptal et]
    H -- Hayır --> J[Kullanımı izlemeye devam et]

Sık sorulan sorular

API anahtarı ile normal giriş arasındaki fark nedir? Normal giriş, platformu tarayıcıdan siz kullanırken geçerlidir ve kısa sürelidir. API anahtarı ise bir dış aracın sizin adınıza, arayüz olmadan platformla konuşmasını sağlar ve siz iptal edene kadar geçerli kalır.

MCP tam olarak ne işe yarar? MCP, yapay zeka araçlarının platforma güvenli biçimde bağlanmasını sağlayan bir köprüdür. Asistanınız bu köprü ve geçerli bir anahtar üzerinden platformdaki işleri sizin izniniz dahilinde yürütür; örneğin proje listeler veya görev oluşturur.

Anahtarımı kaybedersem ne yaparım? Anahtar bir daha gösterilmediği için kaybedilen bir anahtar geri getirilemez. Yapmanız gereken, eski anahtarı iptal edip yeni bir anahtar oluşturmak ve onu aracınıza yeniden tanımlamaktır.

Bir anahtar ne kadar süre geçerli olur? Son kullanma tarihi belirlemezseniz anahtar siz iptal edene kadar geçerli kalır. Dilerseniz oluştururken bir tarih tanımlayarak anahtarın o tarihte kendiliğinden geçersiz olmasını sağlayabilirsiniz.

Bir anahtar başkasının eline geçerse ne olur? Anahtar, onu tutan aracın sizin erişiminizle işlem yapmasına izin verir. Bu yüzden şüpheli bir durumda anahtarı hemen iptal etmelisiniz; iptal edilen anahtar anında geçersiz olur ve artık kullanılamaz.

Neden her araç için ayrı anahtar öneriliyor? Ayrı anahtarlar, bir aracı iptal ettiğinizde diğerlerinin çalışmaya devam etmesini sağlar. Ayrıca hangi anahtarın nerede kullanıldığını takip etmeyi ve sorun çıkaran anahtarı hızlıca kapatmayı kolaylaştırır.