API Anahtarları ve MCP

Bu sayfa ne işe yarar?

Platformu normalde tarayıcıdan kullanırsınız. Başka bir programın, bir otomasyonun ya da bir yapay zeka asistanının sizin adınıza platformla çalışmasını isterseniz, o araca bir API anahtarı verirsiniz. API anahtarı, aracın kim olduğunu ve neye erişebileceğini belirleyen bir kimlik belgesidir.

MCP ise yapay zeka asistanlarını platforma güvenle bağlayan bir köprüdür. Örneğin masaüstü asistanınız bu bağlantı ve geçerli bir anahtarla projelerinizi listeleyebilir ya da yeni bir görev oluşturabilir.

Örnek senaryo

Can Bey bir ajansta proje yöneticisidir. Her sabah masaüstü yapay zeka asistanına “Bu hafta teslim edilecek projeler hangileri?” diye sormak istiyor.

1. Can Bey, API Anahtarları ekranında “Masaüstü Asistan” adında yeni bir anahtar oluşturur.
2. Makul bir son kullanma tarihi seçer.
3. Anahtarı hemen kopyalayıp güvenli bir yere kaydeder, çünkü ekran kapandıktan sonra bir daha görüntülenemez.
4. Anahtarı asistanın MCP bağlantı ayarına ekler.
5. Artık asistana doğal dille soru sorabilir ve projelerini listeletebilir. Beklemediği bir erişim görürse anahtarı iptal eder.

Kimler kullanır

• Geliştiriciler ve entegrasyon sorumluları: Platformu diğer sistemlere veya otomasyonlara bağlamak için anahtar oluşturur ve yönetir. Anahtarları Profil menüsündeki API Anahtarları bölümünden oluşturur.
• Yapay zeka asistanı kullanan ekipler: Masaüstü asistanı platforma bağlamak için bir anahtar üretip aracın ayarlarına ekler.
• Organizasyon yöneticileri: Mevcut anahtarları, en son ne zaman kullanıldıklarını ve kullanım kayıtlarını izler; şüpheli bir durumda anahtarı iptal eder.

Adım adım

1. API Anahtarları bölümünü açın. Sağ üstteki profil menüsünden API Anahtarları ekranına gidin. Mevcut anahtarlarınızı ve durumlarını görürsünüz.
2. Yeni anahtar oluşturun. Yeni anahtar düğmesine basın ve anahtarı nerede kullanacağınızı hatırlatan bir ad verin, örneğin “Masaüstü Asistan” veya “Otomasyon”.
3. İsteğe bağlı son kullanma tarihi belirleyin. Anahtarın belirli bir tarihte kendiliğinden geçersiz olmasını isterseniz bir süre tanımlayın.
4. Anahtarı hemen kopyalayın. Anahtar oluşturulduktan sonra yalnızca bir kez tam olarak gösterilir. Kopyalayıp güvenli bir yere kaydedin; ekranı kapattıktan sonra tekrar göremezsiniz.
5. Aracınıza tanımlayın. Anahtarı kullanacağınız aracın ayarına girin. Yapay zeka asistanları için bu, anahtarı aracın MCP bağlantı ayarına eklemek demektir.
6. Kullanımı izleyin. Anahtarın kullanım kayıtlarına zaman zaman 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 gidin] --> B[Yeni anahtar oluşturun]
    B --> C[Ad ve isteğe bağlı son kullanma tarihi verin]
    C --> D[Anahtarı hemen kopyalayıp saklayın]
    D --> E[Aracınıza veya asistanınıza tanımlayın]
    E --> F{Şüpheli bir kullanım var mı?}
    F -- Evet --> G[Anahtarı iptal edin]
    F -- Hayır --> H[Kullanımı izlemeye devam edin]

Sık sorulan sorular

API anahtarı ile normal giriş arasındaki fark nedir? Normal giriş, platformu tarayıcıdan kullanırken geçerlidir. API anahtarı ise bir dış aracın sizin adınıza çalışmasına izin verir ve siz iptal edene kadar geçerli kalır.

MCP tam olarak ne işe yarar? Yapay zeka asistanınızın platformdaki verilere, sizin izninizle ulaşmasını sağlar. Örneğin proje listelemesini veya görev oluşturmasını isteyebilirsiniz.

Anahtarımı kaybedersem ne olur? Anahtar bir daha gösterilmediği için kaybedilen anahtar geri getirilemez. Eski anahtarı iptal edip yeni bir anahtar oluşturun ve aracınıza yeniden tanımlayın.

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

Anahtar başkasının eline geçerse ne olur? Anahtarı tutan kişi, sizin erişiminizle işlem yapabilir. Şüpheli bir durumda hemen iptal edin; iptal edilen anahtar anında geçersiz olur.

Neden her araç için ayrı anahtar öneriliyor? Bir aracın anahtarını iptal ettiğinizde diğer araçlar çalışmaya devam eder. Ayrıca hangi anahtarın nerede kullanıldığını takip etmek ve sorun çıkaran anahtarı hızlıca kapatmak kolaylaşır.