MCP-сервер MAQAMI Travel

Официальный MCP-сервер для MAQAMI — платформы бронирования отелей и авиабилетов с более чем 3 млн отелей. Ищите актуальные цены на отели и авиабилеты, находите города, аэропорты и сведения об отелях, а затем оформляйте предварительное и окончательное бронирование. Удалённая конечная точка с транспортом Streamable HTTP; API-ключ не требуется.

https://mcp.maqami.co/

Быстрый старт

Выберите клиент. Для подключения достаточно выполнить одну команду или добавить указанный адрес. Подробные инструкции приведены в разделе «Подключение».

Клиент	Самый быстрый способ подключения
Claude Code	`claude mcp add --transport http maqami-travel https://mcp.maqami.co/`
Claude Desktop и claude.ai	Настройки → Connectors → Add custom connector, URL `https://mcp.maqami.co/`, No sign in (инструкция)
Cursor	Добавьте `"maqami-travel": { "url": "https://mcp.maqami.co/" }` в `mcp.json` или воспользуйтесь ссылкой для установки в один клик
VS Code	`code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'`
Windsurf	Добавьте `"maqami-travel": { "serverUrl": "https://mcp.maqami.co/" }` в `mcp_config.json`
Gemini CLI	`gemini extensions install https://github.com/negm17111995/mcp-server`
OpenAI Codex	`codex mcp add maqami-travel --url https://mcp.maqami.co/`
ChatGPT	Developer mode → создайте приложение с URL `https://mcp.maqami.co/` и выберите No Authentication (инструкция)
OpenAI Agents SDK	`MCPServerStreamableHttp(name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"})`
LangChain	`MCPAdapter("https://mcp.maqami.co/")` из `langchain.mcp` (пример)
n8n	Узел MCP Client Tool, конечная точка `https://mcp.maqami.co/`, HTTP Streamable, без аутентификации (инструкция)
Cline	MCP Servers → Remote Servers, URL `https://mcp.maqami.co/`, Streamable HTTP
LM Studio	Добавьте `"maqami-travel": { "url": "https://mcp.maqami.co/" }` в `mcp.json` или воспользуйтесь ссылкой для установки
Любой другой клиент	Streamable HTTP по адресу `https://mcp.maqami.co/` без аутентификации или `npx -y maqami-travel` для клиентов, поддерживающих только stdio

Затем попробуйте запрос: «Найди отели категории 4 звезды в Лиссабоне для двух взрослых с 12 по 15 мая».

Содержание

Подключение
Как агенты используют сервер
Возможности
Примеры запросов
Часто задаваемые вопросы
Примеры
Конфиденциальность и безопасность
Разработка

Подключение

Сервер размещён по адресу https://mcp.maqami.co/ и использует транспорт Streamable HTTP. Ничего устанавливать и настраивать API-ключ не нужно.

Claude (claude.ai и Claude Desktop)

Добавьте MAQAMI как пользовательский коннектор:

Откройте Customize → Connectors.
Нажмите + Add, затем выберите Add custom connector.
Укажите имя MAQAMI Travel и URL https://mcp.maqami.co/, затем нажмите Continue.
В разделе Authentication выберите No sign in, затем нажмите Add.

В тарифных планах Team и Enterprise сначала владелец организации должен добавить коннектор в разделе Organization settings → Connectors.

Claude Code

claude mcp add --transport http maqami-travel https://mcp.maqami.co/

Также можно установить плагин. Он добавит сервер и навык бронирования, который поможет Claude последовательно выполнить поиск, предварительное бронирование, подтверждение и окончательное бронирование:

/plugin marketplace add negm17111995/mcp-server
/plugin install maqami-travel@maqami

Cursor

Добавьте конфигурацию в ~/.cursor/mcp.json (глобальные настройки) или .cursor/mcp.json (настройки проекта):

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

Или установите сервер в один клик: откройте эту ссылку в браузере:

cursor://anysphere.cursor-deeplink/mcp/install?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0=

VS Code

Добавьте конфигурацию в файл .vscode/mcp.json в рабочей области:

{
  "servers": {
    "maqami-travel": {
      "type": "http",
      "url": "https://mcp.maqami.co/"
    }
  }
}

Или добавьте сервер в профиль пользователя из командной строки:

code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'

Cline

В панели Cline откройте MCP Servers → Remote Servers, укажите URL https://mcp.maqami.co/ и выберите Streamable HTTP. Либо добавьте сервер в JSON-файл настроек MCP:

{
  "mcpServers": {
    "maqami-travel": {
      "type": "streamableHttp",
      "url": "https://mcp.maqami.co/"
    }
  }
}

LM Studio

Начиная с версии LM Studio 0.3.17 можно использовать MCP-серверы. Откройте вкладку Program на боковой панели справа, выберите Install → Edit mcp.json и добавьте:

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

Или установите сервер, открыв эту ссылку в браузере:

lmstudio://add_mcp?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0%3D

У локальных моделей меньшее контекстное окно, поэтому можно отключить ненужные инструменты (см. раздел с часто задаваемыми вопросами).

Windsurf

Откройте файл mcp_config.json через меню … на панели Cascade (Open MCP config file) и добавьте:

{
  "mcpServers": {
    "maqami-travel": {
      "serverUrl": "https://mcp.maqami.co/"
    }
  }
}

В актуальных версиях файл находится по пути ~/.config/devin/mcp_config.json (macOS и Linux) или %APPDATA%\devin\mcp_config.json (Windows). В более ранних версиях используется путь ~/.codeium/windsurf/mcp_config.json.

ChatGPT

Пользовательские MCP-приложения доступны в веб-версии для аккаунтов Plus, Pro, Business, Enterprise и Education.

Откройте Settings → Security and login и включите Developer mode.
Откройте Plugins, нажмите кнопку + и создайте приложение в режиме разработчика.
Укажите имя MAQAMI Travel и URL https://mcp.maqami.co/, затем выберите No Authentication.
В чате выберите Developer mode в меню +, а затем — MAQAMI Travel.

OpenAI Codex

codex mcp add maqami-travel --url https://mcp.maqami.co/

Или добавьте конфигурацию в ~/.codex/config.toml:

[mcp_servers.maqami-travel]
url = "https://mcp.maqami.co/"

Gemini CLI

Установите расширение, которое добавит сервер и файл с контекстом:

gemini extensions install https://github.com/negm17111995/mcp-server

Или добавьте только сервер:

gemini mcp add --transport http maqami-travel https://mcp.maqami.co/

Или добавьте конфигурацию в ~/.gemini/settings.json:

{
  "mcpServers": {
    "maqami-travel": {
      "httpUrl": "https://mcp.maqami.co/"
    }
  }
}

OpenAI Agents SDK (Python)

None: async with MCPServerStreamableHttp( name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"}, ) as maqami: agent = Agent(name="Travel assistant", mcp_servers=[maqami]) result = await Runner.run(agent, "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May.") print(result.final_output)

asyncio.run(main())">

import asyncio

from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main() -> None:
    async with MCPServerStreamableHttp(
        name="MAQAMI Travel",
        params={"url": "https://mcp.maqami.co/"},
    ) as maqami:
        agent = Agent(name="Travel assistant", mcp_servers=[maqami])
        result = await Runner.run(agent, "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May.")
        print(result.final_output)

asyncio.run(main())

LangChain (Python)

В LangChain 1.x предусмотрена поддержка MCP через langchain.mcp (бета-версия). Установите пакет командой pip install langchain langchain-openai:

None: async with MCPAdapter("https://mcp.maqami.co/") as maqami: tools = await maqami.list_tools() agent = create_agent("openai:gpt-5.4-mini", tools) result = await agent.ainvoke( {"messages": [{"role": "user", "content": "Which airports serve Tokyo?"}]} ) print(result["messages"][-1].content)

asyncio.run(main())">

import asyncio

from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main() -> None:
    async with MCPAdapter("https://mcp.maqami.co/") as maqami:
        tools = await maqami.list_tools()
        agent = create_agent("openai:gpt-5.4-mini", tools)
        result = await agent.ainvoke(
            {"messages": [{"role": "user", "content": "Which airports serve Tokyo?"}]}
        )
        print(result["messages"][-1].content)

Пример для LangChain, в котором перед предварительным или окончательным бронированием запрашивается подтверждение, см. в репозитории travel-agent-examples/langchain-python.

n8n

Добавьте в рабочий процесс узел AI Agent.
В разделе Tools добавьте узел MCP Client Tool.
Укажите конечную точку https://mcp.maqami.co/, выберите HTTP Streamable в качестве транспорта сервера (если эта настройка доступна в вашей версии n8n) и None для аутентификации.
В разделе Tools to Include выберите инструменты, необходимые для рабочего процесса, или оставьте вариант All.

Другие клиенты с поддержкой Streamable HTTP

Параметр	Значение
URL	`https://mcp.maqami.co/`
Транспорт	Streamable HTTP
Аутентификация	Не требуется

Локальный stdio (npm)

Для клиентов, которые поддерживают только stdio-серверы, npm-пакет maqami-travel служит лёгким мостом к удалённой конечной точке. Он не выполняет логику бронирования локально и не требует учётных данных. Требуется Node.js версии 18 или новее.

{
  "mcpServers": {
    "maqami-travel": {
      "command": "npx",
      "args": ["-y", "maqami-travel"]
    }
  }
}

Эта конфигурация работает с claude_desktop_config.json и любым другим клиентом, который запускает stdio-серверы.

Как агенты используют сервер

Сервер соответствует стандарту MCP. Для каждого инструмента определена JSON Schema входных данных и аннотации MCP, поэтому клиенты могут отличать инструменты только для чтения (readOnlyHint: true) от инструментов, которые что-либо изменяют.

Процесс бронирования отеля

Шаг	Что происходит	Инструмент (пример)
1. Поиск тарифов	Актуальные тарифы на выбранные даты и для указанного числа гостей. Необходимо указать `checkin`, `checkout`, `occupancies`, `currency`, `guestNationality` и одно поле с местоположением: `cityName` вместе с `countryCode`, `latitude` и `longitude`, `iataCode`, `hotelIds` или `aiSearch`. Поиск мест здесь недоступен; чтобы найти отели по названию, используйте `get_data_hotels` или `get_data_hotel_search`. Для каждого тарифа возвращается `offerId`.	`post_hotels_rates`
2. Просмотр сведений	Описание, удобства, фотографии и отзывы об отелях, которые заинтересовали пользователя	`get_data_hotel`, `get_data_reviews`
3. Подтверждение	Покажите пользователю отель, номер, даты, число гостей, цену и условия отмены, затем дождитесь однозначного согласия	(ваш агент)
4. Предварительное бронирование	Проверяет доступность одного `offerId`, переданного точно в том виде, в каком он был получен при поиске, и возвращает `prebookId`, окончательную цену, условия отмены и `checkoutUrl`	`post_rates_prebook`
5. Оплата	Передайте клиенту `checkoutUrl`, чтобы он указал данные гостей и оплатил бронирование на book.maqami.co. Оформить бронирование напрямую по `prebookId` может только клиент с собственной защищённой формой Stripe	`post_rates_book`

Процесс бронирования авиабилетов

Шаг	Что происходит	Инструмент (пример)
1. Поиск аэропортов	Определение кодов аэропортов IATA по городам	`get_data_flights_airports`
2. Поиск авиабилетов	Актуальные предложения. Необходимо указать `legs` (для каждого сегмента — `origin`, `destination` и `date`), `adults` и `currency`. Для перелёта в одну сторону укажите один сегмент, для перелёта туда и обратно — два.	`post_flights_rates`
3. Проверка	Проверяет, доступен ли ещё `offerId`, и возвращает актуальную цену, информацию о багаже и правила тарифа	`post_flights_verify`
4. Подтверждение	Покажите пользователю рейсы, пассажиров, окончательную цену и правила тарифа, затем дождитесь однозначного согласия	(ваш агент)
5. Предварительное бронирование	Запускает сеанс бронирования с контактными данными и сведениями о пассажирах и возвращает `prebookId`	`post_flights_prebooks`
6. Бронирование	Завершает бронирование по `prebookId` с использованием платёжных данных	`post_flights_bookings`

Названия инструментов и обязательные поля выше соответствуют опубликованным сервером данным на октябрь 2026 года. Список инструментов, полученный клиентом от сервера, всегда является источником истины: доступны только перечисленные в нём инструменты, а запросы к другим инструментам отклоняются.

Что сервер не поддерживает

Поиск мест (get_data_places, get_data_places_placeid) и инструменты индекса цен (getPriceIndexCity, getPriceIndexHotels, getPublicPrice).
Повторное бронирование (post_rates_rebook), бронирование туров (prebookExperienceTour, createExperienceBooking) и дополнительные услуги отеля (поле addons инструмента post_rates_prebook).
Переопределение цен, например с помощью margin: сервер удаляет такие поля из запросов.
offerId отелей подписываются сервером. Передавайте их без изменений: изменённый или заново сформированный offerId будет отклонён, поэтому выполните поиск ещё раз.

Часто задаваемые вопросы

Нужны ли для подключения API-ключ или учётная запись?

Нет. Сервер принимает подключения без аутентификации. Для бронирования потребуются данные гостя и платёжные данные.

Создаёт ли бронирование настоящую резервацию?

Да. Предварительное бронирование проверяет тариф, а бронирование создаёт резервацию. Перед подтверждением всегда проверяйте сведения и окончательную цену.

Какой транспорт использует сервер?

Streamable HTTP по адресу https://mcp.maqami.co/. Если ваш клиент поддерживает только stdio, используйте мост maqami-travel для npm.

Клиент предупреждает, что инструментов слишком много. Что делать?

Включите только необходимые инструменты. Большинство клиентов позволяют это сделать: выберите инструменты в VS Code, включите нужные переключатели для отдельных инструментов в Cursor и Claude или воспользуйтесь разделом Tools to Include в n8n. Для туристического помощника подойдут инструменты поиска, просмотра сведений, предварительного бронирования и бронирования из таблиц выше.

Какие данные видит сервер?

MCP-сервер получает только вызовы инструментов и аргументы, которые отправляет ваш клиент. Остальная часть разговора ему не видна.

Где опубликован сервер?

В официальном MCP Registry под именем io.github.negm17111995/maqami-travel, а также на npm под именем maqami-travel. Этот репозиторий также является расширением для Gemini CLI (gemini-extension.json), плагином и маркетплейсом Claude Code (.claude-plugin/), плагином Codex (.codex-plugin/plugin.json) и пакетом Agent Plugins (plugin.json и mcp.json). В состав плагинов входит навык maqami-travel-booking.

Можно ли использовать сервер в собственном агенте или продукте?

Да, это общедоступная конечная точка. Следуйте приведённым выше рекомендациям по подтверждению действий. По вопросам сотрудничества обращайтесь по адресу info@maqami.co.

Как сообщить об ошибке или проблеме безопасности?

Сообщайте об ошибках и проблемах с настройкой клиента, создав обращение. О проблемах безопасности сообщайте в соответствии с инструкциями в SECURITY.md; не создавайте публичное обращение.

Примеры

В репозитории negm17111995/travel-agent-examples представлены небольшие готовые к запуску туристические помощники, которые подключаются к этому серверу с помощью OpenAI Agents SDK (Python), LangChain с LangGraph (Python) и Vercel AI SDK (TypeScript). Каждый из них запрашивает подтверждение перед вызовом предварительного бронирования или бронирования.

Возможности

Поиск отелей с актуальными тарифами и сведениями о доступности.
Поиск авиабилетов и сравнение тарифов.
Поиск городов и аэропортов, просмотр сведений об отелях, включая удобства и фотографии.
Предварительное бронирование тарифа на отель или авиабилет для проверки цены и доступности.
Бронирование тарифа после предварительного бронирования. Оно создаёт реальную резервацию и требует данных гостя и платёжных данных.

Примеры запросов

«Найди пятизвёздочные отели в Стамбуле с 15 по 17 августа для двух взрослых».
«Покажи удобства и фотографии второго отеля».
«Найди авиабилеты из Дубая в Лондон на 10 декабря для одного взрослого».
«Какие аэропорты обслуживают Токио?»
«Забронируй этот номер предварительно и сообщи окончательную цену до оформления бронирования».

Конфиденциальность и безопасность

Для подключения не нужны API-ключ или учётная запись.
Весь трафик к https://mcp.maqami.co/ передаётся по зашифрованному HTTPS-соединению.
Поиск и бронирование обрабатывает MAQAMI. Данные гостя и платёжные данные, предоставленные для бронирования, обрабатываются в соответствии с политиками, опубликованными на maqami.co.
Бронирование создаёт реальную резервацию. Перед подтверждением проверьте сведения и окончательную цену.
Политика конфиденциальности: maqami.co/privacy-policy

Разработка

В репозитории находится stdio-мост для npm (index.js). Размещённый сервер развёртывается отдельно.

npm install
npm test

Тесты запускают локальный имитационный Streamable HTTP-сервер и направляют на него мост с помощью переменной окружения MAQAMI_MCP_URL. Эта переменная используется только для тестирования; по умолчанию мост подключается к https://mcp.maqami.co/.

Структура репозитория

Файл	Назначение
`index.js`	stdio-мост для npm, подключающийся к размещённой конечной точке
`server.json`	Запись в официальном MCP Registry
`gemini-extension.json`, `GEMINI.md`	Расширение Gemini CLI и файл контекста для него
`.claude-plugin/plugin.json`, `.mcp.json`	Плагин Claude Code
`.claude-plugin/marketplace.json`	Маркетплейс плагинов Claude Code (`maqami`)
`.codex-plugin/plugin.json`, `assets/logo-512.png`	Плагин Codex и его значок
`plugin.json`, `mcp.json`	Манифест Agent Plugins
`skills/maqami-travel-booking/SKILL.md`	Навык бронирования, входящий в состав плагинов
`glama.json`	Метаданные каталога Glama
`AGENTS.md`, `llms.txt`	Краткие руководства для агентов-разработчиков и инструментов LLM

Участие в проекте

Будем рады исправлениям документации, инструкциям по настройке клиентов и сообщениям об ошибках. Ознакомьтесь с руководством для участников и кодексом поведения. Вопросы и идеи можно обсудить в разделе Обсуждения.

Лицензия

MIT

Поддержка

Если у вас есть вопросы или возникли проблемы, напишите на info@maqami.co или создайте обращение.