Pulsetic MCP Server

Pulsetic MCP Sunucusu

Yapay zeka asistanlarınızı Model Context Protocol (MCP) kullanarak Pulsetic izleme platformunuza bağlayın.

---

MCP Nedir?

Model Context Protocol, yapay zeka asistanlarının harici araçlar ve hizmetlerle etkileşime girmesini sağlayan açık bir standarttır. Pulsetic'in MCP sunucusu ile yapay zeka asistanınızdan monitör durumunu kontrol etmesini, olaylar oluşturmasını, bakım planlamasını ve daha fazlasını doğal konuşma yoluyla yapmasını isteyebilirsiniz.

Desteklenen istemciler:

• Claude Desktop — Anthropic'in masaüstü uygulaması
• Claude Code — Anthropic'in geliştiriciler için CLI aracı
• ChatGPT — OpenAI'ın yapay zeka asistanı (OAuth ile)
• Cursor — Yapay zeka destekli kod editörü
• Windsurf — Yapay zeka destekli IDE
• MCP spesifikasyonunu uygulayan herhangi bir istemci

---

Ön Koşullar

• API erişimi olan bir planda (Business veya Enterprise) Pulsetic hesabı.
• Bir Pulsetic API anahtarı — kontrol panelinizde Ayarlar → API bölümünden oluşturun.
• MCP uyumlu bir yapay zeka istemcisi.

---

Kurulum

Claude Desktop

Claude Desktop, stdio tabanlı MCP sunucularını kullanır. Uzak HTTP uç noktasına köprü kurmak için mcp-remote kullanın. Ayarlar → Geliştirici → Yapılandırmayı Düzenle yolunu izleyin ve şunu ekleyin:

{
  "mcpServers": {
    "pulsetic": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.pulsetic.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

YOUR_API_KEY kısmını gerçek API anahtarınızla değiştirin. Uygulamak için Claude Desktop'ı yeniden başlatın.

Claude Code

Sunucuyu projenizin .mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "pulsetic": {
      "type": "streamableHttp",
      "url": "https://api.pulsetic.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Ayarlar → MCP Sunucuları → Sunucu Ekle yolunu izleyin ve yapılandırın:

• Tür: streamableHttp
• URL: https://api.pulsetic.com/mcp
• Başlıklar: Authorization: YOUR_API_KEY

ChatGPT

ChatGPT, Geliştirici Modu aracılığıyla yerel MCP desteğine sahiptir. Pulsetic ile kimlik doğrulamak için OAuth kullanır.

Adım 1. ChatGPT'de Geliştirici Modunu etkinleştirin: Etkin uygulamalar → Gelişmiş ayarlar → Geliştirici modu yolunu izleyin ve açın. Bu özellik ChatGPT Pro, Plus, Team, Business, Enterprise ve Edu kullanıcıları için kullanılabilir.

Adım 2. Yeni bir uygulama oluşturun: Etkin uygulamalar → Uygulama oluştur yolunu izleyin.

Adım 3. Uygulama ayrıntılarını doldurun:

Alan	Değer
Ad	Pulsetic MCP (veya tercih ettiğiniz herhangi bir ad)
Açıklama	Uptime monitoring (isteğe bağlı)
MCP Sunucu URL'si	https://api.pulsetic.com/mcp
Kimlik Doğrulama	OAuth

Adım 4. OAuth uç noktaları sunucudan otomatik olarak keşfedilecektir. Bunları Gelişmiş ayarlar altından doğrulayabilirsiniz:

Alan	Değer
Auth URL	https://api.pulsetic.com/mcp/oauth/authorize
Token URL	https://api.pulsetic.com/mcp/oauth/token
Kayıt URL'si	https://api.pulsetic.com/mcp/oauth/register

Adım 5. "Anlıyorum ve devam etmek istiyorum" seçeneğini işaretleyin ve Oluştur'a tıklayın.

Adım 6. OAuth giriş akışını tamamlayın. Hesap e-postanızı ve API belirtecinizi gireceğiniz bir Pulsetic yetkilendirme sayfasına yönlendirileceksiniz.

E-posta, API belirtecinizle eşleşmelidir. Yetkilendirme sayfasında girdiğiniz e-posta, sağladığınız API belirtecinin sahibiyle eşleşmelidir.

API anahtarınızı gizli tutun. API anahtarınız Pulsetic hesabınıza tam erişime sahiptir. Asla sürüm kontrolüne eklemeyin veya herkese açık olarak paylaşmayın.

---

Kullanılabilir Araçlar

MCP sunucusu, dört kategoride düzenlenmiş 17 araç sunar.

Monitörler

Araç	Açıklama
list_monitors	Tüm monitörleri durum, çalışma süresi ve yanıt süresiyle listeler.
get_monitor	Belirli bir monitör hakkında ayrıntılı bilgi alır.
get_monitor_stats	1g/7g/30g/90g periyotlarında çalışma süresi %, kesinti ve yanıt süreleri.
get_monitor_events	Bir tarih aralığındaki çevrimiçi/çevrimdışı olayları.
get_monitor_downtime	Belirli bir dönem için saniye cinsinden toplam kesinti süresi.
create_monitor	Yeni bir HTTP, TCP veya ICMP monitörü oluşturur.
update_monitor	Bir monitörün adını, URL'sini, sıklığını veya ayarlarını günceller.
delete_monitor	Bir monitörü kalıcı olarak siler.
pause_monitor	İzlemeyi duraklatır (kontrolleri durdurur).
resume_monitor	Duraklatılmış bir monitörü devam ettirir.

Durum Sayfaları

Araç	Açıklama
list_status_pages	Tüm durum sayfalarını başlık, kısa ad ve alan adıyla listeler.

Olaylar

Araç	Açıklama
list_incidents	Bir durum sayfası için olayları listeler.
create_incident	İlk durum güncellemesiyle yeni bir olay oluşturur.
update_incident	Mevcut bir olaya durum güncellemesi gönderir.
resolve_incident	Bir olayı çözüldü olarak işaretler.

Bakım

Araç	Açıklama
create_maintenance	Bir durum sayfasında bakım penceresi planlar.
delete_maintenance	Planlanmış bir bakım penceresini siler.

---

Kullanım Örnekleri

Yapılandırıldıktan sonra, doğal dil aracılığıyla Pulsetic ile etkileşime girebilirsiniz.

Monitörlerinizi kontrol edin

"Show me all my monitors and their current status."

"What's the uptime for my production API monitor over the last 30 days?"

"Are any of my monitors currently down?"

"Show me the downtime events for monitor 42 in the past week."

Monitörleri yönetin

"Create a new monitor for https://api.example.com that checks every 30 seconds."

"Pause the staging monitor while we do the migration."

"Resume all paused monitors."

"Change the check frequency of monitor 15 to 60 seconds."

"Delete the old marketing-site monitor."

Olayları ele alın

"Create an incident on our main status page: 'Elevated API latency'
 with status investigating and message 'We're looking into slow response times.'"

"Update the API latency incident to identified: 'Root cause is a database
 connection pool issue. Working on a fix.'"

"Resolve incident 8 with message 'Connection pool limits increased.
 Response times back to normal.'"

Bakım planlayın

"Schedule a maintenance window on status page 1 called 'Database upgrade'
 starting 2025-03-20 at 2am UTC and ending at 4am UTC."

"Delete the maintenance window we scheduled for next week."

---

cURL ile Test Etme

API anahtarınızın çalıştığını doğrulamak için MCP uç noktasını doğrudan cURL ile test edebilirsiniz.

Başlatma

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

Araçları listeleme

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Bir aracı çağırma

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_monitors",
      "arguments": {}
    }
  }'

---

Araç Referansı

list_monitors

Hesabınızdaki tüm monitörleri döndürür.

Parametre yok.

---

get_monitor

SSL sertifika bilgileri dahil olmak üzere tek bir monitör için tam ayrıntıları döndürür.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.

---

get_monitor_stats

1 günlük, 7 günlük, 30 günlük ve 90 günlük periyotlarda çalışma süresi %, kesinti, olay sayısı ve ortalama yanıt süresini döndürür.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.

---

get_monitor_events

Bir tarih aralığındaki çevrimiçi/çevrimdışı olayları döndürür (maks 100, en yeni önce).

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.
from	string	Hayır	Başlangıç tarihi (YYYY-AA-GG). Varsayılan: 7 gün önce.
to	string	Hayır	Bitiş tarihi (YYYY-AA-GG). Varsayılan: bugün.

---

get_monitor_downtime

Bir dönem için saniye cinsinden toplam kesinti süresini ve olay sayısını döndürür.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.
days	integer	Hayır	Geriye bakılacak gün sayısı. Varsayılan: 30.

---

create_monitor

Yeni bir çalışma süresi monitörü oluşturur.

Parametre	Tür	Zorunlu	Açıklama
url	string	Evet	İzlenecek URL veya ana bilgisayar adı.
name	string	Hayır	Görünen ad.
request_type	string	Hayır	http, tcp veya icmp. Varsayılan: http.
uptime_check_frequency	integer	Hayır	Saniye cinsinden kontrol aralığı. Varsayılan: 60.
request_method	string	Hayır	HTTP metodu. Varsayılan: GET.
request_timeout	integer	Hayır	Saniye cinsinden zaman aşımı. Varsayılan: 30.
ssl_check	boolean	Hayır	SSL izlemeyi etkinleştir.

---

update_monitor

Mevcut bir monitörün ayarlarını günceller. Yalnızca değiştirmek istediğiniz alanları dahil edin.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.
name	string	Hayır	Yeni görünen ad.
url	string	Hayır	Yeni URL veya ana bilgisayar adı.
uptime_check_frequency	integer	Hayır	Saniye cinsinden yeni kontrol aralığı.
request_method	string	Hayır	HTTP metodu.
request_timeout	integer	Hayır	Saniye cinsinden zaman aşımı.
ssl_check	boolean	Hayır	SSL izlemeyi etkinleştir/devre dışı bırak.

---

delete_monitor

Bir monitörü ve ilişkili tüm verileri kalıcı olarak siler.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.

---

pause_monitor

Bir monitörü duraklatır. Devam ettirilene kadar kontrol edilmeyecektir.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.

---

resume_monitor

Duraklatılmış bir monitörü devam ettirir.

Parametre	Tür	Zorunlu	Açıklama
monitor_id	integer	Evet	Monitör ID'si.

---

list_status_pages

Hesabınızdaki tüm durum sayfalarını döndürür.

Parametre yok.

---

list_incidents

Her biri için en son güncelleme dahil olmak üzere bir durum sayfası için olayları döndürür.

Parametre	Tür	Zorunlu	Açıklama
status_page_id	integer	Evet	Durum sayfası ID'si.

---

create_incident

Durum sayfasında görünen bir ilk durum güncellemesiyle yeni bir olay oluşturur.

Parametre	Tür	Zorunlu	Açıklama
status_page_id	integer	Evet	Durum sayfası ID'si.
title	string	Evet	Olay başlığı.
status	string	Evet	investigating, identified, monitoring veya resolved.
message	string	Evet	İlk güncelleme mesajı.

---

update_incident

Mevcut bir olaya yeni bir durum güncellemesi gönderir.

Parametre	Tür	Zorunlu	Açıklama
incident_id	integer	Evet	Olay ID'si.
status	string	Evet	investigating, identified, monitoring veya resolved.
message	string	Evet	Güncelleme mesajı.
title	string	Hayır	Olay başlığını güncelle.

---

resolve_incident

Bir olayı çözüm mesajıyla çözüldü olarak işaretler.

Parametre	Tür	Zorunlu	Açıklama
incident_id	integer	Evet	Olay ID'si.
message	string	Evet	Çözüm mesajı.

---

create_maintenance

Bir durum sayfasında bakım penceresi planlar.

Parametre	Tür	Zorunlu	Açıklama
status_page_id	integer	Evet	Durum sayfası ID'si.
name	string	Evet	Bakım başlığı.
description	string	Hayır	Bakımın açıklaması.
start	string	Evet	ISO 8601 formatında başlangıç zamanı.
end	string	Evet	ISO 8601 formatında bitiş zamanı.
timezone	string	Hayır	Zaman dilimi (örn., UTC, America/New_York). Varsayılan: UTC.

---

delete_maintenance

Planlanmış bir bakım penceresini siler.

Parametre	Tür	Zorunlu	Açıklama
maintenance_id	integer	Evet	Bakım penceresi ID'si.

---

Sorun Giderme

401 Yetkisiz

• API anahtarınızın doğru olduğunu ve süresinin dolmadığını doğrulayın.
• Anahtarı Authorization başlığında (ham belirteç olarak veya Bearer önekiyle) ilettiğinizden emin olun.
• Hesabınızın API erişimi etkin bir planda olduğunu onaylayın.

OAuth yetkilendirmesi başarısız oluyor (ChatGPT)

• Yetkilendirme sayfasında girdiğiniz e-posta, API belirtecinin sahibiyle eşleşmelidir.
• ChatGPT ayarlarınızda Geliştirici Modunun etkin olduğundan emin olun.
• Geliştirici Modunu destekleyen bir ChatGPT planınız olduğundan emin olun (Pro, Plus, Team, Business, Enterprise veya Edu).

"Monitör bulunamadı veya erişim reddedildi"

• Monitör ID'si mevcut değil veya farklı bir hesaba ait.
• Mevcut monitör ID'lerinizi görmek için list_monitors kullanın.

Araçlar yapay zeka istemcinizde görünmüyor

• MCP yapılandırmasını düzenledikten sonra yapay zeka istemcisini yeniden başlatın.
• URL'nin tam olarak https://api.pulsetic.com/mcp olduğunu kontrol edin.
• Bağlantıyı doğrulamak için uç noktayı cURL ile test edin.

Protokol hataları alınıyor

• İsteklerin Content-Type: application/json kullandığından emin olun.
• jsonrpc alanı tam olarak "2.0" olmalıdır.
• Bildirimler hariç tüm isteklere bir id alanı (integer veya string) ekleyin.

---

API Referansı

MCP sunucusu, JSON-RPC 2.0 ile tek bir POST /mcp uç noktası üzerinden Streamable HTTP aktarımını kullanarak MCP spesifikasyonunu (2025-03-26) uygular.