AI-инструменты и MCP

Как подключить документацию FastOffice к Claude, Cursor, VS Code или ChatGPT через MCP-сервер, llms.txt и виджет «Спросить документацию».

Документация FastOffice рассчитана не только на людей. Справочник большой — 28 команд сеанса, 306 методов оболочки A4, 479 типов запросов и ответов и 203 операции контракта F1, — и держать его в голове не нужно ни человеку, ни ассистенту. Поэтому сайт отдаёт своё содержимое в трёх машиночитаемых формах.

1. MCP-сервер документации и примеров

Сайт поднимает MCP-сервер по адресу /mcp. Любой клиент, умеющий streamable HTTP, получает шесть инструментов. Три отвечают на вопросы по документации:

Инструмент	Аргументы	Что возвращает
`search_docs`	`query`	До пяти наиболее релевантных страниц с URL, описанием и фрагментом вокруг совпадения.
`get_doc`	`path` — идентификатор страницы или URL	Полный текст страницы в markdown.
`list_docs`	—	Все страницы с заголовками и описаниями.

Ещё три отдают работающие проекты целиком — не куски кода со страниц, а файлы, которые помощник разложит у вас и запустит:

Инструмент	Аргументы	Что возвращает
`list_examples`	`product` — `a4` или `f1`, необязательно	Каталог из двадцати четырёх примеров: что каждый показывает, из скольких файлов состоит и какой командой запускается.
`get_example`	`id`, `product`	Один пример целиком: путь и содержимое каждого файла, команда запуска и адреса собранных файлов движка.
`assemble_starter`	`ids` — несколько идентификаторов	Комбинация примеров, когда нужно сразу несколько возможностей. Пакеты не сливаются: совпадающие пути перечислены отдельно, решение за вами.

Так выглядит разговор целиком: «подключись к https://docs.plantype.ru/mcp, собери мне лист со своим контекстным меню и защитой диапазонов» — помощник сам вызовет assemble_starter с нужными примерами и положит файлы в проект.

Те же пакеты доступны и без MCP, обычными адресами: каталог — /kit/index.json, отдельный пример — по адресу из поля package. Открываются в браузере, качаются curl, читаются чем угодно.

Ставить ничего не нужно, и это не оборот речи. Пакеты @f1/* в открытый реестр npm пока не публикуются: первая стабильная версия ещё не вышла, а публиковать в реестр то, что будет меняться, — значит связать руки и себе, и вам. Поэтому npm install на исходниках примера не сработает.

Рабочий способ на сегодня — подключаться прямо с нашего сайта. В каждом пакете F1 лежит run.html: он открывается в браузере и подтягивает собранные файлы движка по адресу. Адрес указан в первой строке файла одной переменной:

window.FASTOFFICE_BASE = "https://docs.plantype.ru";

Сменится домен — правится только эта строка, пути после него остаются прежними. Когда выйдет первая стабильная версия, пакеты появятся в реестре, и переезд с этого пути будет означать замену одной строки на обычный import — не переписывание проекта.

Примеры F1 — стенды, а не работающий движок. На месте ядра в них дублёр, и числа в ячейках ничего не значат: смотреть нужно на объём кода вокруг листа и на способ встраивания. Настоящий пересчёт — в живом примере, где книга открыта отдельным процессом ядра. У каждого пакета это сказано в поле engine, и помощник обязан передать это вам.

Каталог инструментов в машиночитаемом виде: /mcp-schema.json.

Claude Code

claude mcp add --transport http fastoffice-docs https://docs.plantype.ru/mcp

Cursor

{
  "mcpServers": {
    "fastoffice-docs": { "url": "https://docs.plantype.ru/mcp" }
  }
}

VS Code

{
  "servers": {
    "fastoffice-docs": {
      "type": "http",
      "url": "https://docs.plantype.ru/mcp"
    }
  }
}

Клиенты, которые умеют только stdio

{
  "mcpServers": {
    "fastoffice-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://docs.plantype.ru/mcp"]
    }
  }
}

2. llms.txt

Для инструментов, которые работают с текстовыми дампами, сайт публикует шесть файлов. Все они собираются на этапе сборки из того же содержимого, что и сайт, и открываются по прямой ссылке.

Файл	Что внутри
`/llms.txt`	Оглавление: ссылки на остальные файлы с описаниями. Точка входа.
`/llms-full.txt`	Вся документация одним файлом, ~2.6 МБ.
`/llms-small.txt`	Тот же материал без справочных таблиц полей, ~2 МБ. Это всё ещё много: если контекст у модели небольшой, берите не его, а тематический набор ниже.
`/_llms-txt/a4-reference.txt`	Только справочник A4: Session Protocol, `window.fastdocShell`, DTO, события.
`/_llms-txt/f1-reference.txt`	Только справочник F1: Compute Contract, 203 операции.
`/_llms-txt/platform-overview.txt`	Продуктовая часть: поставка под своим брендом, безопасность, пилот.

3. Чат-ассистент на сайте

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

Под каждым ответом — список источников. Сверяйтесь с ними: ответ формулирует модель, и он может быть неточным.

Если ответы отключены — ключ модели не задан или кончилась квота, — чат показывает найденные разделы со ссылками.

4. Кнопки «Открыть в…» на страницах

В шапке каждой страницы документации есть меню действий: скопировать страницу как markdown или открыть её содержимое в ChatGPT или Claude. Так можно задать вопрос по одной конкретной странице, не подключая MCP.

Что выбрать

Задача	Инструмент
Пишу код интеграции в IDE с ассистентом	MCP-сервер
Разовый вопрос по открытой странице	Кнопка «Открыть в…»
Быстро найти, где про это написано	Виджет «Спросить» или поиск по сайту
Гружу документацию в свой пайплайн	`/llms-full.txt` или `/mcp/docs-index.json`