Hekimhane-Pro · MCP

Kliniğinizi yapay zeka asistanınızdan yönetin

Randevu talepleri, takvim, hasta yorumları ve hasta e-postaları artık konuşarak yönetilebilir. Hekimhane'nin MCP bağlantısını Claude gibi bir asistana ekleyin, panelde tıklayarak yaptığınız işleri tek cümleyle yaptırın.

Perşembe öğleden sonra boşluğum var mı? Varsa 15:00'e Selin Kaya için 2 saatlik randevu ekle.
takvim_durumu · Perşembe
randevu_ekle · 15:00–17:00
Perşembe 14:00–17:00 arası boştu. Selin Kaya için 15:00–17:00 randevusunu iki slot olarak ekledim. Takviminizde ve web sitenizdeki rezervasyon modülünde bu saatler artık dolu görünüyor.

MCP nedir, size ne kazandırır?

MCP (Model Context Protocol), yapay zeka asistanlarının uygulamalara güvenli ve kontrollü şekilde bağlanması için geliştirilmiş açık bir standarttır. Hekimhane bu standardı destekler. Asistanınız paneldeki verilerinizi okuyabilir ve sizin onayınızla işlem yapabilir.

Tıklamak yerine söyleyin

Menüler arasında gezmeden, tek cümleyle: listele, taşı, kapat, yanıtla. Uzun işlemler ve toplu değişiklikler dakikalar yerine saniyeler sürer.

Panelle aynı kurallar

Asistan panelinizdeki kuralların dışına çıkamaz: yalnızca onaylı işletmeleriniz, dolu ve kapalı saat kontrolleri, Pro kilitleri, hastaya otomatik bilgilendirmeler aynen geçerlidir.

Kontrol sizde

Kişisel anahtarla bağlanırsınız ve istediğiniz an iptal edersiniz. Veri değiştiren her işlemden önce asistan onayınızı ister.

Üç adımda bağlanın

1

Pro üyeliğiniz olsun

MCP bağlantısı Hekimhane-Pro'ya dahildir. Hesabınızda en az bir Pro işletme yeterlidir.

2

Anahtarınızı oluşturun

Panel → Hesap → MCP Bağlantısı. Anahtar yalnızca bir kez gösterilir; en fazla 5 anahtar oluşturabilirsiniz.

3

Asistanınıza ekleyin

Paneldeki hazır kodu asistanınızın ayarına yapıştırın. Anahtar koda otomatik yerleşir. "İşletmelerimi göster" diyerek deneyin.

Asistanınızın yapabildikleri

9 araç. İşlem etiketli araçlar veri değiştirir veya e-posta gönderir, bu yüzden onayınız istenir.

Randevu

Randevu taleplerini listeleOkuma

Randevu taleplerini (web sitesi, Hekimhane profili ve panelden eklenenler) en yeniden eskiye listeler.

"Bu haftaki onaylı randevularımı saat sırasıyla listele."
randevu_talepleri_listele
Randevuyu güncelle / ertele / iptal etİşlem

Bir randevu talebinin durumunu değiştirir, sahip notu ekler veya randevuyu yeni tarih/saate taşır.

"Cuma 14:00'teki Ayşe Hanım'ın randevusunu pazartesi 10:00'a ertele."
randevu_guncelle
Randevu ekle (tek veya uzun işlem)İşlem

Telefonla/yüz yüze alınan randevuyu takvime işler.

"Yarın 10:00'a Mehmet Demir için 2 saatlik implant randevusu ekle, telefonu 0532 111 22 33."
randevu_ekle

Takvim

Takvim doluluk durumuOkuma

Seçilen günler için çalışma saatlerine göre slotları döker: dolu (hasta adıyla), kapatılmış ve boş saatler.

"Önümüzdeki 5 iş günündeki boş saatlerimi göster."
takvim_durumu
Gün veya saat kapat / açİşlem

Online randevuya kapatılacak (veya yeniden açılacak) günü ya da saatleri ayarlar.

"Gelecek çarşamba 13:00 ve 14:00'ü kapat, cumartesiyi tamamen kapat."
takvim_kapat_ac

Yorumlar

Yorumları listeleOkuma

İşletmelere yapılan hasta yorumlarını puan, metin ve varsa mevcut yanıtla listeler.

"Yanıtlamadığım yorumları göster ve her birine kısa, nazik bir yanıt taslağı hazırla."
yorumlari_listele
Yoruma yanıt verİşlem

Bir yoruma işletme adına herkese açık yanıt yazar (varsa mevcut yanıtın yerine geçer) veya sil=true ile yanıtı kaldırır.

"Zehra Hanım'ın yorumuna teşekkür eden kısa bir yanıt yaz, onaylarsam gönder."
yoruma_yanit_ver

İletişim

Hastaya e-posta gönderİşlem

Randevu talebi bırakmış bir hastaya işletme adına markalı e-posta gönderir (hasta e-posta bırakmış olmalı).

"Yarın randevusu olan hastalara saatlerini hatırlatan kısa bir e-posta gönder."
hastaya_eposta_gonder

Genel

İşletmelerimOkuma

Hesaba bağlı onaylı işletmeleri listeler: kimlik, tür, ad, konum, Pro durumu, online randevu takviminin açık olup olmadığı, slot süresi ve herkese açık profil linki.

"Hangi işletmelerim bağlı, hangilerinde online randevu açık?"
isletmelerim

Nerelerde kullanabilirsiniz?

Claude (web, masaüstü, mobil)

Gün içinde sohbet eder gibi çalışın: "Bugün kaç randevum var, ilk boşluğum ne zaman?" Masaüstü uygulamasına yapılandırma dosyasıyla, web sürümüne özel bağlayıcı adresiyle eklenir.

Claude Code

Tek komutla eklenir. Toplu işler için idealdir: haftalık randevu raporu çıkarmak, geçmiş talepleri tabloya dökmek veya tatil günlerini topluca kapatmak gibi.

Cursor ve MCP destekli editörler

Kliniğinizin web sitesini geliştirirken takvim ve talep verisini doğrudan editörden görün; sitenize gömdüğünüz rezervasyon modülünü gerçek doluluğa göre test edin.

Otomasyon araçları

MCP istemci düğümü olan otomasyon platformlarında zamanlanmış akışlar kurun: her sabah 08:00'de günün randevu özetini e-postanıza ya da ekip sohbetinize gönderin.

Günlük kullanımdan örnekler

Sabah"Bugünkü randevularımı saat sırasıyla, telefon numaralarıyla listele. Yeni gelen talep var mı?"
Telefon geldiğinde"Perşembe 15:00 boş mu? Boşsa Selin Kaya için 2 saatlik kanal tedavisi randevusu ekle, telefonu 0532 000 00 00."
Plan değişince"Cuma 14:00'teki Ahmet Bey'in randevusunu pazartesi aynı saate taşı. Hasta bilgilendirilsin."
İzin / kongre"20–22 Ekim arasını online randevuya tamamen kapat."
Haftada bir"Yanıtlanmamış yorumları getir, her birine kısa ve nazik bir yanıt taslağı yaz. Onayladıklarımı yayınla."
Hatırlatma"Yarın randevusu olan ve e-posta bırakan hastalara saatlerini hatırlatan kibar bir e-posta gönder."

Kurulum

Sunucu adresi: https://www.hekimhane.com.tr/api/mcp. Kimlik doğrulama içinAuthorization: Bearer başlığı kullanılır. Paneldeki MCP Bağlantısı sekmesi bu kodları anahtarınız yerleşik olarak hazırlar. Aşağıda hkm_ANAHTARINIZ yazan yere anahtarınızı koyun.

ChatGPT

Ayarlar → Uygulamalar ve Bağlayıcılar → Gelişmiş → Geliştirici modu açın. Sonra Bağlayıcı oluştur: ad Hekimhane, MCP sunucu adresine aşağıdaki adresin tamamını (anahtar dahil) yapıştırın, Kimlik doğrulama: Yok (No authentication). Anahtarı sohbet penceresine yapıştırmayın; yalnızca bu adres alanına girin.

https://www.hekimhane.com.tr/api/mcp?key=hkm_ANAHTARINIZ

Claude Code

Terminalde bir kez çalıştırın. Sonra "hekimhane" araçları her oturumda hazırdır.

claude mcp add --transport http hekimhane https://www.hekimhane.com.tr/api/mcp --header "Authorization: Bearer hkm_ANAHTARINIZ"

Claude Masaüstü

Ayarlar → Geliştirici → Yapılandırmayı düzenle ile açılan claude_desktop_config.json dosyasına ekleyin, uygulamayı yeniden başlatın. Bilgisayarda Node.js kurulu olmalı.

{
  "mcpServers": {
    "hekimhane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.hekimhane.com.tr/api/mcp",
        "--header",
        "Authorization:${HEKIMHANE_AUTH}"
      ],
      "env": {
        "HEKIMHANE_AUTH": "Bearer hkm_ANAHTARINIZ"
      }
    }
  }
}

Cursor

Proje veya kullanıcı klasöründeki .cursor/mcp.json dosyasına ekleyin.

{
  "mcpServers": {
    "hekimhane": {
      "url": "https://www.hekimhane.com.tr/api/mcp",
      "headers": {
        "Authorization": "Bearer hkm_ANAHTARINIZ"
      }
    }
  }
}

URL ile (web / otomasyon)

Yalnızca bağlantı adresi isteyen istemciler için: claude.ai özel bağlayıcı, otomasyon araçlarının MCP düğümleri vb. Anahtar adresin içindedir, bu adresi kimseyle paylaşmayın.

https://www.hekimhane.com.tr/api/mcp?key=hkm_ANAHTARINIZ

Güvenlik ve gizlilik

  • Anahtarınız size özeldir. Yalnızca oluşturulduğu an bir kez gösterilir. Biz yalnızca şifrelenmiş özetini saklarız, açık halini kimse göremez.
  • Erişim yalnızca onaylı işletmelerinizle sınırlıdır. Başka işletmelerin verisine, hesap veya ödeme bilgilerinize erişilemez.
  • Panelle aynı yetki kuralları geçerlidir. Çakışma kontrolü, Pro kilitleri ve hastaya giden bilgilendirmeler panelde nasılsa MCP'de de öyledir.
  • Anında iptal. Panelden iptal ettiğiniz anahtarla gelen istekler hemen reddedilir. Anahtar başına dakikada 120 istek sınırı vardır.
  • Hasta verisi ve KVKK. Asistanınız bir sonucu okuduğunda veri o asistanın sağlayıcısına iletilir. Kurumsal veya veri işleme sözleşmeli plan kullanın, gereksiz hasta verisi sorgulamaktan kaçının.

Sık sorulan sorular

Ücretli mi?

MCP bağlantısı Hekimhane-Pro üyeliğine dahildir, ek ücret yoktur. Asistanınızın kendi aboneliği (ör. Claude) ayrıca kendi sağlayıcısına tabidir.

Asistan benden habersiz randevu iptal eder mi?

Veri değiştiren veya e-posta gönderen araçlar "işlem" olarak işaretlidir. Sunucumuz asistana bunlardan önce onayınızı almasını söyler. Claude gibi istemciler bu araçları çalıştırmadan önce size sorar. Otomatik onay ayarlarını açmamanızı öneririz.

Anahtarım başkasının eline geçerse?

Panel → MCP Bağlantısı'ndan anahtarı hemen iptal edin; o anahtarla gelen istekler anında reddedilir. Anahtar yalnızca sizin onaylı işletmelerinize erişir, hesap veya ödeme bilgilerinize erişmez.

Kapalı veya dolu saate randevu ekletebilir miyim?

Hayır. Panelle aynı kurallar geçerlidir: çalışma saati dışı, kapatılmış veya dolu saatler reddedilir ve asistan uygun saatleri görür.

Ücretsiz işletmelerim de görünür mü?

Hesabınızda en az bir Pro işletme varsa tüm onaylı işletmelerinizin talep ve yorumlarını yönetebilirsiniz. Gün veya saat kapatma yalnızca Pro işletmelerde çalışır, panelde olduğu gibi.

Hasta verileri nereye gidiyor?

Asistanınız bir aracı çalıştırdığında sonuç (ör. hasta adı ve telefonu) o asistanın sağlayıcısına iletilir. Kişisel sağlık verisi işlediğiniz için kurumsal veya veri işleme sözleşmeli bir plan kullanmanızı ve yalnızca gerekli sorguları yapmanızı öneririz.

Panele git ve bağlan