{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Get started","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"get-started","__idx":0},"children":["Get started"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to configure the Claude desktop AI app to connect with Booking MCP server."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"third-part-client-configuration","__idx":1},"children":["Third part client configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start using MCP server, you need to configure a third-party AI application to connect with it first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, we suggest to configure the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.claude.com/"},"children":["Claude Desktop"]}," AI assistant."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"claude-desktop","__idx":2},"children":["Claude Desktop"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-remote"]}," bridge utility to configure Claude Desktop to connect to the Booking.com MCP server."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites","__idx":3},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your Booking bearer token ready from your Booking.com partnership account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Downloaded ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.claude.com/download"},"children":["Claude Desktop"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claude-desktop-configuration","__idx":4},"children":["Claude Desktop configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following instructions show how to configure Claude Desktop. Similar steps apply to other MCP-compatible apps like Windsurf and Cursor."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step-by-step instructions:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open Claude Desktop setup"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Developer"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Local MCP Servers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit config"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add the Booking.com MCP server configuration"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add this configuration using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.npmjs.com/package/mcp-remote"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-remote"]}]}," package:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"booking-accommodations\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://demandapi-mcp.booking.com/v1/mcp/YOUR_AFFILIATE_ID\",\n        \"--header\",\n        \"Authorization: Bearer YOUR_BEARER_TOKEN\"\n      ]\n    }\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Replace credentials"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_AFFILIATE_ID"]}," with your affiliate ID in the URL path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_BEARER_TOKEN"]}," with your bearer token."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save and restart"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the configuration file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Restart Claude Desktop to load the new MCP server."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify the connection"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test the integration by asking Claude to search for accommodations. For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Search for accommodations in Paris, France. \nCheck-in date: November 14, 2025. \nCheck-out date: November 16, 2025. \n2 guests, 1 room. \nShow me options under $200 per night with free WiFi.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Claude will use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accommodations_search"]}," tool to query the Booking.com MCP server. You'll see:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Claude acknowledging it will search with your specifications."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An expandable \"Search Accommodations\" section showing the tool request parameters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Results displaying available accommodations matching your criteria."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/claude-desktop.de548c2120ffe5c2e93d26909bdc9d6dfa803441778dfb3911d33ff6b12c3f59.fbd405b5.png","alt":"Claude Desktop using the accommodations_search tool"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configuration notes:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp-remote"]}," package acts as a bridge between MCP clients and remote HTTP-based MCP servers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--header"]}," flag passes the required authentication header to the Booking.com MCP server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," bearer token header is required for authentication."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-resources","__idx":5},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Resources"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-server/docs/implementation-guide"},"children":["Boking MCP server implementation guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://modelcontextprotocol.io/"},"children":["MCP Protocol specification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.npmjs.com/package/mcp-remote"},"children":["mcp-remote npm package"]}]}]}]}]},"headings":[{"value":"Get started","id":"get-started","depth":1},{"value":"Third part client configuration","id":"third-part-client-configuration","depth":2},{"value":"Claude Desktop","id":"claude-desktop","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Claude Desktop configuration","id":"claude-desktop-configuration","depth":3},{"value":"Additional resources","id":"additional-resources","depth":2}],"frontmatter":{"seo":{"title":"Get started"}},"lastModified":"2026-07-10T14:10:46.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server/docs/get-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}