GuruWalk Affiliates — MCP-сервер для Claude Code: туры и брони
Подключает каталог бесплатных пеших экскурсий GuruWalk к вашему агенту: поиск туров по городам, категориям и датам, ссылки на бронь с вашим партнёрским ref.
claude mcp add --transport http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliatesЧто делает GuruWalk Affiliates
Сервер отдаёт три инструмента. discover_destination ищет туры в городе и возвращает категории и подборку популярных экскурсий, browse_category раскрывает конкретную категорию по её id, а check_availability показывает ближайшие даты и время начала по id тура. Язык названий и описаний задаётся параметром language: en, es, de или it.
Работает по Streamable HTTP в stateless-режиме: каждый запрос независим, состояние между вызовами не хранится. В клиенте это надо выставить явно — stateless: true или аналог. Без ключа API любой запрос вернёт 401 Unauthorized, так что ключ нужен до первого запуска. Передавайте его в заголовке Authorization: Bearer <api_key> либо Api-Key: <api_key>.
Все поля url и booking_url в ответах уже содержат ?ref=<username> — брони, пришедшие через агента, засчитываются вашему аккаунту. Эти параметры не срезайте и не правьте, иначе атрибуция потеряется. Для подключения годится любая MCP-совместимая библиотека: mcp для Python или @modelcontextprotocol/sdk для TypeScript.
Какие задачи решает
- найти бесплатные пешие экскурсии в городе по названию
- показать туры внутри категории с рейтингом и обложками
- проверить, на какие даты есть свободные слоты у тура
- собрать ссылку на бронь с партнёрским
refдля клиента - встроить подбор экскурсий в разговор с туристическим ассистентом
Примеры запросов агенту
- Найди бесплатные экскурсии в Барселоне на английском и покажи категории
- Покажи все туры в категории с id 5
- Проверь, какие слоты есть у тура 101 с 10 по 12 июня
Как установить GuruWalk Affiliates
Командой платформы: удалённый сервер
claude mcp add --transport http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliatesКомандой платформы: удалённый сервер
codex mcp add guruwalk-affiliates --url https://back.guruwalk.com/mcp/affiliatesФайл настроек
{
"mcpServers": {
"guruwalk-affiliates": {
"url": "https://back.guruwalk.com/mcp/affiliates"
}
}
}Файл настроек
{
"servers": {
"guruwalk-affiliates": {
"type": "http",
"url": "https://back.guruwalk.com/mcp/affiliates"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliatesПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о GuruWalk Affiliates
Как установить GuruWalk Affiliates в Claude Code?
Одной командой: claude mcp add --transport http guruwalk-affiliates https://back.guruwalk.com/mcp/affiliates. После этого добавьте ключ API в заголовки запросов.
Что делает GuruWalk Affiliates?
Даёт агенту доступ к каталогу бесплатных пеших экскурсий GuruWalk: поиск по городам, просмотр категорий и проверку доступных дат. Ссылки на бронь возвращаются с вашим партнёрским параметром ref.
Нужен ли ключ API?
Да. Без валидного ключа запросы получают 401 Unauthorized. Ключ передаётся в заголовке Authorization: Bearer <api_key> или Api-Key: <api_key>.
