Geliştiriciler için
Yapay Zekâ Entegrasyonları
Hacumre.co.uk Umre programları için salt okunur API ve MCP erişimi.
- 5MCP aracı
- 4JSON uç noktası
- 20Umre programı
- Adres
- https://hacumre.co.uk/mcp
- Taşıma
- Streamable HTTP (yalnızca POST; JSON yanıt; oturumsuz)
- Kimlik doğrulama
- Yok (herkese açık, salt okunur)
- Protokol sürümleri
- 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07
01 · Genel bakış
Salt okunur, doğrulanabilir veri
Yayımladığımız 2026–2027 Umre programlarını yapay zekâ asistanlarının ve entegrasyonların doğru aktarabilmesi için iki salt okunur erişim yolu sunuyoruz: Model Context Protocol (MCP) sunucusu ve JSON API. İkisi de aynı veriyi, aynı uyarılarla döndürür.
Bu uç noktalar bilgilendirme amaçlıdır. Rezervasyon oluşturmaz, ödeme almaz, müşteri verisi istemez veya saklamaz. Kimlik doğrulama gerekmez.
Ziyaretçiler için program sayfaları: 2026–2027 Umre programları.
02 · MCP bağlantısı
Model Context Protocol sunucusu
MCP istemcinize aşağıdaki adresi uzak (remote) sunucu olarak ekleyin.
https://hacumre.co.uk/mcp- Otomatik keşif yoktur: MCP adresini kullandığınız istemciye elle eklemeniz gerekir. İstemcilerin bağlantı ekranları, plan ve yönetici izinleri farklıdır; güncel yöntem için istemcinizin resmî belgelerine bakın.
- GET ve DELETE istekleri 405 döner (sunucu olay akışı veya oturum kullanmaz).
- Tarayıcıdan gelen ve Origin başlığı taşıyan istekler varsayılan olarak reddedilir (403); sunucudan sunucuya bağlanan istemciler etkilenmez.
Örnek istek (JSON-RPC, POST)
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Başlıklar: Content-Type: application/json, Accept: application/json, text/event-stream, MCP-Protocol-Version.
İstemcilere göre bağlantı
Her istemcinin yöntemi farklıdır ve değişebilir; aşağıdaki notlar her platformun resmî belgelerine dayanır; güncel adımlar için platformun kendi yardım sayfasına bakın.
Claude (claude.ai, masaüstü)
Customize → Connectors → Add → Add custom connector; adresi girin, kimlik doğrulama: “No sign in”. Team/Enterprise planlarında bağlayıcıyı kuruluş yöneticisi ekler; Free planda tek özel bağlayıcı sınırı vardır.
Kaynak: Claude Yardım Merkezi
Claude Code
Terminalden HTTP taşımasıyla ekleyin:
claude mcp add --transport http hacumre https://hacumre.co.uk/mcpKaynak: Claude Code belgeleri
ChatGPT
Plugins bölümünde “Add custom MCP server” ile adresi girin, kimlik doğrulama: “No authentication”. Hangi planlarda ve hangi izinlerle kullanılabildiği hesabınıza ve çalışma alanı yöneticisine bağlıdır; OpenAI’nin güncel belgelerini kontrol edin.
Kaynak: OpenAI geliştirici belgeleri
Gemini (gemini.google.com)
Settings → Connected Apps → Custom apps → Add a custom app; MCP adresini girin. Google’a göre şu anda yalnızca ABD’de, 18 yaş üstü, kişisel hesap ve İngilizce arayüzle; ekleme yalnızca web uygulamasından yapılır.
Kaynak: Gemini Yardım Merkezi
Gemini CLI
Terminalden HTTP taşımasıyla ekleyin (Google’a göre ücretsiz katman ve Google One kullanıcılarında Gemini CLI’nin yerini Antigravity CLI almıştır):
gemini mcp add --transport http hacumre https://hacumre.co.uk/mcpKaynak: Gemini CLI belgeleri
Cursor
~/.cursor/mcp.json (genel) veya .cursor/mcp.json (proje):
{ "mcpServers": { "hacumre": { "url": "https://hacumre.co.uk/mcp" } } }Kaynak: Cursor belgeleri
VS Code (GitHub Copilot)
Komut paletinden “MCP: Add Server” → HTTP seçin ve adresi girin. Yapay zekâ özellikleri ve kuruluş politikaları MCP erişimini kısıtlayabilir.
Kaynak: VS Code belgeleri
03 · Kullanılabilir araçlar
Beş salt okunur araç
Araç adları ve parametreler sunucunun gerçek şemasıyla aynıdır. Hiçbir araç rezervasyon, ödeme veya veri toplama yapmaz.
search_umrah_packagesUmre paketlerini ara
20 yayımlanmış programı süre, ay, tür, oda tipi ve USD fiyat aralığına göre filtreler, sıralar ve sayfalar.
Girdi parametreleri
departureCity- Istanbul | London — bu şehirler için fiyat doğrulanmadığından minPrice/maxPrice ile birlikte sonuç dönmez
durationDays- tam sayı (1–365)
month- YYYY-MM — tarihi kesinleşmemiş programlar hariç tutulur ve sayısı bildirilir
packageType- servisli | yakin | bes-yildiz | ramazan
roomType- double | triple | quad — fiyat filtresi ve sıralamada hangi oda fiyatının kullanılacağı
minPrice- sayı ≥ 0 (USD liste fiyatı)
maxPrice- sayı ≥ 0 (USD liste fiyatı)
sort- price-asc | price-desc | duration-asc | duration-desc
limit- tam sayı (1–50)
offset- tam sayı (0–10000)
Çıktı
total, count, offset, limit, items[], notes[], excluded, metaFiyatlar kaynak liste fiyatlarıdır; şehre özgü fiyat döndürmez.
Örnek çağrı
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search_umrah_packages", "arguments": { "durationDays": 14, "roomType": "triple", "sort": "price-asc" } } }get_umrah_packageUmre paketi ayrıntısı
Tek programın tarihi, oda fiyatları, hareket şehri durumu, örnek oteller, Medine geceleri, konaklama açıklaması ve örnek program kimliği.
Girdi parametreleri
slug- ör. "6-14-gunluk-servisli-umre"
id- ör. "umre-06"
slug veya id’den tam olarak biri verilmelidir.
Çıktı
package, metaOtel adları örnektir; tarihi teyit aşamasındaki programlarda departureDate null döner.
Örnek çağrı
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_umrah_package", "arguments": { "slug": "6-14-gunluk-servisli-umre" } } }compare_umrah_packagesUmre paketlerini karşılaştır
2–5 programı yalnızca USD liste fiyatlarıyla yan yana karşılaştırır; oda tipine göre ve genel olarak en uygun programı bildirir.
Girdi parametreleri
packageszorunlu- 2–5 öğelik dizi (slug veya id)
roomType- double | triple | quad (isteğe bağlı)
Çıktı
currency, priceBasis, rows[], cheapestByRoom, cheapest, notes[], metaHareket şehrine göre fiyat karşılaştırması yapılmaz.
Örnek çağrı
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "compare_umrah_packages", "arguments": { "packages": [ "umre-06", "umre-02" ], "roomType": "quad" } } }get_umrah_itineraryÖrnek günlük tur programı
8, 10, 14 ve 20 günlük programlar için ÖRNEK günlük akış. 13, 44 ve 61 günlük programlar için örnek program yoktur (not_found).
Girdi parametreleri
id- "ornek-8-gun" | "ornek-10-gun" | "ornek-14-gun" | "ornek-20-gun"
packageSlug- paket kısa adı
id veya packageSlug’dan tam olarak biri verilmelidir.
Çıktı
itinerary, metaÖrnek programlar kesinleşmiş günlük plan veya uçuş planı değildir.
Örnek çağrı
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_umrah_itinerary", "arguments": { "packageSlug": "6-14-gunluk-servisli-umre" } } }get_contact_optionsİletişim seçenekleri
Telefon numarasını ve isteğe bağlı olarak belirli bir program ve oda tipi için hazır Türkçe mesajlı WhatsApp (wa.me) bağlantısını döndürür.
Girdi parametreleri
packageSlug- paket kısa adı (isteğe bağlı)
roomType- double | triple | quad (isteğe bağlı)
Çıktı
brand, operator, phone, whatsapp, package, notes[]Yalnızca bağlantı üretir; mesaj göndermez, müşteri verisi toplamaz.
Örnek çağrı
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_contact_options", "arguments": { "packageSlug": "6-14-gunluk-servisli-umre", "roomType": "double" } } }
04 · JSON API
REST uç noktaları
| Yöntem | Yol | Açıklama |
|---|---|---|
| GET | /api/v1/umrah/packages | Programları ara ve listele (filtre, sıralama, sayfalama) |
| GET | /api/v1/umrah/packages/{slug} | Tek program ayrıntısı |
| GET | /api/v1/umrah/itineraries/{id} | Örnek günlük tur programı |
| GET | /api/v1/umrah/metadata | Filtreler, sözlükler ve uç nokta listesi |
Örnek
curl "https://hacumre.co.uk/api/v1/umrah/packages?durationDays=14&roomType=triple"- Yalnızca GET ve HEAD kabul edilir; diğer yöntemler 405 döner.
- Bilinmeyen veya yinelenen parametreler 400 (invalid_parameter) döner; hata gövdesi { error: { code, message, details } } biçimindedir.
- Yanıtlar 5 dakika önbelleğe alınabilir (Cache-Control: public, max-age=300).
05 · OpenAPI belgesi
OpenAPI 3.1 sözleşmesi
JSON API’nin makine tarafından okunabilir tanımı: https://hacumre.co.uk/openapi.json. Belge resmî OpenAPI 3.1 şemasına göre doğrulanır ve gerçek API yanıtlarıyla sözleşme testlerinden geçer. Kimlik doğrulama tanımlanmamıştır.
06 · Veri güncelliği ve sınırlamalar
Her yanıtla gelen kurallar
- Sezon
- 2026–2027
- Veri sürümü
- data-4323ddf85d8c
- Veri çıkarım tarihi
- 2026-11-16
- Para birimi
- USD (liste fiyatı)
- Fiyatlar kaynak liste fiyatlarıdır (USD). Kaynakta hareket noktası belirtilmemiştir; fiyatlar İstanbul veya Londra çıkışı için doğrulanmamıştır.
- İstanbul ve Londra çıkışlı program ve fiyat bilgisi için iletişime geçiniz.
- Fiyatların kişi başı olup olmadığı ve dahil hizmetler kaynakta belirtilmemiştir.
- departureDateStatus değeri 'to-confirm' olan programların tarihi kesinleşmemiştir.
- Örnek tur programları kesinleşmiş günlük plan veya uçuş planı değildir.
- Otel adları kaynakta örnek olarak (vb.) verilmiştir.
07 · Güvenlik ve kullanım kuralları
Sınırlar ve sorumlu kullanım
Tüm araçlar ve uç noktalar salt okunurdur; araçlar MCP’de readOnlyHint ile işaretlidir.
İstek sınırı (istemci IP başına, 60 saniyelik pencere): JSON API 120, MCP 60 istek. Aşıldığında 429 ve Retry-After döner.
MCP istek gövdesi en çok 64 KB olabilir (aşılırsa 413).
Sunucu kişisel veri istemez; API/MCP logları IP adresi veya istek gövdesi içermez.
Fiyatları yalnızca uç noktaların döndürdüğü şekilde aktarın; tahmin etmeyin. Hareket şehri, tarih teyidi ve örnek otel notlarını kullanıcıya iletin.
Uç noktalar önceden haber verilmeksizin değişebilir; veri sürümü her yanıtta meta.dataVersion alanındadır.
08 · Destek ve iletişim
Entegrasyon soruları
Entegrasyonla ilgili sorularınız için bize telefonla (+44 7495 597983) ya da WhatsApp’tan ulaşabilirsiniz.

Entegrasyon için bize ulaşın
MCP veya API erişimiyle ilgili sorularınız için WhatsApp’tan yazın ya da arayın.
hacumre.co.uk · VIAURBIS TRAVEL GROUP tarafından işletilmektedir.
