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

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

Prismic + Gemini

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 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Prismic.

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

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

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

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot