Notion MCP · контент-конвейер

Как подключить Notion MCP к ИИ-агентам и собрать контент-конвейер

Hosted MCP + OAuth: календарь и брифы в Notion → черновики от Claude, Cursor или ChatGPT обратно в базу — без хаоса в чатах

Подписаться на Maya Pro
01 OAuth → MCP
02 Бриф в Notion
03 Агент читает
04 Draft обратно
05 HITL ✓
Hosted MCP OAuth HITL ✓

Если контент-план живёт в чатах, а черновики — в «ещё одной вкладке», команда каждый раз объясняет нейросети одно и то же: кто аудитория, какой оффер, какой тон, что нельзя писать. Notion MCP меняет схему: ИИ-агент подключается к вашему рабочему пространству, читает календарь и брифы и возвращает черновик обратно в базу — без копипаста туда-сюда.

Коротко. Notion MCP — официальный мост между ИИ-агентом (Claude, Cursor, ChatGPT и др.) и Notion. Агент видит только то, что вы разрешили при входе, работает с Markdown-страницами и базами, а публикация наружу остаётся за человеком.

В этом гайде — схема Notion под контент-завод, подключение hosted MCP через OAuth, первый цикл «бриф → черновик» и типичные ошибки новичков. Ориентир по времени: один вечер до рабочего пилота.

Hosted MCP OAuth HITL ✓ Brief → Draft
notion-mcp · pipeline
# конвейер без Publish
$ connect https://mcp.notion.com/mcp
→ OAuth · папка «Контент-завод»
→ Brief ready → Draft + comment
→ Approved // только человек

Зачем отдавать агенту календарь и брифы в Notion, а не чат с нуля

Чат удобен для разовой идеи. Он плохо держит редакционный конвейер: статусы теряются, версии множатся, новый сотрудник не понимает, что уже «в работе». Контент-завод начинается с единой базы, а не с «умного диалога».

Где ломается ручной контент-план без единой базы

Типичная картина: темы в таблице, брифы в Telegram, черновики в Docs, правки в комментариях к скриншотам. Нейросеть каждый раз стартует с пустого контекста. Вы тратите время на повтор брифа вместо ревью. Автоматизация контента здесь не «кнопка Publish», а снятие хаоса на входе.

Когда план и бриф лежат в Notion, агент может:

  • найти задачи со статусом «Brief ready»;
  • прочитать одну карточку, а не весь workspace;
  • создать страницу-черновик и обновить статус;
  • оставить комментарий редактору.

Публикация в блог или Telegram — отдельный шаг после человеческого «ок». Так вы получаете контент-план с нейросетью внутри процесса, а не «посты из ниоткуда».

Что агент должен читать и что писать обратно

Читать: карточку брифа, связанные референсы из базы знаний, короткие research-заметки, поля календаря (канал, дата, SEO-кластер).

Писать: страницу research, черновик поста в Markdown, комментарий к ревью, смену статуса на Draft / Needs edit.

Не отдавать агенту право: статус Approved и любой экспорт «в эфир». Это зона человека.

Маркер: простыми словами. ИИ-агент — это не просто чат, который отвечает текстом. Агент планирует шаги, вызывает инструменты (поиск, чтение, запись в Notion) и сверяет результат с задачей. Наличие MCP само по себе не делает продукт «агентным»: агентность появляется, когда есть план, инструменты и проверка прогресса.

Схема входа

Единая база вместо чата с нуля

Календарь + бриф → агент читает одну карточку → черновик обратно в Notion → человек на Approved.

Brief
Статус «брать сегодня»
Draft
Черновик без Publish
Граница HITL

Approved и экспорт в эфир — только человек.

MCP простыми словами — мост между ИИ-агентом и вашими инструментами

Спрос на «MCP что это» и «MCP сервер» растёт не зря: без моста модель знает только то, что вы вставили в окно чата.

Маркер: простыми словами. MCP (Model Context Protocol) — единый способ подключить ИИ-агента к внешним сервисам: Notion, файлам, базам. Вместо уникального плагина под каждый чат агент получает стандартный «пульт» с набором действий: найти, прочитать, создать, обновить.

Чем MCP сервер отличается от обычного API-плагина

Обычный API-плагин часто заточен под один продукт и один сценарий. MCP-сервер описывает инструменты так, чтобы разные клиенты (Claude, Cursor, ChatGPT) могли ими пользоваться одинаково. Для контент-команды это важно: вы один раз настраиваете Notion и не переписываете пайплайн под каждую нейросеть.

Hosted Notion MCP отдаёт агенту действия в удобном виде: поиск, чтение страниц, создание и обновление, работа с базами и представлениями, комментарии. Контент страниц идёт как Notion-flavored Markdown — плотнее для модели, чем сырой JSON блоков. Меньше вызовов инструментов — дешевле по токенам и спокойнее по лимитам.

Маркер: простыми словами. Notion-flavored Markdown — обычный текст с разметкой (заголовки, списки, таблицы), который Notion понимает как страницу. Агенту проще писать Markdown, чем собирать страницу поблочно через «сырой» API.

Hosted Notion MCP vs локальный server: когда какой

Hosted (рекомендуется для большинства): адрес https://mcp.notion.com/mcp. Вход только через OAuth пользователя. Токен в конфиг не вставляете. Подходит Claude, Cursor, ChatGPT, Codex, VS Code и другим клиентам с HTTP MCP.

Legacy SSE: https://mcp.notion.com/sse — запасной транспорт. Новый setup берите на Streamable HTTP.

Локальный open-source server: нужен, если требуется сценарий без человека на логине (крон, полностью headless cloud). Там обычно токен доступа. Репозиторий больше не в активной поддержке и может уйти в sunset — это компромисс, не «лучший путь по умолчанию».

Маркер: простыми словами. OAuth — вход «как в Google»: открывается окно Notion, вы подтверждаете доступ. Headless-агент — бот, который крутится на сервере без вашего клика. Hosted Notion MCP как раз требует человека на авторизации, поэтому «полный автопилот без входа» на нём не собрать.

Антимифы. Старые гайды иногда пишут, что Notion MCP «только на чтение» или дают URL вида mcp.notion.so. Актуальный hosted умеет создавать и обновлять страницы; канонический хост — mcp.notion.com.

Контент-конвейер · не hero

Доска в Notion: бриф уходит агенту — черновик возвращается

Пока MCP — «мост», конвейер — маршрут карточки: агент читает бриф через hosted Notion MCP, пишет Markdown-черновик обратно в базу и останавливается перед человеком.

  • fetch / search — агент берёт одну карточку брифа, не весь workspace.
  • create / update page — черновик появляется в колонке Draft.
  • HITL-шлюз — статус Approved только руками; наружу без ревью не уходит.

Дальше — как собрать базы Notion до первого OAuth: календарь, брифы, статусы и поля, без которых агент путает задачи.

Редакционная схема, не UI Notion: колонки Brief → Research → Draft → HITL → Ready и туннель MCP.

Как устроить Notion под контент-завод до первого подключения

Подключать MCP к хаосу бессмысленно: агент начнёт искать «что-то про пост» по всему workspace. Сначала соберите минимальную редакционную ОС.

Базы: календарь, брифы, статусы, черновики

Сделайте одну родительскую страницу или папку «Контент-завод» и внутри четыре сущности (можно как отдельные базы или связанные таблицы):

  1. Календарь — дата, канал (блог / Telegram / VK), тема, SEO-кластер, ответственный, статус выпуска.
  2. Брифы — аудитория, оффер, ключи, тон, запреты, референсы, связь с записью календаря, статус Brief ready.
  3. Research — короткие заметки агента или человека, статус Researched.
  4. Черновики — страница поста, статус Draft → Needs edit → Approved (последний — только руками).

Представления: Calendar по дате, Board по статусу. Агенту проще работать с узким view, чем с «всей базой на 500 строк».

Минимальные поля, без которых агент путает задачи

Без этих свойств ИИ-агент смешивает задачи и раздувает контекст:

ПолеЗачем
StatusФильтр «что брать сегодня»
ChannelТон и длина под канал
AudienceКому пишем
Offer / CTAЧто продаём или какую мысль доносим
KeywordsSEO-кластер и LSI
ToneДеловой / тёплый / короткий
Do notЗапреты: обещания, темы, формулировки
OwnerКто отвечает за HITL

Шаблон брифа держите на одной странице: 1 экран чтения. Длинные «простыни» на 20+ блоков съедают окно контекста модели — агент начинает «забывать» середину брифа.

Подключение Notion MCP по шагам (OAuth)

Ниже — практическая настройка MCP сервера Notion к популярным клиентам. Перед стартом: аккаунт Notion, клиент с поддержкой MCP, право создать интеграцию через OAuth-экран.

Маркер: простыми словами. Streamable HTTP — современный способ «говорить» с удалённым MCP по обычному HTTPS-адресу. SSE — более старый поток событий; для Notion он ещё жив, но в документации как основной указан HTTP-эндпоинт. stdio — режим «агент запускает локальную программу»; если клиент умеет только его, ставят мост mcp-remote к hosted URL.

Claude и Claude Code

Claude Code (терминал):

  1. Выполните: claude mcp add --transport http notion https://mcp.notion.com/mcp
  2. В сессии откройте /mcp и пройдите OAuth Notion.
  3. На экране прав отметьте только папку «Контент-завод», не весь личный архив.

Опционально подключите официальный Notion plugin для Claude Code, если пользуетесь экосистемой плагинов.

Claude Desktop: Settings → Connectors → добавьте Notion MCP. Нужны тарифы Pro/Max/Team/Enterprise. Не путайте с ручной правкой старого claude_desktop_config.json — для hosted-коннектора путь через Connectors.

Cursor

  1. Откройте Settings → MCP.
  2. Добавьте сервер с URL https://mcp.notion.com/mcp (в JSON это блок mcpServers.notion.url) либо пропишите то же в .cursor/mcp.json проекта.
  3. Подтвердите OAuth и сузьте доступ к папке контента.
  4. В чате/агенте Cursor проверьте, что tools Notion видны в списке инструментов.

Как подключить MCP к Cursor новичкам: не ищите «локальный npm Notion», если не нужен headless. Hosted URL + OAuth — основной путь.

ChatGPT и клиенты только со stdio

ChatGPT: зайдите в Connectors, укажите hosted URL Notion MCP, авторизуйтесь. На практике коннектор чаще сильнее в чтении/поиске, чем в полном цикле записи — после настройки проверьте create/update на тестовой странице. Если запись недоступна в вашем клиенте, оставьте ChatGPT для research, а черновик пишите через Claude или Cursor.

Клиенты только со stdio: мост вида npx -y mcp-remote https://mcp.notion.com/mcp. Агент локально поднимает stdio-процесс, а тот ходит на hosted HTTP.

VS Code Copilot: файл .vscode/mcp.json с "type":"http" и тем же URL. Codex: в ~/.codex/config.toml секция [mcp_servers.notion] с url, затем codex mcp login notion.

Признак успеха подключения. В клиенте видны инструменты Notion (search/fetch/create/update). Агент по запросу «найди страницы в Контент-завод со статусом Brief ready» возвращает реальные карточки, а не отговорку «нет доступа».

Типичные ошибки новичка на этом шаге:

  1. Вставили URL .so или SSE, хотя клиент ждёт HTTP — OAuth не завершается или tools пустые. Решение: только https://mcp.notion.com/mcp.
  2. Выдали доступ ко всему workspace — агент тащит в контекст личные заметки. Решение: перелогин OAuth с узкой папкой.
  3. Ждёте полностью автоматический cloud-агент без клика — hosted не поддерживает bearer token. Решение: человек на OAuth или осознанный legacy local server.

Официальная шпаргалка по клиентам: get-started Notion MCP.

Первый рабочий цикл: бриф в Notion → черновик поста обратно

Это обязательный how-to вечера: один бриф → один черновик. Без публикации наружу.

Промпт агента на чтение одной карточки брифа

Создайте в Notion тестовый бриф со статусом Brief ready (тема, аудитория, ключи, тон, «не писать»). Затем в агенте с подключённым Notion MCP:

Найди в базе «Брифы» одну запись со Status = Brief ready.
Открой только эту страницу. Кратко перескажи: аудитория, оффер, ключи, запреты.
Ничего не создавай, пока я не скажу «пиши черновик».

Если агент пересказывает поля верно — чтение работает. Если он «гуляет» по другим базам — ужесточите промпт: «работай только внутри страницы Контент-завод».

Запись черновика и смена статуса без публикации наружу

Второй промпт:

По этому брифу создай новую страницу в базе «Черновики».
Формат: H1, лид, 5–7 смысловых блоков, FAQ из 3 вопросов.
Тон и ключи — из брифа. Не добавляй факты, которых нет в брифе и research.
После создания поставь Status = Draft у черновика и Needs draft → Draft у брифа.
Не ставь Approved. Не готовь текст «к публикации в Telegram/блог».
Оставь комментарий редактору: что проверить глазами.

Для длинных текстов включайте асинхронное создание/обновление страницы (в tools это параметр вроде allow_async) и дожидайтесь статуса задачи через get-async — так меньше обрывов на больших Markdown.

Признак успеха цикла. В Notion появилась страница-черновик, статусы обновились, висит комментарий. В блог и соцсети ничего само не ушло.

Типичные ошибки:

  • Промпт «опубликуй пост» — агент не должен иметь канала Publish; если вы сами копируете в CMS без ревью, ломаете HITL.
  • В бриф вставили всю базу знаний на 30 страниц — контекст рвётся. Держите ссылки, а не простыни.
  • Rate limit: порядка 180 запросов в минуту на пользователя суммарно по tools и около 30 search/min, плюс лимит workspace. Не гоняйте «найди всё подряд» циклами.

Маркер: простыми словами. Rate limit — потолок «сколько раз в минуту можно дёргать сервис». Если превысили, Notion временно отвечает отказом; агент кажется «сломанным», хотя нужно просто снизить частоту поиска и писать точечно.

Как собрать контент-конвейер: research → draft → edit → экспорт

Один цикл — пилот. Конвейер — повторяемые статусы и роли.

Схема handoff:

  1. Календарь ставит тему и дату (человек или агент по шаблону).
  2. Бриф заполняется (человек) → Brief ready.
  3. Research — агент ищет по базе знаний / связанным страницам → короткая заметка Researched.
  4. Draft — агент пишет черновик в Notion.
  5. Edit — человек правит, агент может править по комментариям.
  6. Approved — только человек.
  7. Экспорт — копирование в WordPress как draft, адаптация в Telegram, очередь в Make — после Approve и вне Notion MCP.

Так выглядит автоматизация создания контента без иллюзии «кнопка сама выложила».

Кто человек в контуре (HITL) и где стоп перед постом

Маркер: простыми словами. HITL (human-in-the-loop) — человек в контуре: на критичных шагах агент ждёт подтверждения. Notion прямо рекомендует включать подтверждение действий и не исполнять цепочку «вслепую», особенно если в страницах может быть чужой или сомнительный текст (риск prompt injection через контент + tools).

Стоп-линия для контент-завода:

  • смена статуса на Approved;
  • любой экспорт в публичный канал;
  • удаление/массовое перемещение страниц;
  • доступ к финансам, HR, личным папкам.

Публичные разборы про ИИ-агентов и CMS сходятся в одном: права, аудит и откат важнее «магии автопостинга». Узкая обязанность агента («черновик по брифу») побеждает роль «цифровой сотрудник на всё».

Связка с Telegram/блогом без дубля «ещё одного MCP ради CMS»

Notion MCP закрывает редакционную ОС. Публикацию наружу лучше держать отдельным контуром:

  • ручной копипаст Approved → черновик в CMS;
  • или сценарий в Make/паблишере по статусу Approved;
  • или командный чек-лист «кто выкладывает».

Не обязательно тащить второй MCP «ради CMS», если узкое место — брифы и черновики. Сначала стабилизируйте Notion-конвейер, потом масштабируйте каналы.

Для команд в России: Notion и клиенты вроде Claude/ChatGPT/Cursor обычно доступны через веб, но оплата зарубежных подписок иногда идёт через карты/посредников — заложите это в бюджет. Если OAuth или оплата клиента недоступны, рабочий путь: держать базу брифов в Notion (или даже в таблице), а генерацию черновиков — в доступном RU-инструменте с ручным возвратом текста в Notion. Смысл конвейера (статусы + HITL) важнее конкретного логотипа модели.

Когда Notion-конвейер стабилен и пора связывать черновики с Make, блогом и Telegram «по системе», а не разовыми копипастами — смотрите обучение по автоматизации и вайбкодингу на kv-ai.ru: маршрут от сценариев до устойчивого контент-завода.

Типичные ошибки: токены в git, лишние права, раздутый контекст

Большинство провалов пилота — не «модель тупая», а дыры в доступе и объёме данных.

Что не отдавать агенту в OAuth

Красный список:

  • весь workspace «на всякий случай»;
  • базы с зарплатами, договорами, паролями, личными чатами;
  • продовые CRM с персональными данными клиентов без необходимости;
  • страницы с секретными промптами конкурентов и внутренними KPI, если агент пишет внешний контент.

Права агента = права пользователя, который прошёл OAuth. На Enterprise смотрите политики whitelist клиентов (MCP Governance). Включайте подтверждение действий в клиенте.

Если когда-нибудь поднимете legacy local server — токены вида ntn_ не коммитьте в git и не светите в скриншотах чата.

Почему длинные страницы Notion рвут ответ агента

Модель читает ограниченное окно. Страница на десятки блоков + ещё три «на всякий случай» — агент обрезает середину, путает факты, начинает выдумывать. Лечение:

  • короткие брифы;
  • research отдельной короткой страницей;
  • async на больших create/update;
  • один бриф за цикл, не «сделай все Brief ready за раз».

Путаница hosted и @notionhq/notion-mcp-server тоже бьёт по новичкам: ставите local package из устаревшего галерейного коннектора — получаете другой набор поведения и лишние токены на JSON. Для DIY-вечера берите hosted URL.

Чек-лист: от одного агента к командному контент-заводу

Пройдите сверху вниз. Каждый пункт — да/нет.

  1. Папка «Контент-завод» создана, лишнее вне её.
  2. Есть базы/поля: календарь, бриф, research, черновик, статусы.
  3. Hosted MCP https://mcp.notion.com/mcp подключён к выбранному клиенту.
  4. OAuth выдан только на папку контента.
  5. Включён human confirmation на действия записи.
  6. Пройден цикл: один Brief ready → Draft + комментарий.
  7. Approved ставит только человек.
  8. Экспорт в блог/Telegram описан отдельно и запускается после Approve.
  9. Команда знает, какой клиент для research, какой для draft (если ChatGPT слабее на запись).
  10. Есть владелец процесса (не «агент сам разберётся»).

Когда один человек стабильно гоняет 5–10 черновиков в неделю, подключайте второго редактора и шаблоны промптов как «скиллы» агента: (а) найди Brief ready; (б) создай draft по шаблону; (в) обнови статус; (г) комментарий редактору. Так ИИ-агенты перестают быть игрушкой и становятся сменой на контент-заводе.

Как создать ИИ-агента в этом смысле — не «написать код с нуля», а собрать роль: клиент + MCP + узкий промпт + права + HITL. Бесплатные ИИ-агенты в маркетинговых обещаниях редко закрывают запись в вашу базу; смотрите на связку «клиент с MCP + Notion», а не на ярлык «бесплатно».

FAQ

Чем Notion MCP отличается от встроенного Notion AI

Notion AI работает внутри интерфейса Notion и помогает на странице. Notion MCP подключает внешнего ИИ-агента (Claude, Cursor, ChatGPT и др.) к тем же данным через стандартный протокол: агент может искать, читать и писать по вашим правилам из своего клиента. Часто используют вместе: AI в UI для правок руками, MCP — для агентного цикла по статусам.

Нужен ли свой MCP сервер, если есть hosted

Для 9 из 10 контент-команд — нет. Hosted проще, безопаснее по секретам (нет токена в файле) и лучше заточен под агентов через Markdown. Свой/локальный server имеет смысл при жёстком headless без OAuth — с пониманием, что это legacy-компромисс.

Можно ли полностью убрать человека из публикации

Технически «почти» — плохо для бренда и риска. Hosted MCP всё равно завязан на user OAuth; полностью без человека на авторизации он не про ваш сценарий. Даже при автоматизации экспорта оставьте HITL на Approved: ошибка в факте, оффере или юридической формулировке дешевле поймать до поста, чем после.

Beget — надёжный хостинг и VPS

Что проверяли по источникам