Ortto MCP Server

официальный

Новый MCP-сервер Ortto позволяет подключить вашего любимого AI-ассистента к Ortto. После подключения ассистент может безопасно получать доступ к данным о клиентах, аудиториям и аналитике кампаний из CDP и платформы маркетинговой автоматизации Ortto.

Смотреть на ortto.com

Что можно делать с Ortto MCP?

Получение и фильтрация кампаний — Запрашивайте кампании по типу, статусу или названию с помощью get_campaigns.
Поиск контактов и аудиторий — Находите контакты по имени или полю и выводите списки аудиторий с помощью get_contacts и get_audiences.
Загрузка отчетов об эффективности кампаний — Получайте аналитику по email, джорни, SMS или push-уведомлениям через get_email_report, get_journey_report, get_sms_report и get_push_report.
Доступ к пользовательским отчетам — Выводите список созданных пользователями отчетов и получайте их данные с помощью list_reports и get_report.
Управление содержимым базы знаний — Создавайте категории, публикуйте HTML-статьи и изменяйте порядок в индексе с помощью create_category, create_article_from_html и modify_index.
Просмотр схемы аккаунта и брендбука — Получайте пользовательские поля и настройки бренда через get_schema и get_brand_book.

Документация

Перейти на ortto.com

Главная Ortto MCP Ortto MCP

Ortto MCP

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, позволяющий AI-агентам (таким как Claude или ChatGPT) безопасно взаимодействовать с внешними инструментами и источниками данных.

Вы подключаете своего AI-агента (MCP-клиент) напрямую к MCP-серверу Ortto. Это позволяет вашему агенту понимать данные Ortto и действовать на их основе.

После этого агент сможет помогать с различными задачами, используя запросы на естественном языке. Например:

«Покажи эффективность моих email-кампаний за последние 30 дней».
«Какие путешествия клиентов показывают лучшие результаты по конверсиям?»
«Получи список моих самых вовлечённых контактов за этот месяц».

Настройка источника данных MCP

Чтобы начать работу с функцией MCP, необходимо создать MCP в качестве источника данных в вашем аккаунте Ortto. Для настройки выполните следующие шаги:

В аккаунте Ortto перейдите в раздел CDP > Источники данных.
Нажмите Новый источник данных и найдите MCP.
Введите имя для источника данных MCP и нажмите Подключить.

4. После создания источника данных вы получите Scoped key. Этот ключ потребуется для подключения Ortto к выбранному AI-агенту (Claude, ChatGPT и т. д.).

Теперь вы готовы подключить Ortto к своему AI-агенту. В зависимости от используемого агента ознакомьтесь с соответствующей статьёй ниже:

Использование Ortto MCP с Claude
Использование Ortto MCP с ChatGPT

СОВЕТ: Вы можете подключить Ortto MCP к любому приложению, поддерживающему пользовательские коннекторы. Если ваше приложение не указано выше, просто используйте соответствующий URL удалённого MCP-сервера в зависимости от региона размещения вашего аккаунта Ortto.

Соединённые Штаты: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
Европа: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
Австралия: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Если вы не уверены, где размещён ваш аккаунт, эту информацию можно найти в приложении, перейдя в Настройки > Конфиденциальность, безопасность и GDPR > Размещение данных.

Поддерживаемые инструменты/действия

MCP-сервер Ortto позволяет AI-агентам взаимодействовать с вашими данными Ortto через определённые инструменты/действия. В следующих таблицах, сгруппированных по категориям данных, перечислены поддерживаемые инструменты/действия и их описания.

СОВЕТ: Инструменты/действия, указанные в таблицах ниже, — это лишь соглашение об именовании, используемое нашей функцией MCP. Вам не нужно явно использовать эти имена в инструменте AI-агента. Ваш агент автоматически выберет и применит подходящий инструмент/действие на основе вашего запроса на естественном языке.

Управление кампаниями

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

Примеры:

«Покажи все мои email-кампании за последний месяц»
«Получить кампании, которые сейчас запущены»
«Найти кампании со словом "лето" в названии»

Контакты и аудитории

Инструмент/Действие	Описание
get_contacts	Получение контактов с широкими возможностями фильтрации, включая ID аудитории, выбор полей и возможности поиска.
get_audiences	Вывод списка всех аудиторий в аккаунте с поддержкой поиска и пагинации.

Примеры:

«Получить контакты, содержащие "smith" в имени»
«Найти аудитории, в которых меньше 1000 участников»
«Покажи email-адреса и имена последних 10 зарегистрировавшихся контактов»

Отчёты по кампаниям

Инструмент/Действие	Описание
get_email_report	Создание подробных отчётов об эффективности email-кампаний, включая показатели открытий, кликов и вовлечённости.
get_journey_report	Получение комплексной аналитики по путешествиям клиентов с настраиваемыми временными периодами.
get_journey_shape_report	Анализ конкретных форм путешествий и их метрик.
get_sms_report	Получение данных об эффективности SMS-кампаний и статистики вовлечённости.
get_push_report	Доступ к аналитике push-уведомлений и метрикам доставки.

Примеры:

«Сформируй email-отчёт для кампании "Праздничная распродажа"»
«Какова общая эффективность путешествия "Брошенная корзина"?»

Пользовательские отчёты

Инструмент/Действие	Описание
list_reports	Доступ к созданным пользователем отчётам в аккаунте Ortto с фильтрацией по типу диаграммы и возможностью поиска.
get_report	Получение данных конкретного отчёта с настраиваемыми временными периодами и опциями обновления.

Примеры:

«Выведи список всех круговых диаграмм в моём аккаунте»
«Получить данные для отчёта "Выручка за 3 квартал"»

Аккаунт и конфигурация

Инструмент/Действие	Описание
get_schema	Получение полной схемы данных вашего экземпляра Ortto, включая пользовательские поля и структуру данных.
get_brand_book	Доступ к настройкам брендбука, включая цвета, шрифты и элементы брендинга.

Примеры:

«Какие основной и дополнительный цвета бренда определены в нашем брендбуке?»
«Получить все пользовательские поля в моём аккаунте, содержащие "example" в названии»

Управление ресурсами

Инструмент/Действие	Описание
create_asset	Создание новых ресурсов, в первую очередь HTML-писем, с настраиваемым содержимым и метаданными.
get_asset_html	Получение HTML-содержимого существующих ресурсов для просмотра или изменения.
update_asset_meta	Обновление метаданных ресурса, включая имена, темы писем и информацию об отправителе.

Примеры:

«Создай новое рекламное письмо с названием "Не пропустите скидки" и содержимым, объясняющим, почему пользователям не стоит пропускать предстоящую распродажу»
«Получить HTML-содержимое ресурса с именем "Приветственное письмо v2"»

База знаний

Инструмент/Действие	Описание
get_index	Получение структуры базы знаний, включая категории и иерархию статей.
create_category	Создание новых категорий базы знаний с возможными родительско-дочерними связями.
create_article_from_html	Создание статей базы знаний из HTML-содержимого с категоризацией.
move_article	Перемещение статей между категориями в базе знаний.
modify_index	Обновление структуры и организации индекса базы знаний.

Примеры:

«Создай статью базы знаний из этого HTML и назови её "Обзор MCP"»
«Создать новую категорию "Устранение неполадок"»
«Покажи текущую структуру базы знаний»

Ограничения на запросы

При использовании AI-агента через функцию Ortto MCP вы столкнётесь с двумя разными наборами ограничений. Хотя AI-агенты (такие как Claude или ChatGPT) устанавливают собственные лимиты на длину запроса и размер ответа, все вызовы API, проходящие через MCP-сервер Ortto, подчиняются нашим стандартным ограничениям скорости API Ortto. Эти ограничения зависят от вашего тарифного плана и реализованы для обеспечения стабильности системы и добросовестного использования.

Узнайте больше о наших ограничениях скорости API.