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

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

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

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

https://sensei.red/mcp

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

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

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

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

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

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

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

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

1. Откройте дашборд Sensei → Настройки → Интеграции.
2. Нажмите «Создать токен».
3. Выберите права: kb:read для агента-консультанта или kb:read + kb:write, если агент будет редактировать статьи.
4. Скопируйте токен — он начинается с 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.