Как подключить Prismic к Microsoft Copilot через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Prismic, установите его без ключа, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Prismic + Microsoft Copilot

Headless-конструктор страниц Prismic, без ключа для публичного репозитория: запросы опубликованных и запланированных документов с фильтрами Prismic, чтение документов по id, UID или типу, модели custom types и slices, просмотр и загрузка медиа, а также создание и изменение черновиков документов через Migration API.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

PRISMIC_REPOSITORY (необязательно: PRISMIC_ACCESS_TOKEN, PRISMIC_WRITE_TOKEN)

Шаг 1 — Настройте коннектор

Публичный репозиторий, без ключа: настройка занимает около 3 минут. Коннектор читает репозиторий Prismic через Content API (https://<repository>.cdn.prismic.io/api/v2). Если этот API публичный, достаточно имени репозитория. Модели контента, медиа и запись идут через API записи Prismic (Types API, Asset API и Migration API) и требуют write token.

1. PRISMIC_REPOSITORY: имя репозитория, часть перед .prismic.io в URL панели, например your-repo-name.
2. PRISMIC_ACCESS_TOKEN (необязательно): только если Content API приватный. В репозитории откройте Settings > API & Security и создайте access token или выполните npx prismic token create. Для публичного API оставьте поле пустым.
3. PRISMIC_WRITE_TOKEN (необязательно): нужен для всех инструментов с пометкой "Needs the write token" и для любой записи. Откройте Settings > API & Security > Write APIs и создайте токен или выполните npx prismic token create --write. Он передаётся как Authorization: Bearer <token> вместе с заголовком repository. У него широкие права, поэтому доверяйте его только надёжным workspace.
4. Установите коннектор и запустите prismic_get_repository, чтобы проверить имя репозитория.

Собственный MCP-сервер Prismic: Prismic также предоставляет MCP-сервер (https://mcp.prismic.io/mcp, вход через OAuth) для редактирования и публикации из ассистента. Этот коннектор это альтернатива на токенах.

Чтение контента в два шага:

1. prismic_get_repository возвращает refs. ИИ берёт ref записи с isMasterRef: true для опубликованного контента или ref релиза для предпросмотра запланированного. Он нужен каждому запросу контента и меняется при каждой публикации. Тот же ответ перечисляет custom types, теги, языки и закладки.
2. Затем prismic_search_documents с фильтрами в q, prismic_get_document по id, prismic_get_document_by_uid по типу и UID (например, тип page и uid about-us) или prismic_list_documents_by_type. lang, fetch_links и graph_query задают форму ответа.

Фильтры (q): [[at(document.type,"blog_post")]]; несколько фильтров подряд объединяются: [[at(document.type,"blog_post")][any(document.tags,["news","events"])]]. Другие: fulltext(document,"text"), at(my.blog_post.author,"<id>"), date.after(document.first_publication_date,"2026-01-01"), not, in(document.id,[...]), number.lt(my.product.price,100). Сортировка через orderings, например [my.blog_post.date desc].

Модели и медиа (write token): prismic_list_custom_types и prismic_get_custom_type дают структуру полей каждого типа страницы с вкладками, slice zones, признаком повторяемого или единичного типа и статусом; prismic_list_shared_slices и prismic_get_shared_slice дают shared slices с их вариантами. prismic_list_assets просматривает медиатеку по типу или ключевому слову, prismic_upload_asset загружает файл по публичному URL и возвращает id ассета, а prismic_update_asset меняет альтернативный текст, авторство и заметки.

Запись документов (write token): prismic_create_document и prismic_update_document сохраняют черновики в migration release. Они не появятся на сайте, пока редактор не опубликует этот релиз в панели (вкладка Migration Releases); вызова публикации в этих API нет. ИИ собирает data по модели custom type: rich text это список блоков ({"type": "paragraph", "text": "...", "spans": []}), изображения и медиа принимают id ассета, ссылки {"link_type": "Document", "id": "..."} или {"link_type": "Web", "url": "..."}. Изменение заменяет весь контент и теги, поэтому ИИ сначала читает документ и отправляет всё обратно. Тип и локаль изменить нельзя.

При установке ничего не отключено: инструментов удаления и публикации нет. Изменение моделей контента и удаление остаются за панелью или CLI Prismic.

Форматы данных: списки контента содержат results, page, total_pages, total_results_size и next_page. Поля rich text приходят списками блоков; даты в формате YYYY-MM-DD, метки времени в ISO 8601. Id документов выглядят как ZMI65RQAADkECUFM.

Постраничная выдача: page (с 1) и page_size (по умолчанию 20, максимум 100) либо orderings вместе с after и id последнего документа. Ассеты листаются через cursor.

Ограничения: Content API допускает 200 некэшированных запросов в секунду и URL до 2 048 символов, поэтому ИИ держит graph_query коротким. Migration API и Asset API принимают один запрос в секунду на репозиторий.

Частые ошибки: 404 на prismic_get_repository означает неверное имя репозитория. 401 или 403 означает приватный API без действующего access token или запись без действующего write token. 400 означает некорректный фильтр или неверный ref, 422 данные, не подходящие под модель.

Коннектор не публикует документы, не удаляет документы и ассеты и не меняет custom types и slices.

Шаг 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 поддерживает.

1. В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
2. Укажи Server name (например, AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер.
3. В аутентификации выбери API key, установи Type в Header, укажи имя заголовка X-API-Key и нажми Create.
4. В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
5. Проверь в панели Test агента: попроси о том, для чего нужны инструменты Prismic.
6. Нажми 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 не подойдёт.

Доступные инструменты

Примеры запросов

• «Покажи десять самых новых записей блога с заголовком и датой первой публикации.»
• «Покажи страницу about-us и кратко опиши её slices.»
• «Какие документы с тегом news впервые опубликованы после 1 января 2026 года?»
• «Какие поля есть у custom type blog_post?»
• «Создай черновик записи блога с заголовком «Наш роадмап на 2026 год» и коротким вводным абзацем, чтобы редактор его проверил.»

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