> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testsplatform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Как интегрировать testsplatform с ChatGPT и другими AI-инструментами через протокол MCP

## Сценарии использования – Зачем вам может понадобиться MCP сервер

MCP сервер позволяет вашим AI-инструментам (таким как ChatGPT, Claude, GigaChat, YandexGPT, ...) взаимодействовать напрямую с Testsplatform: читать тесты, создавать тесты, добавлять или обновлять вопросы, удалять вопросы. Далее по тексту, в основном будем приводить примеры с ChatGPT, но с другими AI-инструментами всё будет аналогично.
Вот несколько сценариев, где это полезно:

* Автоматизированная генерация тестов: Вы просите ChatGPT создать новый тест (или набор вопросов), и он может связаться с Testsplatform через MCP, чтобы создать тест напрямую.
* Вы можете загрузить в ваш ChatGPT материалы (книги, статьи, документы), а затем попросить его сгенерировать тесты на основе этих материалов, которые он затем может создать напрямую в Testsplatform через MCP.
* Вы можете попросить ChatGPT прочитать существующие тесты из Testsplatform (через MCP сервер), а затем проанализировать их, предложить улучшения или сгенерировать отчеты.

Итого: MCP сервер позволяет вам управлять своими тестами через AI-инструменты, упрощая создание, обновление и анализ тестов.

## Настройка MCP сервера через OAuth (для ChatGPT)

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

Совет: Убедитесь, что вы вошли в Testsplatform в вашем браузере, когда авторизуетесь через OAuth, чтобы перенаправление и подключение завершились корректно.

Мы рассмотрим пример настройки MCP сервера для работы с ChatGPT. С другими AI-инструментами шаги будут аналогичными.

1. Откройте chatgpt.com и войдите в свою учетную запись.
2. Нажмите на иконку вашей учетной записи в левом нижнем углу и выберите "Settings".
3. В меню Settings нажмите "Apps & Connectors"
4. Нажмите "Advanced settings" и включите "Developer Mode".
5. Нажмите стрелку "\< Back", чтобы вернуться в меню "Apps & Connectors".
6. В верхней части модального окна должна появиться новая кнопка: "Create". Нажмите её.
7. В модальном окне "Create new connector" заполните следующие данные:

* Name: Testsplatform MCP Server
* Description: Connector to integrate with Testsplatform
* MCP Server URL: `https://api.testsplatform.com/api/mcp`
* Authentication: оставьте OAuth
* Установите флажок "I understand and want to continue"

8. Нажмите "Create".

Теперь вы должны увидеть коннектор "Testsplatform MCP Server" в вашем списке коннекторов. Далее нам нужно авторизовать его для подключения к вашей учетной записи Testsplatform.
Нажмите на коннектор "Testsplatform MCP Server" в списке, затем нажмите "Connect". Это должно перенаправить вас в Testsplatform для авторизации подключения.
Вы должны быть авторизованы в Testsplatform в вашем браузере, чтобы это работало корректно. Нажмите "Allow", когда увидите запрос на авторизацию.
В конечном итоге вы должны быть перенаправлены обратно в ChatGPT и увидеть, что коннектор теперь подключен, у него должна быть красная кнопка "Disconnect" вместо "Connect".

Теперь вы можете начать использовать коннектор MCP сервера в ваших разговорах с ChatGPT.

### Настройка MCP сервера через токены аутентификации (для Claude и других AI-инструментов)

Некоторые AI-инструменты, такие как Claude, могут требовать настройки MCP сервера с использованием токенов аутентификации вместо OAuth. Обычно это включает в себя генерацию API-ключа или токена из вашей учетной записи Testsplatform, а затем настройку вашего AI-инструмента для использования этого токена для аутентификации.

Документация Claude по настройке MCP сервера с токенами аутентификации доступна здесь: [https://code.claude.com/docs/en/mcp](https://code.claude.com/docs/en/mcp)

Вот шаги для настройки MCP сервера с токенами аутентификации:

1. Войдите в свою учетную запись Testsplatform.
2. Нажмите на иконку профиля в левом нижнем углу, затем выберите Settings.
3. Перейдите на вкладку "API Tokens".
4. Нажмите "Create token", дайте ему имя (например, "Claude MCP Token") и нажмите "Create". (Вы можете установить срок действия по необходимости или оставить без срока действия.)
5. Скопируйте сгенерированный токен куда-нибудь. (Будьте осторожны, вы не сможете увидеть его снова!)
6. На вашем компьютере откройте командную строку или терминал.
7. Выполните команду:
   *Замените `<TOKEN>` на токен, который вы скопировали на шаге 5.*

```
claude mcp add --transport http Testsplatform https://api.testsplatform.com/api/mcp \
  --header "authorization-token: Bearer <TOKEN>"
```

8. Теперь начните новый чат в Claude и попросите его использовать MCP сервер Testsplatform.
   (Ниже приведены некоторые примеры использования MCP сервера с ChatGPT.)

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

Вот несколько примеров запросов, которые вы можете использовать.

***

**Запрос**: "Покажи мне список тестов, которые у меня есть в Testsplatform"
**Результат**: ChatGPT должен вызвать инструмент `get_test_list` и затем показать вам таблицу с вашими тестами.

***

**Запрос**: "Создай новый тест под названием `Оценка знаний мировой истории` и с
описанием: `Этот тест предназначен для взрослых, которые хотят проверить свои знания мировой истории. Таким образом, вопросы будут сосредоточены на значимых событиях, фигурах и вехах мировой истории.`"
**Результат**: ChatGPT должен вызвать инструмент `create_test` и подтвердить создание теста.

***

**Запрос**: "Сгенерируй 10 вопросов о периоде Древнего Рима"
**Результат**: ChatGPT должен вызвать инструмент `add_question` 10 раз и подтвердить, что 10 вопросов были добавлены.

***

*Прикрепите скриншот или фотографию вопросов, которые вы хотите добавить в тест.*
**Запрос**: "Добавь эти вопросы в тест под названием `Викторина по древним цивилизациям`"
**Результат**: ChatGPT должен вызвать инструмент `add_question` несколько раз и подтвердить, что вопросы были добавлены.

***

*Прикрепите книгу, статью или документ в чат.*
**Запрос**: "Создай тест под названием `Основы квантовой физики` с 15 вопросами на основе этого документа"
**Результат**: ChatGPT должен вызвать инструменты `create_test` и `add_question` несколько раз, чтобы создать тест и добавить вопросы.

***

Как видите, MCP сервер позволяет ChatGPT взаимодействовать напрямую с вашей учетной записью Testsplatform, упрощая создание тестов и управление ими через разговор.
Если у вас есть вопросы, не стесняйтесь связаться с нами: [https://app.testsplatform.com/contact-us](https://app.testsplatform.com/contact-us)
