Подключение MCP

Для подключения понадобится аккаунт Slovix и AI-клиент с поддержкой удалённого MCP по Streamable HTTP. Клиент должен уметь проходить OAuth-вход или передавать персональный токен в заголовке запроса.

Скопируйте адрес сервера

Откройте «Настройки» → «MCP» и скопируйте «URL MCP-сервера». Для публичного Slovix адрес:

https://api.slovix.ru/mcp

Указывайте весь адрес, включая /mcp. Это адрес протокола для AI-клиента, а не страница со списком встреч: при открытии обычным браузером вы можете увидеть сообщение об авторизации или неподходящем запросе.

Вариант 1: вход через браузер

1. В AI-клиенте добавьте удалённый MCP-сервер с адресом Slovix.
2. Если клиент предлагает авторизацию, начните подключение.
3. Пройдите вход в аккаунт Slovix в открывшемся браузере и подтвердите запрашиваемый доступ на чтение.
4. Вернитесь в AI-клиент и дождитесь загрузки инструментов.
5. Попросите показать последние пять встреч.

Доступность OAuth зависит от конфигурации сервиса и совместимости конкретного клиента. Если клиент не может зарегистрироваться или браузерный вход недоступен, используйте персональный токен. Наличие поддержки OAuth у двух продуктов само по себе не гарантирует совместимость всех вариантов регистрации клиентов.

Вариант 2: персональный токен

1. В Slovix откройте «Настройки» → «MCP» → «Персональный токен».
2. Введите «Название подключения», например «Cursor на рабочем Mac».
3. Нажмите «Создать токен».
4. Скопируйте значение и сохраните его в защищённом месте. Токен показывается только один раз; рядом отображается срок действия.
5. Настройте удалённый сервер в клиенте, добавив заголовок Authorization со значением Bearer и вашим токеном после пробела.
6. После сохранения нажмите в Slovix «Я сохранил токен».

Пример формата заголовка, где текст в угловых скобках нужно заменить:

Authorization: Bearer <ваш персональный MCP-токен>

Не помещайте токен в URL, обычный запрос к ассистенту, скриншот или публичный репозиторий. Создавайте отдельный токен для каждого клиента: тогда один доступ можно отозвать независимо от остальных. Для срока действия ориентируйтесь на дату, показанную Slovix.

Пример настройки Cursor

Cursor поддерживает глобальную конфигурацию MCP в ~/.cursor/mcp.json. В ней можно добавить сервер следующего вида:

{
  "mcpServers": {
    "slovix": {
      "url": "https://api.slovix.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SLOVIX_MCP_TOKEN}"
      }
    }
  }
}

Передайте SLOVIX_MCP_TOKEN в окружение процесса Cursor. Если переменная задана только в терминале, уже запущенное из Dock приложение может её не видеть: перезапустите Cursor из окружения, где она доступна. Для удалённых серверов Cursor не использует envFile; этот параметр предназначен для локального транспорта stdio.

Если в mcp.json уже есть другие серверы, добавьте slovix внутрь существующего mcpServers, сохранив остальные записи. Затем обновите подключение в клиенте и проверьте загрузку инструментов. Формат конфигурации описан в официальной документации Cursor.

Это пример настройки удалённого сервера по документированному формату клиента. Для конкретной версии клиента итоговая проверка — успешная загрузка инструментов и чтение вашей тестовой встречи.

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

1. Попросите ассистента: «Покажи последние пять встреч из Slovix».
2. Сравните названия с библиотекой приложения.
3. Выберите одну завершённую встречу и попросите прочитать её итоги.
4. Убедитесь, что ассистент использовал инструмент Slovix, а не ответил по общим знаниям.

В «Настройках» → «MCP» есть список «Активные подключения». Созданный токен появляется там до первого успешного запроса; само его наличие ещё не доказывает, что клиент настроен правильно.

Отключите или замените доступ

Найдите нужный клиент в «Активных подключениях», нажмите «Отключить» и подтвердите действие. Для токена отзывается выбранный токен; для OAuth — соответствующее разрешение клиента.

Если токен потерян или истёк, создайте новый, замените его в клиенте и отзовите прежний. Показать старое полное значение повторно нельзя. Выход из desktop-приложения не следует считать отзывом MCP-подключений: управляйте ими в этом разделе отдельно.

Частые ошибки

Если клиент поддерживает только локальные серверы stdio, одна вставка HTTP-адреса в поле команды не сработает. Выберите клиент с удалённым HTTP-подключением. Не вводите токен в случайные посредники для проверки.