İçeriğe geç
HotelByte
MCP · Model Context Protocol

Tek MCP entegrasyonu.
Tüm tedarikçiler.

Yapay zekâ ajanları için birleşik dağıtım arayüzü: arama, canlı fiyatlar ve iki aşamalı onaylı rezervasyon — kendi kanıtını taşıyan fiyat teklifleri ve sizin yapılandırdığınız fiyatlandırma kurallarıyla.

Erişim talep edinGitHub

Yeni entegrasyon vergisi

Otel tedarikçileri tek tek kendi MCP'lerini çıkarıyor. Her entegrasyon yeni bir hesap, yeni bir ID alanı, yeni bir fiyatlandırma kara kutusu demek — ajanınız aynı altyapıyı her tedarikçi için yeniden kuruyor, sonu gelmeden.

supplier-MCP × N → N × (auth + ids + pricing + ops)
HotelByte

Bir kez birleştirin

Tüm tedarikçi bağlayıcıları (Dida, Tourmind, Yalago, Hotelbeds, ...) tek bir MCP araç setinin arkasında çalışır. Bir tedarikçi yarın kendi MCP'sini çıkardığında bu, bizim için yeni bir upstream kanalı olur — sizin için yeni bir entegrasyon değil.

your-agent → /mcp → tüm tedarikçiler

Üç giriş yolu

Aynı araç seti, aynı sözleşme — ajanınızın çalıştığı ortama uyan yolu seçin.

Yerel ağ geçidi

Kontrolünüzdeki makineler (Claude Code / Cursor / Codex): hbcli yerel bir stdio ağ geçidi çalıştırır; anahtar yerel kimlik bilgisi deposunda kalır ve ajan yapılandırmalarında hiçbir gizli bilgi bulunmaz.

{ "mcpServers": { "hotelbyte":
  { "command": "hbcli", "args": ["mcp", "serve"] } } }

Statik anahtar

Barındırılan platformlar ve CI: uzun süre boşta kalabilen statik bir anahtar oluşturun (yalnızca 30 gün kullanılmadığında geçersiz olur; mutlak ömrü sunucu tarafında 365 günle sınırlıdır) ve doğrudan yapılandırmaya ekleyin.

$ hbcli mcp token
{ "type": "http", "url": "https://…/mcp",
  "headers": { "Authorization": "Bearer <token>" } }

OAuth 2.1 platform bağlayıcıları

Claude web / ChatGPT bağlayıcıları: standart RFC 9728/8414 keşfi, dinamik kayıt ve PKCE. Onay sayfası bizim tarafımızda barındırılır; token bir platform JWT'sidir.

GET /.well-known/oauth-protected-resource
→ 401 WWW-Authenticate: resource_metadata=…

Ajanınızı bir dakikada bağlayın

Her kart tek bir komutla başlar — hbcli mcp setup <client> — bu komut yapılandırmayı yazar (ya da token'ınızı ve yapıştırmanız gereken alanları birebir yazdırır) ve bağlantıyı doğrular. Yazma araçları yine de açık onay gerektirir.

Kayıt gerekmez — hemen deneyin

hbcli mcp setup <client> --demo şu anda çalışıyor — ortak sandbox kimliği CLI'ya gömülüdür; hesap ya da kimlik bilgisi gerekmez. Saniyeler içinde gerçek otelleri arayın; daha fazlasına ihtiyaç duyduğunuzda istediğiniz zaman kendi kiracınıza geçin.

Kendi kiracınızla bağlanın

Portala kaydolun, API kimlik bilgilerini oluşturun, ardından hbcli auth set-credentials && hbcli mcp setup komutunu çalıştırın — sizin tedarikçi kurallarınız, sizin kâr marjınız, sizin müşterileriniz. Bir kullanıcı iki kimliği birlikte kullanabilir.

Claude CodeCLI

Tek satırla uzak HTTP bağlantısı; ya da anahtarların ağa çıkmaması için yerel stdio ağ geçidi.

hbcli mcp setup claude-code
# runs: claude mcp add hotelbyte --scope user -- hbcli mcp serve
# (no claude on PATH? prints a paste-ready snippet instead)
CursorIDE

Genel olarak ~/.cursor/mcp.json ya da proje bazında .cursor/mcp.json.

hbcli mcp setup cursor
# merges hotelbyte into ~/.cursor/mcp.json
# (your other MCP servers are preserved)
ChatGPTConnector

Özel eklenti (geliştirici modu): MCP URL'si + API anahtarıyla kimlik doğrulama — OAuth değil API anahtarını seçin, aksi halde oluşturma işlemi bağlantı testinde başarısız olur.

hbcli mcp setup chatgpt
# prints your token + the exact form fields:
#   Server URL:     https://api-test.hotelbyte.com/mcp
#   Authentication: API key   ← NOT OAuth
#   Header: Authorization · Value: Bearer <token>
GrokConnector · xAI

Grok bağlayıcıları — grok.com üzerinde özel MCP sunucusu, web ve mobilde.

hbcli mcp setup grok
# writes [mcp_servers.hotelbyte] into ~/.grok/config.toml
# web/mobile connectors instead: grok.com/connectors → Custom
#   (hbcli mcp setup generic prints a token for it)
CodexCLI

~/.codex/config.toml — stdio ağ geçidi.

hbcli mcp setup codex
# appends [mcp_servers.hotelbyte] to ~/.codex/config.toml
AntigravityIDE · Google

Google'ın ajan öncelikli IDE'si (I/O 2026'da 2.0) — yerleşik MCP, tarayıcı kontrolü, ajan yöneticisi.

hbcli mcp setup generic   # token + fields, then paste into mcp_config.json
{ "mcpServers": { "hotelbyte":
  { "command": "hbcli", "args": ["mcp", "serve"] } } }
# note: no "type" field in Antigravity configs
Devin DesktopAgent · Cognition

Cognition'ın otonom ajan masaüstü uygulaması — eski adıyla Windsurf (Haziran 2026).

hbcli mcp setup generic   # token + URL
# Devin → Settings → MCP Marketplace → Add Your Own → paste
# (needs the Manage MCP Servers permission)
Claude Desktop · WebConnectors

Ayarlar → Uzantılar / Bağlayıcılar → Özel bağlayıcı ekle: uç nokta URL'sini yapıştırın, kimlik doğrulama = Bearer. Dizin tipi platform bağlayıcıları yukarıdaki OAuth 2.1 keşif akışını kullanır.

hbcli mcp setup claude-connectors
# prints your token, then:
#   Add custom connector → paste URL → auth: Bearer <token>
# order.book / order.cancel always require confirm=true
VS Code · CopilotIDE

Çalışma alanındaki .vscode/mcp.json (stdio türü).

hbcli mcp setup vscode
# writes .vscode/mcp.json in the current folder (servers key)
Herhangi bir ajan · kendi geliştirdiğinizJSON-RPC

SDK gerekmez: streamable-http üzerinden MCP, üç JSON-RPC çağrısından ibarettir. Her dil, framework ve çalışma ortamında çalışır — kendi geliştirdiğiniz ajanlar dahil. Resmî SDK'lar (Python mcp, TypeScript @modelcontextprotocol/sdk) aynı URL'yi kullanır.

POST https://api-test.hotelbyte.com/mcp
Authorization: Bearer <token> · Accept: application/json, text/event-stream

# 1) initialize — protocol version + client info
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
  "protocolVersion":"2025-06-18","capabilities":{},
  "clientInfo":{"name":"my-agent","version":"1.0"}}}

# 2) tools/list — discover the tools and their schemas
{"jsonrpc":"2.0","id":2,"method":"tools/list"}

# 3) tools/call — search hotels in Dubai for two adults
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
  "name":"hotel.list","arguments":{
    "destinationName":"Dubai","checkIn":"2026-11-20","checkOut":"2026-11-22",
    "rooms":[{"adultCount":2}]}}}

Her sonuç { response, evidence } döndürür — mutabakat için traceId'yi saklayın. order.book önce check_avail ve confirm=true gerektirir; yeniden denemelerde aynı customerReferenceNo kullanılır.

Token kaynağı: hbcli mcp token (statik anahtar, 30 gün kullanılmayınca geçersiz olur) ya da portalın verdiği herhangi bir ticket. Buraya asla tedarikçi kimlik bilgilerini yapıştırmayın — token, HotelByte kimliğinizdir.

Araç seti

Araçlar işlemin tamamını kapsar. Yazma araçları yalnızca bir kurulum bunları etkinleştirdiğinde vardır — ve açık onay olmadan asla çalışmaz.

hotel.listokumaOtel arayın; akışın tamamında kullanılan sessionId'yi döndürür
hotel.ratesokumaOda tipleri ve canlı fiyatlar; iade edilebilirlik ve iptal ücretleriyle birlikte
hotel.check_availokumaİki aşamanın ilki: rezervasyondan önce müsaitliği ve fiyatı yeniden doğrulayın
order.queryokumaRezervasyon durumu ve onay numarası sorgulama
order.bookyazma · onayconfirm=true gerektirir; customerReferenceNo idempotency anahtarıdır
order.cancelyazma · onayconfirm=true gerektirir; iptal ücretli ve geri alınamaz olabilir

Kanıt taşıyan fiyat teklifleri

Her araç sonucu { response, evidence } döndürür. response, HTTP API ile birebir aynıdır; kanıt zarfı her teklifi alıntılanabilir ve izlenebilir kılar — traceId'yi destek ekibine iletin, o teklifin aynısını yeniden oluşturabilsinler.

{
  "response": { "list": [ … ] },
  "evidence": {
    "tool": "hotel.list",
    "traceId": "20261003…",
    "sessionId": "S-2026…",
    "currency": "USD"
  }
}

Kesin onay sınırı olan rezervasyonlar

  1. hotel.rates — fiyatı, iade edilebilirliği ve iptal ücretlerini kullanıcıya gösterin.
  2. hotel.check_avail — tam fiyatı yeniden doğrulayın; canlı fiyatlar değişebilir.
  3. confirm=true ile order.book — yalnızca kullanıcı onay verdikten sonra. Bunun dışındaki her çağrı, sipariş akışı başlamadan sunucu tarafında reddedilir.
  4. Yeniden denemelerde aynı customerReferenceNo kullanılır — anahtara göre idempotent; mükerrer talepler, onaylamanız gereken yumuşak bir uyarı olarak görünür.

Sandbox'ı hemen deneyin

UAT · no SLA

Sandbox uç noktası herkese açıktır. Herhangi bir MCP istemcisi geçerli bir ticket ile bu uç noktada başlatma yapabilir:

curl -X POST https://api-test.hotelbyte.com/mcp \
  -H "Authorization: Bearer <ticket>" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Satın alma perspektifi

Bir yapay zekâ dağıtım arayüzünü değerlendirirken nelere bakmalı

Satıcıdan bağımsız. Üç soru, bir birleştirme katmanını tek envanterli başka bir MCP'den ayırır — ve her birini anında nasıl kanıtlayacağınızı gösterir.

What to check

Is this yet another single-inventory supplier MCP

What we do

No. We are the aggregation layer: every supplier connector sits behind one tool surface, and every new supplier MCP is just another upstream lane for us.

How to verify

Run hotel.list for one destinationName and check whether results span multiple suppliers with a true minimum price.

What to check

Can the agent accidentally fire a real booking

What we do

No. order.book requires confirm=true (after the user consents to the exact price, dates and cancellation policy); missing or false confirm is rejected server-side before the order flow starts.

How to verify

Call order.book without confirm and check for an explicit rejection and zero side effects.

What to check

How transparent is pricing

What we do

Every quote carries an evidence envelope (traceId / sessionId / currency / time) that is citable and traceable; cost and markup composition opens in tiers via configurable rules, not a black box.

How to verify

Take the traceId from a response and ask the vendor to reconstruct the full chain of that one quote.