Интеграция · MCP

База знаний, доступная всему, что говорит на MCP.

Одна точка входа на Model Context Protocol. Пять инструментов, один заголовок, идентификатор сайта передавать не нужно. Ключ решает, какой сайт видит вызывающий, так что ошибиться негде.

Проблема

База знаний отвечает вашему сайту и больше никому.

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

Интеграция

Сам протокол, а не ещё один интерфейс, который надо оборачивать.

Клиент подключается к одной точке входа с ключом вашего сайта и вызывает tools/list. Сервер возвращает каждый инструмент, его описание и JSON-Schema аргументов, и клиент настраивает себя сам. Обнаружение встроено в протокол, поэтому отдельного документа, который может незаметно устареть, не существует.

  1. query_knowledge_base - ответ, опирающийся на проиндексированный контент сайта; расходует квоту запросов ровно как вопрос на сайте.
  2. list_documents - что проиндексировано, со статусом и числом фрагментов у каждого документа. Только чтение, не тарифицируется.
  3. add_knowledge - пара «вопрос-ответ» напрямую, когда ответ есть у сотрудника, а не на странице.
  4. ingest_url и ingest_sitemap - индексация одной страницы или всех страниц из XML-карты сайта. Частные и локальные адреса отклоняются, направить их на внутренний ресурс нельзя.
  5. Ни один инструмент не принимает идентификатор сайта. Клиент и сайт берутся только из ключа, поэтому добраться до чужих данных подменой аргумента нельзя: подменять нечего.
Реализация

Четыре шага, устанавливать нечего.

  1. В панели SLAtech создайте ключ для сайта, который хотите открыть.
  2. Оставьте скоуп query, если клиент только читает, или добавьте ingest, если он должен писать.
  3. Направьте клиент на точку входа и передавайте ключ в заголовке X-Api-Key.
  4. Вызовите tools/list. Остальное клиент выяснит сам.

Не используйте ключ виджета. Он лежит в открытой разметке вашего сайта, его видит любой, поэтому у него намеренно только право чтения, и все пишущие инструменты ему откажут. Серверная интеграция получает собственный ключ.

Совместимость

Любой клиент, говорящий на протоколе.

Точка входа говорит на Model Context Protocol поверх Streamable HTTP, поэтому не привязана к клиенту одного поставщика. Если удобнее вызывать напрямую, это JSON-RPC поверх HTTP и один заголовок, библиотека не нужна вовсе.

  • Any MCP client: Подключение по адресу точки входа и ключу сайта
  • Direct JSON-RPC: Библиотека не нужна, один POST на вызов
  • Agencies: Ключ выбирает, чья база знаний отвечает
  • Legacy manifest API: GET /v1/mcp/manifest продолжает работать для построенных на нём интеграций
Стоимость

Учитывается отдельными счётчиками.

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

Готовы дать своим инструментам доступ к базе знаний?

Одна точка входа, один ключ и клиент, который настраивает себя сам.