17 — BookStack MCP: эксплуатация

ITG BookStack MCP — эксплуатационная инструкция

Подтверждённые сведения

• Книга ITG: https://wiki.karpiev.ru/books/itg-baza-znanii
• Endpoint MCP: https://mcp-wiki.karpiev.ru/mcp
• Каталог: /DATA/AppData/bookstack-mcp
• Docker Compose, сервис bookstack-mcp.
• FastMCP, GitHub OAuth.

Проверка конфигурации

cd /DATA/AppData/bookstack-mcp
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose ps
sudo env DOCKER_CONFIG=/DATA/AppData/docker-cli-config docker compose logs --tail 50

Обновление кода

1. Сохранить копию server.py и Compose-файла.
2. Проверить синтаксис Python.
3. Пересобрать контейнер из существующего каталога.
4. Проверить доступность endpoint и авторизованный вызов списка инструментов.
5. В ChatGPT обновить подключение при изменении состава инструментов.

Проверенные инструменты

• bookstack_search
• bookstack_books_list
• bookstack_shelves_list
• bookstack_page_get
• bookstack_page_create
• bookstack_page_update
• bookstack_book_create
• bookstack_chapter_create
• bookstack_page_move

Доступные операции структуры

bookstack_chapter_create и bookstack_page_move доступны в подключении. Перенос ограничен страницами и главами книги ITG (ID 4); HomeLab (ID 2) не изменять. Доступность инструментов подтверждена 11.10.2026, настройка OAuth allowlist требует отдельной проверки.

Безопасность

GitHub OAuth сам по себе не доказывает, что доступ ограничен нужным аккаунтом. Проверить allowlist и права BookStack API.

Статус: часть сведений подтверждена рабочими вызовами; настройки доступа требуют аудита.