Promtlab

Self-hosted библиотека AI-промптов для соло и команд. Self-hosted в России. Работает с Claude через встроенный MCP-сервер.

🌐 promtlabs.ru · 📖 Документация · 🔌 MCP · 📝 Changelog

---

Что это

ПромтЛаб — это self-hosted веб-приложение для управления библиотекой промптов к Claude (Opus / Sonnet / Haiku). Решает три задачи:

1. Организация — коллекции, теги, иерархия, версии, корзина, поиск.
2. Командная работа — расшаривание промптов команде, роли (owner / editor / viewer), общие коллекции.
3. Интеграция с Claude — встроенный MCP-сервер позволяет Claude искать, читать и обновлять ваши промпты прямо из чата.

Особенности

• 🇷🇺 Интерфейс на русском, self-hosted в России (хостинг Timeweb)
• 🔌 MCP-сервер v2.0.0 — 29 tools, опубликован в Official MCP Registry
• 👥 Команды с ролями (owner / editor / viewer), 2FA для админов
• 💳 Тарифы: Free (0₽), Pro (599₽/мес), Max (1299₽/мес), оплата через Т-Банк
• 🧩 Интеграция с Claude Code, Claude Desktop, Cursor, Windsurf
• 🔐 OAuth 2.0 + PKCE для GitHub / Google / Yandex, TOTP 2FA для админов
• 📊 Версионирование промптов, публичные ссылки, шаринг
• 🧱 Цепочки промптов (chains) с развилками — output шага → input следующего
• 🌐 Браузерное расширение для Chrome — вставка промптов в 9 AI-чатов

Стек

Backend: Go 1.25 · Chi v5 · GORM v2 · PostgreSQL 18 · slog · koanf Frontend: React 19 · Vite 8 · shadcn/ui · Tailwind 4 · TanStack Query · Zustand Infra: Docker Compose · GlitchTip (self-hosted Sentry) · GitHub Actions CI/CD MCP: modelcontextprotocol/go-sdk v1.5, Streamable HTTP transport

Подробнее — promptvault/CLAUDE.md (архитектура, Clean Architecture слои, конвенции).

Быстрый старт (dev)

git clone https://github.com/Slava4123/promtlab.git
cd promtlab/promptvault
cp .env.example .env  # заполнить DATABASE_*, JWT_SECRET
docker compose -f docker-compose.dev.yml up

• Frontend: http://localhost:5173
• Backend API: http://localhost:8080
• MCP endpoint: http://localhost:8080/mcp

Создать первого админа.

В dev (образ Dockerfile.dev содержит Go-тулчейн):

docker compose -f docker-compose.dev.yml exec api go run ./cmd/create-admin [email protected]

В prod так нельзя: образ Dockerfile.prod — это alpine без Go-тулчейна, в нём собран только бинарь server (./cmd/create-admin в него не входит). Запустите утилиту во временном golang-контейнере, примонтировав исходники и .env и подключившись к той же сети, где живёт PostgreSQL:

# из promptvault/backend/ (рядом с go.mod и .env)
docker run --rm -it \
  --network promptvault_default \
  --env-file ../.env \
  -v "$PWD":/app -w /app \
  golang:1.25-alpine \
  go run ./cmd/create-admin [email protected]

Имя сети уточните через docker network ls (по умолчанию compose добавляет префикс проекта, например promptvault_default); DATABASE_HOST в .env должен указывать на имя сервиса БД из docker-compose.prod.yml. Утилита идемпотентна: повторный запуск для уже-админа завершается без изменений.

Подключение к Claude (MCP)

claude mcp add --transport http promtlab https://promtlabs.ru/mcp \
  --header "Authorization: Bearer pvlt_YOUR_API_KEY"

API-ключи создаются в https://promtlabs.ru/settings/integrations.

Полный гайд и список всех 29 tools — promptvault/docs/MCP.md.

Лицензия

Functional Source License 1.1 (Apache-2.0 Future License)

• ✅ Можно self-host'ить, форкать, модифицировать, использовать внутри компании
• ❌ Нельзя делать конкурирующий SaaS в течение 2 лет
• 🔓 Через 2 года каждый релиз автоматически становится Apache 2.0

Вопросы по коммерческим использованиям: [email protected].

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

Нашли уязвимость? Пишите на [email protected] или через GitHub Security Advisory. Подробности — SECURITY.md.

Контакты

• 🌐 Сайт: https://promtlabs.ru
• 📧 Email: [email protected]
• 📬 Telegram: @promtlabs

---

Сделано в России с ❤️ для тех, кто много работает с AI.