Назад в Помощь
MCP-интеграция

Подключение ПромтЛаб как MCP-сервера

ПромтЛаб реализует Model Context Protocol — открытый стандарт для подключения данных к AI-клиентам. Через MCP ваши промпты, коллекции и теги становятся доступны прямо из Claude Code, Claude Desktop, Cursor, Windsurf и других совместимых клиентов.

Быстрый старт

  1. 1
    Создайте API-ключ
    Откройте Настройки → API-ключи, нажмите «Создать», задайте название (например, «Claude Code на ноутбуке»). Ключ показывается один раз — скопируйте сразу.
  2. 2
    Подключите MCP-сервер в клиенте
    Выберите свой клиент ниже и скопируйте команду или конфиг — поставьте свой ключ вместо pvlt_ваш_ключ.
  3. 3
    Начните пользоваться
    В чате клиента: «Найди мой промпт про код-ревью» или «Создай промпт для рефакторинга». Полный список команд — в разделе ниже.

Подключение клиентов

В терминале — одна команда:

bash
claude mcp add promptvault --transport http https://promtlabs.ru/mcp \
  --header "Authorization: Bearer pvlt_ваш_ключ"

Что MCP умеет (29 tool)

Все операции работают и в личном пространстве, и в команде (через параметр team_id). Запись недоступна для роли читателя.

Чтение16доступно viewer
  • whoamiТекущий пользователь (id, email, plan)
  • search_promptsПоиск по промптам, коллекциям, тегам
  • list_promptsСписок промптов с фильтрами (коллекция, теги)
  • get_promptПолучить промпт по ID с полным содержимым
  • list_prompt_varsИзвлечь {{переменные}} из промпта
  • list_collectionsСписок коллекций с количеством промптов
  • collection_getПолучить коллекцию по ID
  • list_tagsСписок тегов
  • list_teamsСписок команд пользователя (id, role, member_count)
  • get_quota_statusТекущее использование лимитов тарифа (промпты/коллекции/MCP daily)
  • list_duplicate_promptsПары похожих промптов (Pro/Max — очистка библиотеки)
  • list_unused_promptsПромпты с нулевым usage (Pro/Max)
  • list_empty_collectionsКоллекции без активных промптов (Pro/Max)
  • list_orphan_tagsТеги без активных промптов (Pro/Max)
  • list_chainsСписок доступных цепочек промптов
  • get_chainПолучить цепочку по ID со списком шагов
Запись9
  • create_promptСоздать промпт
  • update_promptОбновить промпт (создаёт новую версию)
  • prompt_increment_usageОтметить использование промпта (для аналитики)
  • share_createСоздать публичную ссылку на промпт
  • collection_updateОбновить название/описание/цвет/иконку коллекции
  • create_tagСоздать тег
  • create_collectionСоздать коллекцию для организации промптов
  • start_chain_executionЗапустить выполнение цепочки промптов
  • advance_chain_stepПередать output шага и перейти к следующему
Удаление4
  • delete_promptУдалить промпт (в корзину на 30 дней)
  • delete_collectionУдалить коллекцию (промпты внутри не затрагиваются)
  • tag_deleteУдалить тег (промпты не затрагиваются)
  • share_deactivateДеактивировать публичную ссылку

Ресурсы и промпты

Ресурсы

URI, которые LLM подгружает как контекст без явной команды.

promptvault://collectionsВсе коллекции (контекст для LLM)
promptvault://tagsВсе теги (контекст для LLM)
promptvault://prompts/{id}Конкретный промпт по ID

Промпты

Готовые шаблоны, которые клиент может вставить как сообщение.

use_promptЗагрузить промпт из библиотеки и отформатировать для LLM

Работа в командах

Все tools принимают необязательный team_id. Без него — личное пространство, с ним — командное (если у вас есть доступ).

bash
"Найди мой промпт для код-ревью в команде"
→ search_prompts(query="код-ревью", team_id=2)

"Создай промпт в командном пространстве"
→ create_prompt(title="...", content="...", team_id=2)
РольЧтениеЗапись
Владелец
Редактор
Читатель

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

Поиск и получение промпта

bash
"Найди промпты про TypeScript"
→ search_prompts(query="TypeScript")
→ get_prompt(id=42)

Создание промпта с тегами и коллекцией

bash
"Создай промпт для рефакторинга кода"
→ list_tags()                  # доступные теги
→ list_collections()           # доступные коллекции
→ create_prompt(
    title="Рефакторинг кода",
    content="Ты — эксперт по рефакторингу...",
    tag_ids=[1, 3],
    collection_ids=[2]
  )

Шаринг публичной ссылкой

bash
"Поделись промптом #5"
→ share_create(prompt_id=5)
# → { url: "https://promtlabs.ru/s/abc123" }

Квотирование MCP

ПромтЛаб тарифицирует только реальные изменения в БД: write/destructive операций из 29. Чтение и трекинг использования — бесплатны.

Free: платных вызовов/день
5
Pro: платных вызовов/день
50
Max: платных вызовов/день

Едят квоту: create_prompt, update_prompt, delete_prompt, create_collection, collection_update, delete_collection, create_tag, tag_delete, share_create, share_deactivate, start_chain_execution, advance_chain_step. При превышении — 402 Payment Required.

Лимиты запросов

API-ключей (Free / Pro / Max)
3 / 10 / 15
Запросов в минуту с IP
120
Запросов в минуту на пользователя
60

Максимум 100 записей на страницу в list-операциях. При превышении — ответ 429 с заголовком Retry-After.

Если что-то пошло не так

«unauthorized» / 401
  • Заголовок должен быть точно Authorization: Bearer pvlt_…
  • Ключ не отозван — проверьте в Настройки → API-ключи
  • MCP включён на сервере (MCP_ENABLED=true)
«read-only access» / 403 на write-операции
Ваша роль в команде — читатель. Попросите владельца или редактора повысить вам права.
«too many requests» / 429
Превышен лимит. Заголовок Retry-After: 60 — ждите указанное число секунд.
Нет подключения
  • URL должен быть /mcp (не /api/mcp)
  • Локально: http://localhost:8080/mcp
  • Прод: убедитесь что HTTPS, не HTTP