İmzala MCP: Yapay Zeka Aracınızdan İmzala Hizmetleri

İmzala MCP sunucusu, İmzala hesabınızı bir yapay zeka aracına bağlar. Asistanınıza doğal dille talimat verdiğinizde işlem sizin API anahtarınızla İmzala üzerinden gerçekleşir. Bu doküman kurulumu, araçları ve yol haritasını anlatır.

Gereksinimler

1. Bir İmzala hesabı.
2. MCP destekli bir asistan: Claude Desktop, Claude Code, Cursor, Codex CLI, Gemini CLI veya OpenCode.
3. Node.js 20 veya üzeri (asistanlar npx ile paketi kendisi çalıştırır).

1. API anahtarı oluşturun

Geliştirici Portalı bölümüne girin, API Anahtarları sayfasından yeni bir anahtar oluşturun. Anahtar üretirken kapsam (izin) seçin. Hangi araçları kullanacağınıza göre en dar kapsam kombinasyonunu işaretleyin:

• Zaman damgası kapsamı: eser_tescil ve whoami için.
• Sözleşmeler kapsamı: sozlesme_durumu ve imzali_pdf_indir için.
• Şablonlar kapsamı: sablonlarim ve sablon_detay için.

API anahtarı hesabınıza erişim sağlar ve kredi harcayabilir; yapay zeka asistanı ve sağlayıcısı yapılandırma dosyanızı okuyabildiğinden, ihtiyacınız olmayan kapsamı eklemeyin. Anahtar bir şifre gibidir; sızarsa portaldan iptal edin.

2. Asistanınıza ekleyin

Asistanların hepsi aynı mcpServers yapılandırmasını kullanır:

{
  "mcpServers": {
    "imzala": {
      "command": "npx",
      "args": ["-y", "@imzala/mcp-server"],
      "env": { "IMZALA_API_KEY": "imz_..." }
    }
  }
}

• Claude Desktop: Ayarlar, Developer, MCP yapılandırma dosyası.
• Cursor: Settings, MCP, yeni sunucu.
• Varsayılan olarak İmzala üretim ortamına (https://api-prd.imzala.org) bağlanır. Farklı bir uç nokta için IMZALA_API_BASE_URL değişkenini ekleyebilirsiniz.

Codex CLI, Gemini CLI ve OpenCode kendi MCP yapılandırma biçimlerini kullanır; ancak aynı @imzala/mcp-server paketi ve IMZALA_API_KEY değişkeni geçerlidir. Aracınızın belgelerine göre MCP sunucusunu ekleyin.

3. Nasıl kullanılır

Bağlantıyı kurduktan sonra asistanınıza doğal dille yazın; araç uygun işlemi otomatik seçer.

Asistanınıza şunları yazabilirsiniz:

Ne yazmak istersiniz	Ne olur
”İmzala ile sunum.pdf dosyamı tasdikle”	Dosyanıza TÜBİTAK KAMU SM zaman damgası alır ve Eser Sahibi Sertifikanızı oluşturur.
”İmzala’da kaç kredim kaldı?”	Hesabınızı ve kalan kredi bakiyenizi gösterir.
”Kira sözleşmesi ne durumda, kim imzaladı?”	Sözleşmenin durumunu ve hangi tarafların imzaladığını gösterir.
”İmzala şablonlarımı listele”	Hesabınızdaki sözleşme şablonlarını sıralar.
”Kira şablonunda hangi alanları doldurmam gerekir?”	Şablonun taraflarını ve doldurulabilir değişkenlerini gösterir.
”Tamamlanan sözleşmenin imzalı PDF’ini indir”	Sözleşmenin sahipliğini doğrulayıp imzalı PDF’i indirir.

Sözleşme veya dosya kimliğini asistanınız konuşma geçmişinizden alır; değişik ifadeler de aynı şekilde çalışır.

Veri akışı (önemli): Sorguladığınız veri, protokolün doğası gereği kullandığınız yapay zeka aracının sağlayıcısının (Anthropic, Cursor vb.) altyapısından geçer. Özellikle sözleşme durumu sorgusu karşı tarafın adını, e-postasını ve imza tarihini, imzalı PDF indirme ise sözleşmenin tam içeriğini yapay zeka sağlayıcısına iletir. Bu, panelde zaten görebildiğiniz aynı bilgidir; İmzala bu aktarımı yapmaz, hangi aracı kullanacağınıza siz karar verirsiniz. Karşı tarafa ait verileri bu şekilde işlemeden önce kendi veri sorumlusu yükümlülüklerinizi değerlendirin.

4. Yol haritası: yakında

Kapsamı genişletmeye devam ediyoruz. Sonraki eklenecek hizmetler:

• Şablondan sözleşme oluşturma
• Sözleşme imzalama
• Dijital imza

İmza doğrulama artık İmza Doğrulama aracıyla ayrıca kullanılabilir. Yeni MCP araçları hazır olduğunda ayrıca duyuracağız.

Zaman damgası ne kanıtlar, ne kanıtlamaz

eser_tescil bir zaman damgasıdır, dijital imza ya da nitelikli elektronik imza değildir, ıslak imza eşdeğeri değildir.

• Kanıtlar: dosya en geç belirtilen anda vardı ve o andan beri değişmedi.
• Kanıtlamaz: eser sahipliği, telif hakkı veya mülkiyet (sahip bilgisi yalnızca beyandır); dosyayı kimin yüklediği; dosyanın daha önce var olmadığı. Noter onayı veya resmi bir tescil yerine geçmez.

Zaman damgasının ne olduğu hakkında ayrıntı için Zaman Damgası dokümanına bakın.

Sorun giderme

• “IMZALA_API_KEY ayarlı değil”: yapılandırmadaki env bloğunu ve anahtarı kontrol edin.
• “Bu anahtarın … yetkisi yok”: kullandığınız araca göre anahtarı doğru kapsamla (zaman damgası, sözleşmeler veya şablonlar) yeniden oluşturun.
• “Yetersiz kredi”: Geliştirici Portalı’ndan kredi durumunuzu görün.

Daha fazla bilgi için API Anahtarı ve SDK Kullanımı ve npm paket sayfası ve GitHub deposu’na göz atın.

Geliştirici notu: araç kimlikleri

İmzala MCP sunucusu şu an altı araca sahiptir. Asistanlar bu isimleri otomatik çözer; sizin yazmanıza gerek yoktur.

whoami

Girdi almaz. Hesabı (e-posta, çalışma alanı) ve kalan kredi bakiyesini döndürür. Bağlantının çalıştığını doğrulamak için kullanın.

eser_tescil

Dosyanıza TÜBİTAK KAMU SM zaman damgası (RFC 3161) alır ve Eser Sahibi Sertifikanızı oluşturur. Girdi parametreleri:

• file_path veya file_base64 (birini verin): damgalanacak dosya.
• file_name: dosya adı.
• owner_first_name, owner_last_name, description (isteğe bağlı).

Başarılıysa doğrulama bağlantısı ile yanıt döner.

sozlesme_durumu

Bir sözleşmenin durumunu ve hangi tarafların imzaladığını gösterir. Girdi: demand_id (sözleşme kimliği). Çıktı: durum (bekliyor, tamamlandı vb.), taraf listesi (ad, e-posta, imzalayıp imzalamadığı ve imzalayanlar için imza tarihi) ve tamamlandıysa imzalı PDF bağlantısı.

sablonlarim

Hesabınızdaki sözleşme şablonlarını listeler. Girdi (isteğe bağlı): page, limit.

sablon_detay

Bir şablonun taraflarını ve doldurulabilir değişkenlerini gösterir; şablondan sözleşme oluşturmadan önce hangi bilgilerin gerektiğini öğrenmek için kullanılır. Girdi: template_id.

imzali_pdf_indir

Tamamlanmış bir sözleşmenin imzalı PDF’ini indirir. Sözleşmenin sahipliği önce doğrulanır; yalnız tamamlanmış sözleşmelerde çalışır. Girdi: demand_id, isteğe bağlı save_path.