Claude'yu Nordlet'a Bağlama

Bu rehber, Claude'un Nordlet defterlerinizle çalışmasını istiyorsanız sizin içindir. Claude, https://api.nordlet.com/mcp adresindeki Nordlet MCP sunucusuna bağlanır. Bağlantıya yalnızca bir kez, bir Nordlet sayfasından izin verirsiniz. Herhangi bir anahtar kopyalamanız gerekmez.

1. Nordlet hesabı oluşturma

1. app.nordlet.com adresini açın ve e-posta adresinizi girin.
2. Hizmet Şartlarını, Gizlilik Politikasını ve Veri İşleme Anlaşmasını kabul edin. Nordlet size bir oturum açma bağlantısı gönderir. Bağlantı 15 dakika geçerlidir ve tek seferlik kullanılır. Parola kullanılmaz.
3. Bağlantıyı açın. Bir plan seçin: Ücretsiz deneme sürümüyle başlayan sabit ücretli plan veya ilk yüklemeyle istek başına ödeme planı.
4. Şirketinizi oluşturun: ad, ülke, sicil kodu ve KDV numarası. Sistemi önce denemek için Sandbox şirketi (Sandbox company) seçeneğini işaretleyin. Sandbox, test verilerini barındırır ve istediğiniz zaman silinebilir.

Birden fazla şirkete ait olabilirsiniz: kendi şirketiniz ve sahibinin sizi davet ettiği şirketler. Her şirketteki rolünüz (sahip, yönetici, muhasebeci, müdür, geliştirici veya izleyici) orada neler yapabileceğinizi belirler. Claude da aynı haklara sahip olur.

2. Claude'u bağlama

1. Claude içinde, https://api.nordlet.com/mcp adresine sahip özel bir bağlayıcı (connector) ekleyin. Kimlik doğrulama alanlarını boş bırakın.
2. Claude bir Nordlet sayfası açar. Oturum açmadıysanız Nordlet e-posta adresinizi sorar ve bir oturum açma bağlantısı gönderir. Bağlantıyı aynı tarayıcıda açın, böylece sayfaya geri dönersiniz.
3. Sayfa, erişim isteyen uygulamayı ve döneceğiniz adresi belirtir. Her ikisini de kontrol edin ve ardından İzin Ver (Allow) seçeneğini seçin. Reddet (Deny) seçeneği sizi erişim vermeden geri gönderir.
4. Tekrar Claude'dasınız ve bağlayıcı bağlanmış durumdadır.

Claude, erişimini kendi kendine yeniler. Bir erişim belirteci (access token) bir saat geçerlidir. Claude, size sormadan bunun yerine yeni bir belirteç alır.

3. Claude Code'u bağlama

Şunu çalıştırın:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

Ardından Claude Code içinde /mcp komutunu çalıştırın ve nordlet sunucusunun kimliğini doğrulamayı seçin. Tarayıcınız, 2. adımdaki ile aynı Nordlet sayfasını açar. İzin Ver (Allow) seçeneğinden sonra tarayıcı sizi kendi bilgisayarınızdaki Claude Code'a geri gönderir.

4. Şirketlerinizde çalışma

Tek bir bağlantı, üyesi olduğunuz her şirket içinde çalışır. Claude önce şirketlerinizi listeler, ardından her çağrıda şirketin adını belirtir. Şirketi adıyla isteyin; örneğin "bu faturayı UAB Pavyzdys adına düzenle". Yeni bir şirkete eklendiğinizde, Claude bu şirkette hemen çalışmaya başlayabilir. Bir şirketten çıkarıldığınızda, Claude artık o şirket üzerinde çalışamaz.

Claude'un yaptığı her çağrı olağan bir API isteğidir ve diğer tüm istekler gibi sayılır. Yaptığı değişiklikler denetim günlüğünde (audit log) kayıt altına alınır.

5. Bağlantıyı kesme

1. Nordlet'te Hesap (Account) → Geliştiriciler (Developers) bölümünü açın. Bağlantı, API anahtarlarınız arasında uygulamanın adı altında (örneğin "Claude") listelenir.
2. İptal Et (Revoke) seçeneğini seçin. Claude, her şirketteki erişimini anında kaybeder.

Yeniden bağlanmak için 2. adımı tekrarlayın.

Bunun yerine API anahtarı kullanma

Sahipler, yöneticiler ve geliştiriciler Hesap (Account) → Geliştiriciler (Developers) altında bir API anahtarı oluşturabilir ve bunu bir başlık (header) olarak gönderebilir. Bkz. MCP sunucusu.