Кратко
Подключите ИИ к Iterable: смотрите пользователей с их событиями и сообщениями, анализируйте списки, кампании и их метрики, шаблоны и каталоги, обновляйте профили, записывайте события, управляйте подпиской на списки и после вашего подтверждения отправляйте триггерное письмо.
Пошаговая настройка
Подключи Iterable к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Iterable в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Iterable
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Iterable, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Iterable + Microsoft Copilot
Подключите ИИ к Iterable: смотрите пользователей с их событиями и сообщениями, анализируйте списки, кампании и их метрики, шаблоны и каталоги, обновляйте профили, записывайте события, управляйте подпиской на списки и после вашего подтверждения отправляйте триггерное письмо.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
ITERABLE_API_URL, ITERABLE_API_KEY
Шаг 1 — Получите учётные данные
Настройка занимает около 3 минут. Нужен пользователь Iterable, который может создавать API-ключи в проекте, и нужно знать, где размещён проект: в США или в ЕС.
- В Iterable откройте в настройках проекта Integrations → API Keys и нажмите New API Key. Выберите ключ Server-side, если ИИ должен читать и записывать, или Read-only, если только читать. Ключи JavaScript и Mobile здесь не работают.
- Скопируйте ключ и вставьте его в
ITERABLE_API_KEY. Ключ принадлежит одному проекту, поэтому один коннектор работает с одним проектом Iterable. Ключ отправляется только в Iterable, в заголовкеApi-Key. - Укажите в
ITERABLE_API_URLдата-центр проекта:https://api.iterable.comдля проектов в США,https://api.eu.iterable.comдля проектов в ЕС (в них вы входите через app.eu.iterable.com), без/apiи других путей. - Установите коннектор и начните с
iterable_list_channels: он проверяет ключ и показывает маркетинговые и транзакционные каналы проекта.
Один ключ на весь проект: ключ действует от имени проекта, а не отдельного человека. Кто пользуется коннектором, видит всех пользователей и все кампании, доступные ключу, поэтому открывайте MCP-сервер только тем, кому это можно видеть.
Что умеет коннектор: профили пользователей по email или userId со всеми полями, их последние события (собственные события, покупки, отправки, открытия, клики, отказы доставки, отписки) и отправленные им сообщения; списки с размером и участниками; кампании с подробностями и метриками; шаблоны, каналы, типы сообщений, каталоги и их элементы. Метрики кампаний приходят таблицей, по строке на кампанию: отправки, доставки, уникальные открытия и клики, отказы, жалобы, отписки, покупки и выручка.
Изменения только после вашего «да»: ИИ показывает, что собирается записать, и перед каждым изменением ждёт подтверждения.
iterable_update_userдописывает поля в профиль. Изменённые поля могут перевести пользователя в динамические списки и запустить journey.iterable_track_eventзаписывает собственное событие, например регистрацию или бронирование, которое тоже может запустить journey.iterable_subscribe_to_listиiterable_unsubscribe_from_listменяют состав списков. Отписка с опцией канала равносильна полной отписке от этого канала.iterable_send_emailотправляет настоящее письмо из триггерной кампании одному человеку, сразу или в заданное время. Массовые отправки по-прежнему делаются кампаниями в Iterable.
Выключены при установке: iterable_delete_user_by_email и iterable_delete_user_by_user_id безвозвратно удаляют профили вместе с данными. Администратор включает их только осознанно. С ключом Read-only любая запись возвращает 403; для режима только чтения выключите инструменты записи.
Email или userId: в зависимости от того, устроен ли проект по email, по userID или гибридно, ИИ определяет пользователя по email или по userId и никогда не передаёт оба в одном вызове. Время в ответах указано в миллисекундах epoch.
Лимиты на проект: большинство чтений 100 вызовов в секунду, метрики кампаний 10 в минуту, размер и участники списка 5 в минуту, отправленные сообщения 3 в секунду. Участники больших списков обрезаются примерно на 100 КБ, поэтому ИИ сначала проверяет размер списка.
Частые ошибки: 401 «Invalid API key» означает, что ключ неверный или удалён, это ключ JavaScript или Mobile либо он из другого дата-центра; проверьте ITERABLE_API_URL. 400 с кодом вроде BadParams или RequestFieldsTypesMismatched: неверен параметр или тип поля, в сообщении сказано, какой. 404 или NotFound: такого пользователя, списка или кампании в проекте нет. 429: достигнут лимит запросов; подождите и повторите.
Коннектор не запускает задания экспорта и не использует bulk-эндпоинты, не редактирует шаблоны и сниппеты, не управляет экспериментами и journey, не отправляет in-app, push, SMS и web push, не меняет подписки по типам сообщений и не изменяет каталоги.
Шаг 2 — Установите адаптер
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Шаг 3 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Iterable. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Tool | What it does |
|---|---|
iterable_list_lists | List the user lists of the Iterable project: id, name, type (Standard, Dynamic, Suppression, Internal), description and creation time… |
iterable_get_list_size | Count the users in one Iterable list |
iterable_list_list_users | Get the users of one Iterable list as plain text, one email (or userId) per line |
iterable_get_user_by_email | Get an Iterable user profile by email: email, userId and all dataFields (profile fields, subscription and channel settings, signup date and… |
iterable_get_user_by_id | Get an Iterable user profile by userId: email, userId and all dataFields |
iterable_get_user_events_by_email | Get the latest events of an Iterable user by email, newest first: custom events, purchases, email sends, opens, clicks, bounces… |
iterable_get_user_events_by_user_id | Get the latest events of an Iterable user by userId, newest first: custom events, purchases, message sends, opens, clicks, bounces and… |
iterable_get_sent_messages | List the messages Iterable sent to a user (by email or userId): message id, campaign id, template id and time, optionally filtered by… |
iterable_list_campaigns | List the campaigns of the Iterable project, a page at a time: id, name, type (Blast or Triggered), state, message medium, template, lists… |
iterable_get_campaign | Get one Iterable campaign by id: name, type, state, message medium, template id, send size, lists and suppression lists, labels, workflow… |
iterable_get_campaign_metrics | Get campaign metrics from Iterable as CSV text: one row per campaign with columns such as total sends, deliveries, unique opens and clicks… |
iterable_list_templates | List the message templates of the Iterable project, a page at a time: template id, name, message type, campaign, creator, created and… |
iterable_list_channels | List the message channels of the Iterable project: id, name, channel type (Marketing or Transactional) and medium (Email, Push, SMS) |
iterable_list_message_types | List the message types of the Iterable project: id, name, channel id, subscription policy (opt-in or opt-out), frequency cap and rate limit |
iterable_list_catalogs | List the catalog names of the Iterable project (catalogs hold products, articles or other items used for personalization) |
iterable_list_catalog_items | List the items of one Iterable catalog, a page at a time: item id, last modified time and the item's fields |
iterable_update_user | Create or update an Iterable user profile by email or userId: the dataFields given are merged into the profile, missing fields are kept |
iterable_track_event | Record a custom event for an Iterable user (by email or userId), such as a signup, a booking or a page view, with its data |
iterable_subscribe_to_list | Add users to a static Iterable list (by email or userId), creating profiles that do not exist unless update_existing_users_only is true |
iterable_unsubscribe_from_list | Remove users from a static Iterable list (by email or userId) |
iterable_send_email | Send the email of a triggered Iterable campaign to one user (by email or userId), now or at send_at, with dataFields for the template |
iterable_delete_user_by_email | Delete an Iterable user by email, asynchronously (email-based and hybrid projects) |
iterable_delete_user_by_user_id | Delete Iterable users by userId, asynchronously; every profile with that userId is removed for good |
Примеры запросов
- «Найди [email protected] в Iterable: поля её профиля, последние 20 событий и кампании, которые отправили ей письма в этом месяце.»
- «Сравни в таблице отправки, уникальные открытия, уникальные клики и отписки по нашим последним пяти blast-кампаниям.»
- «Сколько пользователей в списке VIP Newsletter и какие шаблоны использует кампания Welcome?»
- «Добавь [email protected] в список Beta testers и запиши для него событие beta_signup, но сначала покажи, что именно ты запишешь.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?