Подключение AI-агента

MCP-сервер Sensei открывает базу знаний вашей организации для AI-агента: он ищет и читает статьи, а при наличии прав — создаёт и редактирует их. Подключить агента можно двумя способами — выберите подходящий вашему клиенту.

Адрес MCP-сервера

https://sensei.red/mcp

Транспорт — Streamable HTTP. Адрес одинаков для обоих способов подключения.

Способ 1. Через OAuth (рекомендуется)

Подходит для клиентов с кнопкой «Connect» / «Подключить» — Claude в вебе и десктопе и других современных MCP-клиентов. Токен создавать и копировать не нужно: клиент получает и обновляет его сам.

В клиенте откройте добавление коннектора — например, в Claude: Settings → Connectors → Add custom connector.
В поле URL укажите https://sensei.red/mcp.
Нажмите Connect.
Откроется страница входа Sensei — введите рабочий email и пароль, те же, что и для входа в дашборд.
На экране согласия проверьте запрашиваемые права и нажмите «Войти и разрешить доступ».
Готово — агент подключён к базе знаний.

Доступ выдаётся на организацию того сотрудника, который вошёл. Получить доступ к чужой организации нельзя.

Способ 2. По статическому токену

Подходит для клиентов без OAuth-интерфейса — Claude Code, n8n, собственные скрипты.

Шаг 1. Создайте API-токен

Откройте дашборд Sensei → Настройки → Интеграции.
Нажмите «Создать токен».
Выберите права: kb:read для агента-консультанта или kb:read + kb:write, если агент будет редактировать статьи.
Скопируйте токен — он начинается с mcp_ и показывается только один раз.

Токен даёт доступ к базе знаний вашей организации. Храните его как пароль; при компрометации сразу отзовите в том же разделе.

Шаг 2. Подключите клиента

Claude Code — одной командой:

claude mcp add --transport http sensei-kb https://sensei.red/mcp --header "Authorization: Bearer mcp_ВАШ_ТОКЕН"

Claude Desktop (если версия не поддерживает OAuth-коннекторы) — добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "sensei-kb": {
      "command": "npx",
      "args": ["mcp-remote", "https://sensei.red/mcp",
               "--header", "Authorization: Bearer mcp_ВАШ_ТОКЕН"]
    }
  }
}

Для других клиентов укажите адрес https://sensei.red/mcp, транспорт Streamable HTTP и заголовок Authorization: Bearer mcp_ВАШ_ТОКЕН.

Шаг 3. Проверьте подключение

Перезапустите агента и спросите что-нибудь из базы знаний. Агент должен вызвать инструмент kb_search и ответить со ссылкой на статью.

Примеры использования

После подключения вы общаетесь с агентом обычным языком — нужный инструмент MCP-сервера он выбирает сам.

Чтение базы знаний — достаточно прав kb:read:

«Найди в базе знаний всё про оформление возврата» — агент вызовет kb_search.
«Покажи целиком статью про адаптацию новых сотрудников» — kb_get_article.
«Какие разделы есть в базе знаний?» — kb_list_categories.
«Перечисли статьи из раздела по безопасности» — kb_list_articles.
«Что ещё почитать по теме этой статьи?» — kb_get_related.

Редактирование — нужны права kb:write:

«Создай черновик статьи про регламент отпусков по этому тексту: …» — kb_create_article.
«Добавь в статью про возврат раздел о возврате без чека» — kb_update_article.
«Опубликуй черновик про регламент отпусков» — kb_publish_article.
«Заархивируй устаревшую статью про старый прайс-лист» — kb_archive_article.

Агент работает только с базой знаний вашей организации — и токен, и OAuth-доступ жёстко ограничивают его одной организацией. Все правки на запись попадают в историю версий статьи.

Если что-то не работает

401 Unauthorized — токен неверный, истёк или отозван. Создайте новый или переподключитесь по OAuth.
403 Forbidden — не хватает scope: например, агент создаёт статью с правами kb:read. Выдайте kb:write.
«Неизвестный client_id» при входе через OAuth — клиент использует устаревшую регистрацию. Удалите коннектор и добавьте его заново — клиент зарегистрируется начисто.
Агент не видит сервер — проверьте, что адрес заканчивается на /mcp и доступен извне.

Об инструментах и правах — в статье Что такое MCP-сервер Sensei.

Как подключить AI-агента к MCP-серверу