Claude API Entegrasyonu: Anthropic Claude ve OpenAI Modelleri Şirket Sistemlerine Nasıl Bağlanır?
Claude API entegrasyonu, şirketinizin kendi sistemleri ile model arasında çalıştırdığı küçük bir arka uç servisidir. Çalışanlar kurumsal hesaplarıyla giriş yapar. API anahtarını bu servis tutar, modelin hangi veriyi ve hangi araçları göreceğine o karar verir, her çağrıyı kaydeder ve limitleri uygular. Model ERP'nize doğrudan bağlanmaz, API anahtarı da hiçbir zaman tarayıcıda ya da mobil uygulamada durmaz.
Geri kalan her şeyi üç karar belirler: erişim yolu (doğrudan Anthropic API ya da bulut hesabınız üzerinden Claude), ağınızdan hangi verinin çıkabileceği ve modelin ne yapmaya yetkili olduğu. Şirketlerde ChatGPT tarafı, yani OpenAI API entegrasyonu da aynı yapıyla kurulur. Ürün bilgileri Kasım 2026'da resmî belgelerden kontrol edildi; bağlantılar yazının sonunda.
Erişim yolları: Anthropic API, Amazon Bedrock ya da Google Vertex AI
Seçtiğiniz yol; servisi kimin işlettiğini, verinizi kimin işlediğini ve faturanın nereden geldiğini belirler.
- Doğrudan Anthropic API. Anthropic'te bir hesabınız olur ve API anahtarı üretirsiniz. Veri işleyen Anthropic'tir ve Claude API'nin bütün özelliklerine erişirsiniz.
- Amazon Bedrock. Servisi AWS işletir, veri işleyen de AWS'dir. Erişim AWS IAM ile verilir, kullanım AWS faturanıza yansır. AWS, model sağlayıcılarının istemlerinizi ve yanıtları göremediğini belirtir. Ayrıntı için Türkiye'den Amazon Bedrock rehberimize bakın.
- Google Cloud Vertex AI. Google, Claude'u iş ortağı modeli olarak sunar; erişim ve faturalama Google Cloud üzerindendir. Google, Vertex AI'ı artık Gemini Enterprise Agent Platform adıyla yürütüyor.
Claude ayrıca Microsoft Foundry'de de sunuluyor. Bulut platformlarının kendi yayın takvimi vardır: platforma ve uç noktaya göre MCP connector, Message Batches API ya da Files API gibi özellikler orada bulunmayabilir. Tasarımı bir özelliğin üzerine kurmadan önce özellik sayfasına bakın.
OpenAI modellerinde seçim benzerdir: doğrudan OpenAI API ya da Microsoft Foundry içindeki Azure OpenAI. İkincisinde modelleri Microsoft barındırır ve istemlerle yanıtların OpenAI'ın erişimine açık olmadığını belirtir. Pratik kural: bir özellik ya da bölge şartı aksini gerektirmiyorsa kimlik yönetiminizin, sözleşmelerinizin ve faturanızın zaten bulunduğu yolu seçin. Hangi modelin hangi işe uygun olduğu için hangi AI ne için daha iyi yazımıza bakabilirsiniz.
Claude API entegrasyonu nasıl kurulur?
- Sistemleriniz ile model arasında bir arka uç servisi. Kullanıcıyı doğrular, istemi hazırlar, modeli çağırır, araçları çalıştırır ve kaydı yazar.
- Araç kullanımı (tool use). Bir fonksiyonu adı, açıklaması ve girdi şemasıyla tanımlarsınız. Model hiçbir şeyi kendisi çalıştırmaz: çağrı ister, çalıştırıp çalıştırmamaya sizin kodunuz karar verir ve sonucu geri gönderir. OpenAI aynı mekanizmaya function calling der.
- Şirket belgeleri üzerinde arama. Bir arama dizini soruyla ilgili bölümleri bulur ve modele bağlam olarak verir. Yetki filtresini arama anında, soruyu soran kullanıcıya göre uygulayın.
- MCP bağlayıcıları. Model Context Protocol, modelleri araçlara ve veriye bağlamak için açık bir standarttır. ERP ya da destek sisteminiz için bağlayıcıyı bir kez yazar, her uygulamada kullanırsınız. Claude API, MCP connector özelliğiyle uzak MCP sunucularını çağırabilir; OpenAI API de uzak MCP sunucularını destekler.
Claude API için bir araç tanımı kısadır:
{
"name": "get_order_status",
"description": "Look up the status of a customer order by order number.",
"input_schema": {
"type": "object",
"properties": {
"order_id": { "type": "string" }
},
"required": ["order_id"]
}
}
Konunun iş tarafı için şirketlere yapay zekâ entegrasyonu nasıl yapılır ve ERP ile yapay zekâ entegrasyonu yazılarına bakın.
Kimlik ve sırlar
- API anahtarları kasada durur. Arka uç anahtarı çalışma anında bir sır yöneticisinden okur. Kodda, imajda ya da sohbet mesajında anahtar olmaz. Anahtarları düzenli yenileyin; her uygulama ve ortam için ayrı anahtar kullanın.
- Mümkünse bulut kimliği kullanın. Bedrock, Google Cloud ve Azure'da servis, uzun ömürlü anahtar yerine bulut kimliğiyle (IAM rolü, servis hesabı, Microsoft Entra ID) doğrulanabilir.
- Önde SSO. Kullanıcılar kurumsal kimlik sağlayıcınız üzerinden giriş yapar; servis bu kimliği araçlara taşır.
- Araçlarda en az yetki. Araç, her şeyi gören bir servis hesabıyla değil, soruyu soran kullanıcının yetkisiyle çalışır. Salt okunur başlayın; gönderen, ödeyen ya da silen her işlem için onay isteyin.
Ekim 2026'daki Binance saldırısında zincirin halkalarından biri, erişim alanı fazla geniş olan bir iç yapay zekâ aracıydı.
Veri sınırları: ağınızdan ne çıkabilir?
Modelin neyi görebileceğine veri sınıfı bazında karar verin ve bunu arka uçta uygulayın: maskeleme, alan filtreleri, engellenen belge sınıfları.
- Eğitim. Anthropic, API verisinin açık izniniz olmadan model eğitiminde kullanılmadığını belirtir. OpenAI da API verisini varsayılan olarak eğitimde kullanmaz.
- Saklama. Anthropic, talep üzerine sıfır veri saklama (zero data retention) düzenlemesi sunar. Bu düzenleme her özelliği (toplu işleme ve Files API veriyi doğası gereği saklar) ve her modeli kapsamaz. OpenAI'da onaylı müşteriler için benzer bir seçenek vardır.
- Bölge. Bu yazının yazıldığı tarihte doğrudan Claude API'de işlemeyi ABD'ye sabitleyebilir ya da küresel bırakabilirsiniz. AB içinde işleme bulut yollarında mümkündür: Amazon Bedrock'ta AB çıkarım profilleri, Google Cloud'da AB çok bölgeli uç noktası, Azure'da AB veri bölgesi dağıtımları. OpenAI da uygun API müşterilerine Avrupa'da veri yerleşimi sunar.
Türkiye'deki şirketlerde istem çoğu durumda yurt dışındaki bir bölgede işlenir. İçinde kişisel veri varsa KVKK'nın yurt dışına aktarım kuralları devreye girer; ayrıntısı KVKK ve yapay zekâ yazımızda. Bir veri sınıfı ağınızdan hiç çıkamıyorsa seçenek, kendi sunucularınızda çalışan yerel bir modeldir.
Anthropic entegrasyonunda maliyet kontrolü
- Kullanım limitleri. Claude Console, çalışma alanı (workspace) bazında harcama ve hız limiti tanımlamayı destekler. Arka uçta kullanıcı ya da ekip bazında kendi kotalarınızı ekleyin.
- İstem önbelleği (prompt caching). İstemin uzun ve değişmeyen kısımları, örneğin talimatlar, araç tanımları ya da bir başvuru belgesi, önbelleğe alınır ve daha düşük maliyetle yeniden kullanılır.
- Toplu işleme (batch). Bekleyebilen işler, örneğin gece yapılan sınıflandırma, eşzamansız ve indirimli çalışır.
- Basit işe küçük model. Yönlendirme, veri çıkarma ve kısa özetler çoğu zaman en büyük modeli gerektirmez.
- Daha az bağlam. Belgenin tamamını değil bulunan bölümleri gönderin ve çıktı uzunluğunu sınırlayın.
İzleme ve değerlendirme
Her isteği kaydedin: kullanıcı, uygulama, model, token sayıları, çağrılan araçlar, gecikme ve hatalar. İstem ve yanıt metninin saklanıp saklanmayacağına ayrıca karar verin, çünkü kişisel veri içerebilir. Platformlar yardımcı olur: Anthropic kullanım ve maliyet API'si ile OpenTelemetry izleme sunar, Bedrock'ta model çağrı günlüğü, Google Cloud'da istek-yanıt günlüğü vardır.
Beklenen yanıtlarıyla birlikte sabit bir gerçek soru seti tutun ve istemi, bir aracı ya da modeli her değiştirdiğinizde çalıştırın. Modeller yayımlanan bir takvimle kullanımdan kalkar; model değişikliği er geç gelir.
Sık yapılan hatalar
- İstemci kodunda anahtar. Web sayfasına, mobil uygulamaya ya da açık bir depoya konan anahtar bulunur ve başkalarınca kullanılır.
- Geniş yetkili ajanlar. Her şeye erişen tek bir servis hesabı, bir istem enjeksiyonunu veri sızıntısına çevirir.
- Kayıt tutmamak. Kayıt yoksa bir yanıtı, bir faturayı ya da bir olayı açıklayamazsınız.
- Hız limiti koymamak. Tek bir betikteki döngü aylık bütçeyi bir gecede bitirebilir.
- Getirilen metne güvenmek. Belgelerden, e-postalardan ve web sayfalarından gelen içerik veridir, talimat değildir.
- Entegrasyon yerine bireysel sohbet araçları. Bkz. paylaşılan AI sohbetleri herkese açık.
Canlıya çıkmadan önce kontrol listesi
- Erişim yolu seçildi, veri işleme sözleşmesi imzalandı.
- Bütün model çağrıları tek bir arka uç servisinden geçiyor.
- Anahtarlar kasada, yenileme denendi, istemci kodunda anahtar yok.
- Önde SSO var, kullanıcı kimliği araçlara taşınıyor.
- Her aracın bir sahibi, bir kapsamı ve yazma işlemleri için onay kuralı var.
- Veri sınıfları, bölge ve saklama ayarları yazılı.
- Harcama limiti, hız limitleri ve uyarılar tanımlı.
- Kayıt açık, değerlendirme seti hazır, model güncelleme planı yazıldı.
Sık sorulan sorular
Claude API entegrasyonu nedir?
Kendi yazılımınız ile Anthropic'in Claude modelleri arasında API üzerinden kurulan bağlantıdır. Şirketlerde genellikle kullanıcıyı doğrulayan, modeli çağıran, ona seçilmiş veri ve araçları veren, kullanımı kaydeden ve sınırlayan bir arka uç servisidir.
Anthropic API'yi doğrudan mı kullanmalıyız, Amazon Bedrock ya da Google Vertex AI üzerinden mi?
Claude API'nin bütün özelliklerine ihtiyacınız varsa doğrudan Anthropic API'yi kullanın. Kimlik yönetiminiz, faturanız ve sözleşmeleriniz zaten oradaysa ya da bölgesel uç noktaya ihtiyacınız varsa Amazon Bedrock ya da Google Cloud'u seçin.
Anthropic entegrasyonunda şirket verimiz modeli eğitmek için kullanılır mı?
Anthropic'in belgelerine göre API verisi açık izniniz olmadan model eğitiminde kullanılmaz. Talep üzerine sıfır veri saklama düzenlemesi de yapılabilir; bazı özellikler ve modeller bunun dışındadır.
Şirketler için ChatGPT (OpenAI API) entegrasyonu ile Claude API entegrasyonu arasında ne fark var?
Mimari aynıdır: arka uç servisi, araçlar, belge araması, limitler ve kayıtlar. Erişim yolları farklıdır (OpenAI API ya da Azure OpenAI) ve araç kullanımına function calling denir. İyi kurulmuş bir arka uç iki sağlayıcıyı da kullanabilir.
Claude API entegrasyonunun maliyeti nasıl kontrol altında tutulur?
Çalışma alanı bazında harcama ve hız limiti koyun, uzun istemlerin değişmeyen kısmını önbelleğe alın, acil olmayan işleri toplu çalıştırın ve basit işlerde küçük model kullanın.
Özet
Claude API entegrasyonunda modeli çağırmak işin kolay kısmıdır. Asıl iş çevresindedir: kim soru sorabilir, model neyi görüp ne yapabilir, veri nerede işlenir ve bunun maliyeti nedir. Önce erişim yolunu ve veri sınırlarını netleştirin, sonra bütün uygulamaların kullandığı tek bir arka uç kurun.
Claude'u ya da OpenAI modellerini şirketinize entegre etmeyi mi planlıyorsunuz? AI Forwarder olarak Anthropic Claude ve OpenAI GPT gibi barındırılan modelleri kendi API'leri ya da Amazon Bedrock, Azure OpenAI ve Vertex AI üzerinden entegre ediyoruz: SSO, en az yetkili erişim, veri sınırları, kullanım ve maliyet limitleriyle. Paysafe için Anthropic entegrasyonu içeren AI Forwarder projeleri yaptık. Claude ve OpenAI entegrasyonu, yapay zekâ entegrasyonu hizmetlerimiz ve yerel modeller sayfalarına göz atın ya da bize yazın.
Kaynaklar ve ek okuma
- Anthropic: Claude API özelliklerine genel bakış
- Anthropic: güncel Claude modelleri
- Anthropic: tool use ve MCP connector
- Anthropic: prompt caching ve batch processing
- Anthropic: API ve veri saklama ile veri yerleşimi
- Anthropic: workspaces ve hız limitleri
- Anthropic: Amazon Bedrock'ta Claude ve Google Cloud'da Claude modelleri
- AWS: Amazon Bedrock'ta veri koruma ve bölgeler arası çıkarım
- Google Cloud: Anthropic Claude modelleri
- Microsoft: Azure OpenAI modellerinde veri, gizlilik ve güvenlik ve dağıtım türleri
- OpenAI: function calling ve veri kontrolleri
- Model Context Protocol