mintlify — плагин для Claude Code: что делает и как установить
Помогает создавать и обновлять сайты документации на Mintlify: размечать компоненты MDX, настраивать docs.json, спецификации OpenAPI и структуру разделов.
MIT ★ 7 обновлён 2026-10-23
/plugin install mintlify@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает mintlify
Плагин добавляет в Claude Code скилл mintlify и два MCP-сервера. Поисковый сервер по адресу https://mintlify.com/docs/mcp даёт агенту режим чтения официальной документации Mintlify. С его помощью агент находит синтаксис компонентов, ключи конфигурации и отправляет отчёты об ошибках через submit_feedback.
В скилл входят руководства по компонентам разметки MDX, схеме docs.json, навигации и командам CLI mint. Контекст аудитории фиксируется в файле .mintlify/product-brief.md. Сервер Mintlify Admin на https://mcp.mintlify.com требует авторизации через OAuth при первом запуске: текстовые правки он отправляет в пулл-реквест через ветку сессии, а изменения настроек проекта через execute_code вступают в силу сразу на рабочей площадке.
Какие задачи решает
- Настроить параметры темы, шрифтов и навигации в docs.json
- Оформить страницы документации через компоненты аккордеонов, вкладок и карточек
- Подключить спецификации OpenAPI или AsyncAPI для страниц эндпоинтов
- Зафиксировать профиль целевой аудитории проекта в .mintlify/product-brief.md
Примеры запросов агенту
- /mintlify:mintlify настрой структуру навигации с вкладками и группами в docs.json
- /mintlify:mintlify добавь блок шагов и аккордеон с примером кода на страницу auth.mdx
- /mintlify:mintlify подключи спецификацию openapi.json и настрой интерактивную песочницу
Как установить mintlify
Через маркетплейс плагинов
/plugin install mintlify@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о mintlify
Как установить mintlify в Claude Code?
Сначала добавьте каталог плагинов командой /plugin marketplace add anthropics/claude-plugins-official, затем установите сам плагин через /plugin install mintlify@claude-plugins-official.
Что делает плагин mintlify?
Он предоставляет Claude Code справочники по разметке компонентов Mintlify, схеме docs.json и командам CLI mint. Также плагин подключает MCP-серверы для поиска по документации и редактирования проекта.
Какие доступы нужны серверу Mintlify Admin?
При первом запуске инструмент запрашивает авторизацию по OAuth. Правки документации он отправляет в пулреквест через отдельную ветку, а настройки проекта применяет напрямую.
Исходный текст
SKILL.md · MIT
# Mintlify Claude plugin A Claude Code plugin that gives Claude a comprehensive reference for building [Mintlify](https://mintlify.com) sites. ## What it does Installs a `mintlify` skill that Claude can invoke when working on Mintlify-powered sites. The skill covers: - **Components** — Full syntax and props for all Mintlify components (callouts, cards, steps, tabs, accordions, code groups, fields, frames, and more) - **Configuration** — Complete `docs.json` settings reference including theme, colors, logo, fonts, navbar, footer, redirects, integrations, and custom CSS/JS - **Navigation** — All navigation patterns: groups, tabs, anchors, dropdowns, products, versions, and languages - **API docs** — OpenAPI and AsyncAPI setup, endpoint pages, API playground configuration - **CLI** — Common `mint` CLI commands and their key flags - **Product context** — An interview that records who your docs are for in `.mintlify/product-brief.md` in your project, so later sessions don't ask again ## MCP setup This plugin includes two Mintlify MCP servers that are activated automatically when you install the plugin. - **Mintlify Search** (`https://mintlify.com/docs/mcp`) — Read-only access to Mintlify's published documentation. Use to look up components, config options, guides, and other reference material. Its `submit_feedback` tool sends a report about an incorrect or outdated docs page to Mintlify. - **Mintlify Admin** (`https://mcp.mintlify.com`) — Write access to your Mintlify project. Requires OAuth on first use. Content edits go to a session branch and reach your site through a pull request. Project-level changes made through `execute_code`, such as workflows, settings, members, and integrations, apply immediately to your live project, so the skill tells Claude to confirm them with you first. ## Installation To install the skills in this repo: ``` npx skills add mintlify/mintlify-claude-plugin ``` To install as a Claude Code plugin: ``` /plugin marketplace add mintlify/mintlify-claude-plugin /plugin install mintlify@mintlify-marketplace ``` ## Skills included ### `mintlify` Invoke with `/mintlify:mintlify` or let Claude use it automatically when working on Mintlify projects. The skill loads a concise core reference and routes to detailed reference files only when the task requires them: | Reference file | Contents | |----------------|----------| | `reference/components.md` | All component syntax, props, and examples | | `reference/configuration.md` | Full `docs.json` schema and frontmatter fields | | `reference/navigation.md` | Navigation patterns and when to use each | | `reference/api-docs.md` | API documentation setup and playground config | | `reference/cli.md` | CLI commands and flags | | `reference/product-context.md` | Product brief interview and how the brief is reused | ## License MIT
© mintlify · MIT · mintlify/mintlify-claude-plugin