Подключение 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 в веб-версии

  1. Откройте Customize > Connectors, затем + Add > Add custom connector. Для управляемого рабочего пространства его владельцу может сначала потребоваться добавить веб-коннектор в Organization settings > Connectors.
  2. Назовите его WaypointGuru и введите https://waypoint.guru/mcp как URL сервера MCP.
  3. Продолжите настройку аутентификации. Выберите Sign in now и Register automatically для OAuth-клиента. Используйте automatic registration вместо опубликованной идентификации Claude.
  4. Завершите добавление коннектора и выберите Connect, если появится запрос. Выполните вход в WaypointGuru и шаги выдачи разрешений, описанные ниже.
  5. В беседе откройте + > Connectors и включите WaypointGuru.

Названия меню и доступность функций могут меняться. Если в вашей учётной записи интерфейс выглядит иначе, см. инструкции Claude по пользовательским коннекторам.

Настройка ChatGPT в веб-версии

В настоящее время ChatGPT описывает два варианта настройки. Используйте тот, который доступен в вашей учётной записи.

Для варианта Plugins:

  1. Откройте Plugins, выберите + > Add custom MCP server и назовите его WaypointGuru.
  2. Введите https://waypoint.guru/mcp в разделе Connection. Выберите OAuth, настройте DCR и оставьте статические учётные данные клиента пустыми.
  3. Просмотрите предупреждение, выберите Create as a plugin и установите созданный плагин. При появлении запроса выполните вход в WaypointGuru и дайте согласие.
  4. В чате введите @ и выберите 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 минут или до истечения срока действия сохранённого снимка, если это произойдёт раньше. Любой, у кого есть ссылка, может получить это изображение, пока подключение ассистента и ваш доступ остаются действительными. Считайте ссылку приватной. Отключение ассистента или потеря доступа к ресурсу блокируют дальнейшие скачивания, но не могут удалить копии, уже вставленные в документ. Если срок действия ссылки истёк до вставки, попросите ассистента выдать новую. Если встраивание по-прежнему не удаётся, попросите его сообщить об отсутствующих картах, а не заявлять об успешном результате.

Отключение или изменение доступа

  1. В веб-приложении WaypointGuru откройте Настройки WaypointGuru > Учётная запись > Подключённые приложения.
  2. Проверьте имя ассистента, одобренные категории и информацию о последнем использовании.
  3. Выберите Отключить для одного подключения или Отключить все, чтобы отозвать все подключения ассистентов для этой учётной записи.

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

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

Чтобы изменить одобренные категории, отключите старое подключение и подключитесь снова с новым согласием. Вы также можете удалить коннектор, приложение или плагин в 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, указав дату, ассистента, тип тарифного плана/рабочего пространства учётной записи, шаг настройки и видимую ошибку. Не включайте пароли, токены, ссылки авторизации и приватное содержимое поездок.