MCP sunucusu · ajanlara hazır
Nöbetinizi yapay zeka asistanınızdan yönetin
Oncallz artık Claude connector dizininde. Claude, Claude Code, Cursor veya herhangi bir MCP istemcisini OAuth girişi veya kişisel token ile bağlayın; neyin yandığını, kimin nöbetçi olduğunu sorun ya da bir olayı üstlenip not bırakmasını isteyin — mevcut yetkilerinizin ötesine geçmeden.
Barındırılır, kurulum yok
Streamable HTTP üzerinden tek bir uzak adres. Yerel süreç, paket ya da kendi sunucunuz gerekmez: istemcinize adresi ekleyip giriş yapın veya API token kullanın.
Sizin yetkiniz, fazlası değil
Her araç, mobil uygulamanın kullandığı REST API’yi sizin adınıza çağırır. Başka bir ekibin olayları görünmez kalır; müdahale eden biri daha önce yapamadığını yapamaz.
Gece 3 için tasarlandı
Durumu kontrol edin, olayın zaman çizelgesini ve yapay zeka analizini okuyun, üstlenin, yorumla devredin — hepsi zaten açık olan sohbetten.
İki dakikada bağlayın
Bir Oncallz hesabına ihtiyacınız var. Claude dizinindeki Oncallz sayfasını açın, bağlanın ve Oncallz’da erişimi onaylayın. Uyumlu istemcilere https://oncallz.com/mcp adresini doğrudan da ekleyebilirsiniz. Aşağıdaki manuel kurulum kişisel API token kullanır:
Claude dizininden Oncallz’a bağlanın
- 1 Profil → API token’ları sayfasında Tam erişimli bir token oluşturun. Bir son kullanma süresi seçin — 90 gün makul bir başlangıçtır. Token yalnızca bir kez gösterilir; kopyalayın.
- 2 Sunucuyu istemcinize ekleyin (aşağıda); YOUR_TOKEN yerine token’ı yapıştırın.
- 3 Bir şey sorun. “Durum ne?” iyi bir ilk sorudur.
Claude Code
claude mcp add --transport http oncallz https://oncallz.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Cursor ve mcp.json kullanan diğer istemciler
{
"mcpServers": {
"oncallz": {
"url": "https://oncallz.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Terminalden doğrulayın
curl -s https://oncallz.com/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Araç listesi dönmeli. 401 token’ın yanlış, süresi dolmuş ya da iptal edilmiş olduğunu; 403 token’ın yalnızca olay akışı için okuma token’ı olduğunu ve MCP’de kullanılamayacağını gösterir.
OAuth mevcut Oncallz girişinizi kullanır ve erişim için onay ister. Bağlantıyı profilinizden iptal edebilirsiniz. Yukarıdaki token örnekleri ve mobil REST API için mevcut yöntem desteklenmeye devam eder.
Asistanınız neler yapabilir
27 araç; her biri herkese açık API’nin bir uç noktasını saran ince bir katman.
Durum ve olaylar
get_status- Genel sağlık, önem derecesine göre açık olaylar, en yeniler ve nöbetçiler.
list_incidents- Duruma, ekibe veya sahipliğe göre süzün; aciliyete göre sıralayın.
get_incident- Zaman çizelgesi, ham alarm verisi, yapay zeka analizi ve ilişkili olaylar.
acknowledge_incident- Üstlenin; isteğe bağlı not zaman çizelgesine düşer.
resolve_incident- Kapatın; isteğe bağlı notla.
reopen_incident- Çözülmüş bir olayı yeniden açın.
comment_on_incident- Bulguları veya devir notunu ekibe bırakın.
Nöbet
whos_on_call- Şu an kim nöbetçi; geçici değişiklikler dahil.
get_on_call_calendar- Bir tarih aralığındaki vardiyalar, en fazla 92 gün.
list_teams- Üyesi olduğunuz ekipler.
whoami- Adınız, rolünüz, saat diliminiz ve yönetebildikleriniz.
Olay sonrası inceleme ve durum sayfası
list_post_mortems- Ekiplerinizdeki taslak ve yayınlanmış incelemeleri bulun.
list_owed_post_mortems- Hâlâ yayınlanmış inceleme bekleyen çözülmüş olayları bulun.
get_post_mortem_form- Düzenlenebilir alanları, olay verilerini ve aksiyon atanabilecek kişileri okuyun.
save_post_mortem- İncelemeyi ve aksiyon maddelerini oluşturun veya düzenleyin.
publish_post_mortem- İncelemeyi ekip içinde yayınlayın.
publish_post_mortem_publicly- Ayrı müşteri açıklamasını herkese açık bir sayfada yayınlayın.
unpublish_post_mortem_publicly- Herkese açık müşteri raporunu yayından kaldırın.
get_post_mortem- Bir olayın incelemesi ve aksiyon maddeleri.
list_post_mortem_follow_ups- Ekiplerinizde bekleyen olay sonrası işler.
list_my_action_items- Size atanan aksiyon maddeleri, vadesi yakın olandan başlayarak.
toggle_action_item- Bir aksiyon maddesini tamamlayın ya da geri alın.
get_status_page- Durum sayfası konsolu: bileşen durumu, çalışma süresi ve internal olanlar dahil duyurular.
get_status_statement- Bir durum sayfası incident’ı, güncelleme geçmişi ve görünürlüğü.
create_status_incident- Gerçek başlangıç ve bitiş saatleriyle geçmiş kesintiler dahil incident kaydedin.
post_status_update- Güncelleme paylaşın, durum sayfası incident’ını kapatın veya yeniden açın.
edit_status_incident- Bildirim göndermeden metni, kesinti saatlerini veya görünürlüğü düzeltin.
Sorabileceğiniz şeyler
- “Ödeme olayı için zaman çizelgesinden bir post-mortem taslağı hazırla, takip aksiyonlarını ekle ve yayınlama.”
- “Şu an bir şey yanıyor mu?”
- “Bu gece kim nöbetçi, gelecek hafta sonu kim?”
- “Açık kritik olayları ve yapay zekanın nedenini ne düşündüğünü özetle.”
- “Ödeme olayını üstlen ve geri alma yaptığımı not düş.”
- “Hangi olay sonrası aksiyonlarının vadesi geçti, hangileri benim?”
- “Müşteri durum sayfası şu an ne diyor?”
- “Dün API İstanbul saatine göre 10:15–10:45 arasında kesildi. Çözülmüş bir status page incident’ı oluştur; detayları internal, kesintiyi public tut ve abonelere bildirim gönderme.”
Güvenli tasarım
- API ile aynı yetkiler: ekip üyeliği ve roller, bir aracın neyi görüp değiştirebileceğini belirler. Başka bir ekibin olayı için başlık değil “izin yok” yanıtı döner.
- İşlemler olay zaman çizelgesinde “MCP assistant” olarak etiketlenir; kimin neyi üstlendiği belli olur.
- Durum sayfası araçları yetkilerinizle incident ve güncelleme yayınlayabilir. Kesinti durumu ile incident detaylarının görünürlüğü bağımsızdır; abone bildirimleri varsayılan olarak kapalıdır. Olay yükseltme, çizelge ve mesajlaşma ayarları uygulamada kalır.
- OAuth bağlantıları ve API token’ları profilinizden iptal edebilirsiniz. API token’lar süreli olabilir; MCP çağrıları hız sınırına tabidir.
- Araçlar salt okunur ya da değil olarak işaretlenir; istemciler veri değiştirenler için onay isteyebilir.
Yalnızca MCP’ye değil, ajanlara hazır
Ajanların nerede ne olduğunu tahmin etmesi gerekmemeli. Oncallz makine tarafından okunabilir yüzeyini ajanların baktığı yerlerde yayınlar:
-
MCP sunucu kartı
/.well-known/mcp/server-card.jsonSunucuları keşfeden istemciler için sunucu adı, sürüm, aktarım adresi ve kimlik doğrulama.
-
API kataloğu (RFC 9727)
/.well-known/api-catalogOpenAPI şemasına, dokümantasyona ve sağlık uç noktasına işaret eden bir linkset.
-
ARD yetenek bildirimi
/.well-known/ai-catalog.jsonMCP sunucusu ve REST API; ajan kayıt defterleri için örnek sorularla.
-
OpenAPI şeması
/docs/api.jsonAraçların sardığı REST API’nin makine tarafından okunabilir tanımı.
-
llms.txt
/llms.txtGenel sitenin dil modelleri için Markdown haritası.
-
İstenince Markdown
/Herhangi bir genel sayfaya Accept: text/markdown ile gidin, Markdown dönsün; tarayıcılar HTML almaya devam eder.
-
Link başlıkları (RFC 8288)
/Her genel sayfa kataloğu, şemayı ve dokümanları yanıt başlıklarında duyurur.
-
WebMCP
/Sayfalar, tarayıcıda çalışan ajanlar için list_site_pages ve open_site_page araçlarını kaydeder.
Sıkça sorulan sorular
Oncallz MCP sunucusu nedir?
oncallz.com/mcp adresinde barındırılan bir Model Context Protocol sunucusu.
Claude veya Cursor gibi bir yapay zeka asistanının Oncallz verilerinizi 27 araçla okuyup işlem yapmasını sağlar: durumu kontrol etmek, olaylarla ilgilenmek, kimin nöbetçi olduğunu görmek ve olay sonrası incelemeleri takip etmek. Sizin adınıza ve sizin yetkilerinizle çalışır.
Hangi istemcilerle çalışır?
Claude ve Cursor dahil uzak Streamable HTTP istemcileri OAuth ile bağlanabilir. Authorization başlığı destekleyen istemciler kişisel API token kullanmaya devam edebilir.
Asistan zarar verebilir mi?
Sizin yapabildiğinizi yapabilir: olayları üstlenmek, çözmek, yeniden açmak, yorum eklemek ve aksiyon maddelerini işaretlemek — fazlasını değil.
Yetkilerinizle post-mortem yazabilir, aksiyon maddelerini yönetebilir, incelemeyi ekip içinde yayınlayabilir ve ayrı müşteri raporunu herkese açıp yayından kaldırabilir. Yayınlama yetkiniz varsa geçmiş kesintiler dahil durum sayfası incident’ları oluşturup güncelleyebilir.
Bildirimler varsayılan olarak kapalıdır; görünürlük ayarlanabilir. Olay yükseltemez, nöbet çizelgelerini ya da ayarları değiştiremez. Süreli bir token kullanın ve profilinizden istediğiniz zaman iptal edin.
Ek ücreti var mı?
Hayır. MCP erişimi her pakete dahildir; kullanıcı başı fiyat Oncallz’ın geri kalanıyla aynıdır.
Olay verilerim bir yapay zeka sağlayıcısına gönderiliyor mu?
Oncallz verileri MCP istemcinize döndürür; sonrası bağladığınız asistana bağlıdır. Oncallz bu sunucu üzerinden kendiliğinden bir modele veri göndermez.
MCP olmadan API ile geliştirebilir miyim?
Evet. Aynı token, OpenAPI şemasıyla belgelenmiş REST API’ye karşı bearer token olarak çalışır. MCP, onun üstünde bir kolaylık katmanıdır.
İlgili sayfalar
- AI olay analizi Oncallz çağrıdan önce uyarıyı özetler, olası nedeni ve sonraki adımı önerir; isterseniz açık gürültüde telefon aramasını atlar. Kendi AI anahtarınızla.
- Olay sonrası inceleme Zaman çizelgesi ve aksiyon maddeleriyle suçlamasız olay sonrası incelemeler yazın, müşteriye açık olay raporunu tek tıkla yayımlayın.
- Nöbet çizelgesi Günlük, haftalık veya özel nöbet rotasyonları; otomatik devir ve geçici değişikliklerle her uyarı o an nöbette olan kişiye ulaşır.
Asistanınıza bir nöbet düzeni verin
Ücretsiz başlayın, OAuth veya API token ile bağlanın.