Подключение к MCP-серверу
Ваша база знаний доступна как набор инструментов всему, что говорит на Model Context Protocol. Одна точка входа, один заголовок, ничего не нужно устанавливать.
Две вещи
Ключ доступа
Создаётся в панели администратора в разделе API Keys. Ключ определяет, какой сайт видит клиент, поэтому идентификатор сайта передавать не нужно и добраться до чужих данных нельзя.
Клиент, говорящий на MCP
Любая реализация Model Context Protocol. Если удобнее вызывать напрямую, это JSON-RPC поверх HTTP, и библиотека не нужна вовсе.
Четыре шага
Создайте ключ для сайта
В панели откройте API Keys, выберите клиента и сайт, сгенерируйте ключ. Скопируйте его сразу: он показывается один раз.
Решите, что ключу позволено
Оставьте скоуп query, если клиент только читает. Добавляйте
ingest только когда он должен писать в базу знаний:
add_knowledge, ingest_url и
ingest_sitemap без этого скоупа откажут.
Не используйте ключ виджета. Он лежит в открытой разметке
вашего сайта, его видит любой, поэтому у него намеренно только
query.
Укажите клиенту адрес
Адрес: https://api.slatech.ai/mcp, ключ передаётся в заголовке
X-Api-Key. Отсутствующий или неверный ключ отклоняется с
401 до запуска любого инструмента.
Спросите, что он умеет
Вызовите tools/list. Сервер вернёт каждый инструмент с описанием
и JSON-Schema аргументов, и клиент настроит себя сам. Обнаружение
встроено в протокол, поэтому отдельного документа, который может
устареть, нет.
Инструменты
query_knowledge_base
Задать вопрос и получить ответ, опирающийся на проиндексированный контент сайта. Расходует квоту запросов ровно как вопрос на сайте.
list_documents
Показать, что проиндексировано для сайта, со статусом и числом фрагментов у каждого документа. Только чтение, не тарифицируется.
add_knowledge
Добавить пару «вопрос-ответ» напрямую. Пригодится, когда ответ есть
у сотрудника, но не на странице. Требует ingest.
ingest_url
Загрузить и проиндексировать одну страницу. Частные и локальные адреса
отклоняются, направить инструмент на внутренний ресурс нельзя. Требует
ingest.
ingest_sitemap
Проиндексировать все страницы из XML-карты сайта, включая индексные карты.
Так весь сайт заводится одним вызовом. Требует ingest.
Лимиты и учёт
Отдельные счётчики
Вызовы MCP учитываются отдельно от чата, поэтому видно, во что обходится интеграция, и это не прячется внутри показателей сайта.
120 вызовов в минуту
На ключ. Агент работает пачками, поэтому потолок заметно выше, чем нужно
опрашивающей панели. При превышении возвращается 429
с заголовком Retry-After.
Один ключ, один сайт
Ни один инструмент не принимает идентификатор сайта. Клиент и сайт берутся только из ключа, поэтому добраться до чужих данных подменой аргумента нельзя: подменять нечего.
Использовали старый интерфейс манифеста?
GET /v1/mcp/manifest и его точка выполнения продолжают работать,
построенные на них интеграции живут. Это простая HTTP-форма, а не протокол,
и её операции принимают идентификатор сайта аргументом. Новую работу лучше
направлять на /mcp.