Подключение Claude или ChatGPT
Подключение Claude или ChatGPT
Подключите Claude или ChatGPT, чтобы они могли читать ваши сохранённые поездки, маршруты и избранные места. После этого вы сможете попросить ассистента подготовить документ поездки с картами по дням. Ассистент создаёт документ с помощью собственных инструментов для работы с документами; WaypointGuru предоставляет сохранённые данные и фирменные изображения карт.
Перед началом
Вам понадобится учётная запись WaypointGuru, несколько сохранённых данных и учётная запись ассистента, которая поддерживает пользовательские удалённые подключения MCP. В управляемом рабочем пространстве администратору может потребоваться включить или добавить подключение. Для создания документов также нужны подходящие инструменты для документов и изображений в этом ассистенте.
Используйте этот URL сервера MCP:
https://waypoint.guru/mcp
Выберите аутентификацию OAuth с automatic registration (также называется dynamic client registration или DCR). WaypointGuru не требует API-ключ, персональный токен доступа, секрет клиента или специальный заголовок авторизации. Используйте automatic registration, а не Client ID Metadata Documents (CIMD).
Настройка Claude в веб-версии
- Откройте Customize > Connectors, затем + Add > Add custom connector. Для управляемого рабочего пространства его владельцу может сначала потребоваться добавить веб-коннектор в Organization settings > Connectors.
- Назовите его WaypointGuru и введите
https://waypoint.guru/mcpкак URL сервера MCP. - Продолжите настройку аутентификации. Выберите Sign in now и Register automatically для OAuth-клиента. Используйте automatic registration вместо опубликованной идентификации Claude.
- Завершите добавление коннектора и выберите Connect, если появится запрос. Выполните вход в WaypointGuru и шаги выдачи разрешений, описанные ниже.
- В беседе откройте + > Connectors и включите WaypointGuru.
Названия меню и доступность функций могут меняться. Если в вашей учётной записи интерфейс выглядит иначе, см. инструкции Claude по пользовательским коннекторам.
Настройка ChatGPT в веб-версии
В настоящее время ChatGPT описывает два варианта настройки. Используйте тот, который доступен в вашей учётной записи.
Для варианта Plugins:
- Откройте Plugins, выберите + > Add custom MCP server и назовите его WaypointGuru.
- Введите
https://waypoint.guru/mcpв разделе Connection. Выберите OAuth, настройте DCR и оставьте статические учётные данные клиента пустыми. - Просмотрите предупреждение, выберите Create as a plugin и установите созданный плагин. При появлении запроса выполните вход в WaypointGuru и дайте согласие.
- В чате введите @ и выберите WaypointGuru, когда попросите прочитать ваши данные.
См. инструкции OpenAI по пользовательскому серверу MCP.
Для варианта Apps / developer mode включите Settings > Apps > Advanced settings > Developer mode, если это разрешено. Создайте приложение, используя тот же URL и те же настройки OAuth/DCR, просканируйте его инструменты, выполните вход и завершите создание. Выбирайте приложение в чате при запросе данных; при необходимости выбирайте его снова для последующих запросов. Доступ к этим настройкам контролируют администраторы рабочего пространства. См. инструкции OpenAI по developer mode.
Выбор разрешений
Выполните вход в WaypointGuru в окне браузера, которое открыл ассистент. Перед подтверждением проверьте показанные учётную запись и ассистента. Вход может потребоваться, даже если вы уже вошли в мобильное приложение.
На экране согласия доступны следующие категории чтения:
| Категория | Что ассистент может читать |
|---|---|
| Поездки | Сведения о сохранённых поездках и входящих в них маршрутах по дням, включая данные дня, необходимые для карт. Это не даёт доступа к несвязанным отдельным маршрутам или ко всей вашей коллекции избранного. |
| Маршруты | Сохранённые маршруты, доступные вашей учётной записи, включая поиск по названию, полные данные маршрута и карты. |
| Избранное | Ваши избранные места, включая поиск по тегам, поиск поблизости и полные сведения. |
Для документа поездки начните только с Поездки. Добавляйте другие категории только тогда, когда хотите, чтобы ассистент их использовал. Снимите флажки с ненужных категорий и выберите Разрешить выбранное, либо одобрите все запрошенные категории. Чтобы отменить, выберите Отмена.
Разрешение действует для каждой одобренной категории, включая элементы, сохранённые позже, и общие элементы, к которым ваша учётная запись обычно имеет доступ. Оно не ограничивается одной поездкой или одним разговором. Существующие ограничения общего доступа, конфиденциальности и подписки по-прежнему применяются. Передача ссылки их не обходит.
Доступ только для чтения: ассистент не может изменять, удалять или публиковать данные WaypointGuru. Тем не менее доступ на чтение отправляет данные поставщику ассистента, и к ним применяются его собственные настройки хранения и конфиденциальности. Доступ продлевается автоматически, пока подключение остаётся действительным; при обычном использовании повторное подтверждение обычно не требуется. После длительного периода без использования может понадобиться подключиться заново.
Запрос документа поездки
Попробуйте такой запрос, когда WaypointGuru включён в вашем разговоре:
Используй WaypointGuru, чтобы найти мою сохранённую поездку под названием “Coastal holiday”. Создай документ с информацией о поездке и разделом для каждого дня. Добавь карту WaypointGuru для каждого доступного дня и составь легенду остановок на основе сохранённых данных путевых точек. Отметь дни отдыха и недоступные маршруты. Сохраняй отдельно сохранённую статистику и пересчитанную статистику и сообщи мне, если какие-либо данные или изображения не удалось получить.
Вы также можете указать полную ссылку на сохранённую поездку или сохранённый маршрут, к которым у вашей учётной записи есть доступ. Сокращённые ссылки, содержащие экспортированный маршрут, и несохранённые маршруты не поддерживаются.
Попросите ассистента завершить получение всех страниц и всех фрагментов снимка, прежде чем он будет утверждать, что документ готов. Поездки и маршруты захватываются из сохранённых данных в снимок, который действует до 24 часов. Более поздние изменения не меняют этот снимок, а несохранённые изменения в него не входят. Чтобы включить недавно сохранённые изменения или восстановить истёкший снимок, попросите создать новый снимок и новые карты.
По умолчанию карты выдаются в формате WebP, в полном размере, со стандартным стилем и дневными цветами. Также поддерживаются JPEG и PNG, а ещё размер preview, спутниковый стиль и ночные цвета. Запросите PNG, если инструмент для документов не может встроить WebP. Не скрывайте брендинг WaypointGuru и атрибуцию поставщика карт. Окружающий текст и легенду остановок пишет ассистент.
WaypointGuru автоматически рассчитывает расстояния и длительность поездки для захваченных маршрутов и дней поездки, включая импортированные маршруты без сохранённых оценок. По возможности используются совпадающие оценки Google, а оценки Valhalla помечаются как резервные. Время в пути не включает время на остановках. Сохранённые оценки остаются отдельными. Сведения о маршруте и дне включают упрощённый контур маршрута и названия основных дорог, если они доступны в данных маршрутизации. Ассистент может запросить подробную геометрию для участка или диапазона расстояний, если ему нужно проверить конкретный отрезок.
Карты обычно передаются как изображения MCP и защищённые ссылки на ресурсы. Если инструменту для документов нужен URL изображения, попросите ассистента запросить delivery: "url". Для Google Docs также запросите format: "png" или "jpeg"; если формат не указан, по умолчанию остаётся WebP.
Ссылки для скачивания работают 15 минут или до истечения срока действия сохранённого снимка, если это произойдёт раньше. Любой, у кого есть ссылка, может получить это изображение, пока подключение ассистента и ваш доступ остаются действительными. Считайте ссылку приватной. Отключение ассистента или потеря доступа к ресурсу блокируют дальнейшие скачивания, но не могут удалить копии, уже вставленные в документ. Если срок действия ссылки истёк до вставки, попросите ассистента выдать новую. Если встраивание по-прежнему не удаётся, попросите его сообщить об отсутствующих картах, а не заявлять об успешном результате.
Отключение или изменение доступа
- В веб-приложении WaypointGuru откройте Настройки WaypointGuru > Учётная запись > Подключённые приложения.
- Проверьте имя ассистента, одобренные категории и информацию о последнем использовании.
- Выберите Отключить для одного подключения или Отключить все, чтобы отозвать все подключения ассистентов для этой учётной записи.
В мобильных версиях, где есть передача в браузер, пункт Подключённые приложения в меню учётной записи открывает эти настройки в браузере. При необходимости выполните там вход.
Отключение останавливает последующее чтение данных, получение карт и автоматическое продление, включая запросы с учётными данными, срок действия которых ещё не истёк. Оно не может отозвать текст, изображения или документы, уже скачанные ассистентом. Управляйте этим содержимым отдельно у поставщика.
Чтобы изменить одобренные категории, отключите старое подключение и подключитесь снова с новым согласием. Вы также можете удалить коннектор, приложение или плагин в Claude или ChatGPT. Выключение для одного разговора не отзывает его разрешение в WaypointGuru; чтобы отозвать доступ, используйте элементы управления отключением в WaypointGuru.
Устранение неполадок
| Проблема | Что попробовать |
|---|---|
| Нет возможности добавить подключение | Проверьте доступность для вашей учётной записи и разрешения администратора рабочего пространства по инструкциям поставщика выше. |
| Не удаётся настроить подключение или регистрацию | Проверьте, что URL сервера — https://waypoint.guru/mcp. Выберите OAuth с automatic registration/DCR. Не выбирайте CIMD или опубликованную идентификацию Claude. |
| Вход завершён, но экран согласия не появляется | Вернитесь в окно ожидающего подключения. Используйте в нём элемент повтора при временной ошибке. Если срок запроса истёк или он был отменён, начните новое подключение из ассистента. |
| Показана не та учётная запись | Отмените согласие. Войдите в нужную учётную запись WaypointGuru в этом браузере и начните заново. |
| Отсутствует инструмент или отказано в разрешении | Проверьте категории в разделе Connected apps и включённые инструменты ассистента. При необходимости подключитесь заново с нужной категорией. Только категория Trips намеренно исключает несвязанные маршруты и полный доступ к избранному. |
| Поездка, маршрут или общая ссылка недоступны | Сначала сохраните изменения и проверьте, что эта же учётная запись может открыть элемент в WaypointGuru. Проверьте доступ по общему доступу и подписке. Приватные, удалённые и недоступные элементы могут выглядеть одинаково недоступными. |
| Результаты кажутся неполными | Попросите ассистента продолжить постраничную загрузку и прочитать все фрагменты снимка. Даже пустая страница поиска может означать, что есть ещё страницы. |
| Срок действия снимка истёк | Запросите новый снимок. Старые снимки истекают через 24 часа и также становятся непригодными после отзыва доступа. |
| Карта ожидает обработки или временно не загружается | Соблюдайте указанную задержку перед повтором и используйте тот же снимок. Не создавайте новые снимки снова и снова. |
| Карта упирается в квоту или ограничение размера | Подождите указанное время повтора из-за квоты. Повторное подключение не сбрасывает квоту. Результат с ограничением размера нельзя исправить постоянными повторами для того же снимка; сообщите о проблеме или используйте меньший сохранённый маршрут. |
| Не удаётся встроить карту | Для инструментов документов, которым нужен URL, запросите delivery: "url"; для Google Docs выберите PNG или JPEG. Если 15-минутный срок действия ссылки уже прошёл, запросите новую. Считайте ссылки для скачивания приватными и сообщайте об отсутствующих картах, если встраивание по-прежнему не удаётся. |
| Ассистент постоянно просит войти снова | После проверки раздела Connected apps подключитесь заново. Продление может не сработать после отключения или длительного бездействия. О повторяющихся запросах во время активного подключения следует сообщить. |
Для получения помощи напишите на support@waypoint.guru, указав дату, ассистента, тип тарифного плана/рабочего пространства учётной записи, шаг настройки и видимую ошибку. Не включайте пароли, токены, ссылки авторизации и приватное содержимое поездок.