YZ Asistanından Damgala, İmzaya Gönder

Kapaktaki üç durak, sohbetin bittiği yerde başlar. Solda yazdığınız asistan, ortada İmzaOnay MCP sunucusu, sağda imzaya gönderilmiş belge. MCP (Model Context Protocol), asistanın sizin adınıza belirli işleri yapabilmesi için açık bir araç protokolüdür. Sohbet metin üretir. MCP, hesabınızdaki damga ve imza davetini çalıştırır.

MCP nedir?

Asistan, tek başına sizin İmzaOnay hesabını görmez. MCP sunucusu araya bir araç listesi koyar. Asistan listedeki adı okur, sizin cümlenize uyan aracı seçer, istemci çoğu zaman çalıştırmadan önce onay ister, sunucu işlemi sizin üyeliğinizle yapar ve sonucu sohbete metin olarak geri verir.

İmzaOnay MCP’si uzak bir sunucudur. Adres https://imzaonay.com.tr/api/mcp. Bilgisayarınıza ayrı bir MCP programı kurmazsınız. İstemci bu adrese HTTP ile bağlanır. Kimlik, Üyelik Bilgileri sayfasındaki API anahtarıdır. Başlık Authorization: Bearer ve anahtarın kendisidir. Aynı anahtar, yerel İmzaOnay Agent’ın License.ApiKey alanına da yazılır. İkisi ayrı iştir: Agent karttaki imzayı üretir, MCP damgalar ve davet gönderir.

Sitedeki sohbet ile farkı

imzaonay.com.tr üzerindeki yardım sohbeti soru cevaplar. API anahtarını istemez, yazılırsa tekrarlamaz, damga vurmaz ve imzaya göndermez. MCP, sizin kurduğunuz ve bu protokolü konuşan YZ asistanıdır. Anahtar o asistanın ayarındadır, sohbet balonunda değil.

Bu yüzden “asistanıma tanıt” demek, anahtarı prompta yapıştırmak değildir. Tanıtım iki parçadır: istemciye sunucu adresi ve anahtar, asistana da hangi aracı ne zaman kullanacağı.

Ne yapar, ne yapmaz?

Sunucu dört iş görür. Kanıt damgası, dosyanın veya bir web adresinin o anki içeriğinin SHA-256 özetine KamuSM nitelikli zaman damgası vurur. Belge ekleme, dosyayı hesabınıza yazar ve davet göndermez. Hızlı EYP, e-Yazışma paketini taslak kaydeder. İmzaya gönderme, belgeyi kaydeder ve imzacıya e-posta ile uygun numaradaysa WhatsApp daveti yollar.

Nitelikli imzanın özel anahtarı bu kanala gelmez. MCP imza atmaz. PIN, kart ve Agent aynı yerde kalır. Davet alan kişi imzayı imza ekranında tamamlar. Asistan daveti gönderir, imzayı atmaz.

Web’den belge yüklediğinizde olduğu gibi, belge sahibi de imzacı listesine yazılır. Dışarıya giden davet, sohbette adını verdiğiniz kişileredir.

Ne gerekir?

• Onaylı ve süresi dolmamış üyelik. Anahtar Üyelik Bilgileri sayfasındadır.
• Damga için kontör. Her dosya veya adres 1 kontör düşer. Kontör yetmezse araç, sitedeki kotanın mesajını olduğu gibi döner.
• Belge, imzaya gönderme ve hızlı EYP için depolama kotası. Bu dosyalar en fazla 20 MB olabilir. Hızlı EYP’de üst yazı ile ekler bu sınıra birlikte girer. Kanıt damgasında sınır 10 MB’dır. PDF, resim, metin ve HTML damgalanır. Hızlı EYP için onaylı Deneme, Bireysel veya Kurumsal üyelik gerekir.

Anahtar pasif üyelikte veya süre dolduğunda reddedilir. Sunucu, anahtarın kendisini araç cevaplarına yazmaz.

YZ asistanı nasıl bağlanır?

MCP konuşan asistan, sunucu adresini ve API anahtarını kendi ayarına yazar. Kayıt çoğu istemcide mcp.json dosyasındadır. Bazıları aynı alanları ayar ekranındaki MCP bölümüne ister. Anahtarın yerine Üyelik Bilgileri’nden kopyaladığınız değeri koyun. Tırnakları silmeyin, satır sonu eklemeyin.

{
  "mcpServers": {
    "imzaonay": {
      "url": "https://imzaonay.com.tr/api/mcp",
      "headers": {
        "Authorization": "Bearer <üyelik API anahtarı>"
      }
    }
  }
}

Kayıttan sonra istemci araç listesini çeker. Listede whoami, stamp_url, stamp_file, list_stamps, get_stamp, add_document, create_quick_eyp, send_for_signature ve get_signature_request görünmelidir. Görünmüyorsa adres, başlık adı ve anahtarın başındaki boşluk kontrol edilir. Anahtarı sohbete yazarak denemeyin.

Adres ile Bearer başlığı istemciden istemciye değişmez. İstemci bir tür alanı istiyorsa değeri http olur. Ayrı kurulum paketi yoktur.

Asistana nasıl söylenir?

Bağlantı kurulunca asistan araç açıklamalarını okur. Yine de kısa bir yönerge, yanlış aracı seçmesini azaltır. Bunu asistanın kalıcı talimatına yazabilirsiniz. Anahtar bu metinde yoktur. Soru-cevap sunucudaki bir form değildir. Asistan eksik alanı sohbette sorar, siz onayladıktan sonra aracı çağırır.

İmzaOnay MCP bağlı. Nitelikli imza atma. PIN, kart ve özel anahtar isteme.
API anahtarını isteme ve sohbete yazma.
Kontör veya depolama sorulunca whoami kullan. Anahtarı yazma.

Eksik bilgiyi uydurma. Dosya, adres, kişi veya sayı yoksa sor.
Yazma, damgalama veya davet aracını çalıştırmadan önce topladığın bilgileri listele ve onay al.

Kanıt damgası: sohbetteki dosya için stamp_file, verilen http(s) adresi için stamp_url.
Hangisi olduğu belli değilse sor. Doğrulama bağlantısını cevaba yaz.
Son damgalar için list_stamps, tek makbuz için get_stamp kullan.

Belgeyi yalnızca kaydetmek için add_document kullan. Davet gönderme.
“İmzaya hazırla” dendiğinde de davet gönderme. Yalnızca kaydet.

İmzaya göndermede send_for_signature kullan. İmza atma, daveti bu araç gönderir.
Dosya sohbette yoksa dosyayı iste.
Her imzacı için ad soyad, e-posta ve 11 haneli T.C. kimlik numarasını sor.
Cep telefonunu isteğe bağlı sor. Türkiye cep numarası değilse WhatsApp gitmeyeceğini söyle.
Birden fazla imzacı varsa her biri için aynı bilgileri ayrı sor.
Onaydan sonra aracı bir kez çalıştır.

Hızlı EYP taslağı için create_quick_eyp kullan. Paketi imzalama.
Konu, belge numarası, üst yazı, oluşturan ve bir alıcı eksikse sor.
Tarih söylenmezse bugünü kullan.
Gerçek kişide ad, soyad ve 11 haneli T.C. kimlik numarası; kurumda KKK ve ad; tüzel kişide MERSİS ve unvan sor.
Cevaptaki düzenleme adresini yaz.

İmza durumu için get_signature_request kullan. Belge kimliği yoksa sor.

Günlük cümleler yeterlidir. Araç adını söylemeniz gerekmez. Dosyayı sohbete eklersiniz. Asistan baytları okur ve araca base64 olarak verir. Siz base64 üretmezsiniz.

Örnek sorular

Soru	Ne olur?
Kontörüm ne kadar kalmış?	Damga kontörü ve depolama yazılır. Anahtar yazılmaz.
Depolama kotam yetiyor mu?	Kalan depolama, kontörle birlikte özetlenir.
Bu PDF’i belgelerime ekle. Kimseye davet gönderme.	Dosya kaydedilir. E-posta ve WhatsApp gitmez.
Bu belgeyi imzaya hazırla. Şimdilik yalnızca kaydet.	Belge hesabınıza yazılır. İmza atılmaz, davet gönderilmez.
Bu sözleşmeyi Ayşe Yılmaz, [email protected], TCKN 12345678901 adresine imzaya gönder. Telefon 5321112233.	Belge kaydedilir ve imzacıya davet gider. İmza, davet bağlantısında atılır.
Az önce eklediğim belgede kim imzalamış?	Belge durumu ve her imzacının imzalayıp imzalamadığı yazılır.
Bu PDF’i kanıt damgası ile damgala. Doğrulama bağlantısını yaz.	Sohbetteki dosya damgalanır. Makbuz ve doğrulama adresi döner.
https://example.com/duyuru adresinin şu anki halini damgala.	Adres o anda indirilir ve damgalanır.
Son damgalarım hangileri?	Son makbuzlar listelenir. Dosya baytı gelmez.
Bu üst yazıyla hızlı EYP taslağı oluştur. Konu sözleşme, belge no 2026/1, oluşturan ve alıcı gerçek kişi.	Paket taslak kaydedilir. Düzenleme adresi döner. Paket imzalanmaz.

T.C. kimlik numarası davet kaydının parçasıdır. Onu yalnızca kendi asistanınıza, kapalı bir sohbette verin. API anahtarından ayrıdır. Anahtar hâlâ ayar dosyasında kalır.

Araçlar

Araç	Ne döner?
whoami	Ad, e-posta, damga kontörü, depolama. Anahtar yok.
stamp_url	Verilen http veya https adresini o anda indirir ve damgalar. Yerel ve özel ağ adresleri reddedilir.
stamp_file	Sohbetteki dosyayı damgalar. En fazla 10 MB.
list_stamps	Son damgalar. Dosya baytı yok. Doğrulama ve makbuz adresleri var.
get_stamp	Tek makbuz. Yalnızca sizin damganız.
add_document	Dosyayı kaydeder. Davet yok. En fazla 20 MB.
create_quick_eyp	Hızlı EYP taslağı. Üst yazı ve ekler birlikte en fazla 20 MB. İmza yok.
send_for_signature	Belgeyi kaydeder, en az bir imzacıya davet yollar. En fazla 20 MB.
get_signature_request	Belge durumu ve her imzacının imzalayıp imzalamadığı. Yalnızca belgenin sahibi.

Belge ekleme

add_document dosyayı Belgelerim’e yazar. İmza türü, imzaya gönderme ile aynı kuraldan gelir. Belge sahibi imzacı listesine eklenir. E-posta ve WhatsApp gitmez. İmzaya göndermek ayrı araçtır.

Hızlı EYP

create_quick_eyp paketi taslak kaydeder. Konu, belge numarası, üst yazı, oluşturan ve bir alıcı zorunludur. Tarih boşsa bugündür. Alıcı ve oluşturan gerçek kişiyse ad, soyad ve 11 haneli T.C. kimlik numarası; kurumsa KKK ve ad; tüzel kişiyse MERSİS ve unvan gerekir. En fazla 10 ek eklenebilir. Üst yazı ile eklerin toplamı 20 MB’ı geçemez.

Cevaptaki düzenleme adresi /eyp/hizli/… sayfasını açar. Paket imzalı değildir. İmzayı o sayfadan, kart ve Agent ile siz tamamlarsınız. Bu araç Deneme, Bireysel veya Kurumsal üyelik ister.

Damga

Adres damgasında asistan URL’yi stamp_url ile gönderir. Sunucu sayfayı o anda indirir. Tarayıcınızda gördüğünüz ekran görüntüsü değildir. Ekran görüntüsü damgalanacaksa görüntüyü dosya olarak sohbete ekleyin. stamp_file onu damgalar.

Cevapta doğrulama adresi /verify-timestamp?id=…, makbuz sayfası /evidence/… ve PDF makbuz bağlantısı vardır. Doğrulama giriş istemez. Damganın neyi sabitlediği ve neyi sahiplik saymadığı kanıt damgası yazısındadır.

İmzaya gönderme

send_for_signature dosya adı, dosya içeriği ve en az bir imzacı ister. İmzacıda ad soyad, e-posta ve 11 haneli T.C. kimlik numarası zorunludur. Cep telefonu isteğe bağlıdır. Numara Türkiye cep numarasıysa WhatsApp bildirimi de gider. E-posta her durumda gönderilmeye çalışılır.

İmza türünü söylemezseniz uzantıdan seçilir. PDF PAdES, XML XAdES, UDF UDF, diğer dosyalar CAdES olur. Türü cümlede belirtebilirsiniz.

Cevaptaki belge numarası, sonra get_signature_request ile sorulur. Listede kimin imzaladığı ve bekleyen davetin adresi durur. Süreç özeti, herkes imzalayınca tamamlanma sertifikası olarak açılır. O sayfa nitelikli imza değildir. İmzalı dosya ayrıca doğrulanır.

Onay ve kota

İstemci aracı çalıştırmadan önce size soruyorsa, damga ve davet o onaydan sonra gider. Otomatik çalışan bir istemci, kontör düşebilir ve e-posta gönderebilir. Anahtarı yalnızca güvendiğiniz istemciye yazın. Ortak bir sohbet odasına veya herkese açık bir bota koymayın.

İşlemden önce “önce whoami” demeniz, kontörün ve depolamanın yetip yetmediğini gösterir. Kota dolunca araç hata metnini döner. Başarısız damgada kontör iadesi, sitedeki kanıt damgası ile aynı kurala bağlıdır.

Özet

MCP, asistanın İmzaOnay hesabında kanıt damgası vurması, belge eklemesi, hızlı EYP taslağı kaydetmesi ve belgeyi imzaya göndermesidir. Bağlantı https://imzaonay.com.tr/api/mcp, kimlik üyelik API anahtarıdır. Anahtar ayarda durur. Özel anahtar ve PIN bu sunucuya gelmez. Örnek kayıt geliştirici sayfasında, anahtarın yeri Üyelik Bilgileri’ndedir.