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/mcp

    Kaynak: 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/mcp

    Kaynak: 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.

  1. search_umrah_packages

    Umre 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, meta

    Fiyatlar 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"
        }
      }
    }
  2. get_umrah_package

    Umre 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, meta

    Otel 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"
        }
      }
    }
  3. compare_umrah_packages

    Umre 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[], meta

    Hareket ş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"
        }
      }
    }
  4. 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"
        }
      }
    }
  5. 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ı

JSON API uç noktaları
YöntemYolAçıklama
GET/api/v1/umrah/packagesProgramları 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/metadataFiltreler, 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ı)
  1. Fiyatlar kaynak liste fiyatlarıdır (USD). Kaynakta hareket noktası belirtilmemiştir; fiyatlar İstanbul veya Londra çıkışı için doğrulanmamıştır.
  2. İstanbul ve Londra çıkışlı program ve fiyat bilgisi için iletişime geçiniz.
  3. Fiyatların kişi başı olup olmadığı ve dahil hizmetler kaynakta belirtilmemiştir.
  4. departureDateStatus değeri 'to-confirm' olan programların tarihi kesinleşmemiştir.
  5. Örnek tur programları kesinleşmiş günlük plan veya uçuş planı değildir.
  6. Otel adları kaynakta örnek olarak (vb.) verilmiştir.

07 · Güvenlik ve kullanım kuralları

Sınırlar ve sorumlu kullanım

  1. Tüm araçlar ve uç noktalar salt okunurdur; araçlar MCP’de readOnlyHint ile işaretlidir.

  2. İ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.

  3. MCP istek gövdesi en çok 64 KB olabilir (aşılırsa 413).

  4. Sunucu kişisel veri istemez; API/MCP logları IP adresi veya istek gövdesi içermez.

  5. 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.

  6. 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.

Gün batımında Thames Nehri, Westminster Köprüsü, Parlamento binası ve Big Ben.

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.