MCP Tools Reference: classroommcp.googleapis.com

Инструмент: create_topic

Создает новую тему в курсе. Темы используются для упорядочивания заданий. Требуется роль преподавателя на курсе.

В примере кода ниже показано, как использовать curl для вызова инструмента MCP create_topic.

Запрос cURL
curl --location 'https://classroommcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_topic",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос на создание темы в курсе.

CreateTopicRequest

JSON-представление
{
  "courseId": string,
  "title": string
}
Поля
courseId

string

Обязательно. Идентификатор курса.

title

string

Обязательно. Название темы. Максимальное количество символов: 100.

Схема вывода

Тема курса.

Тема

JSON-представление
{
  "id": string,
  "title": string
}
Поля
id

string

Только для вывода. Идентификатор. Идентификатор темы.

title

string

Название темы.

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать основные риски, связанные с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы решить, когда пользователю может быть отправлен запрос на подтверждение.

Помимо строки заголовка, определены следующие логические подсказки:

  • readOnlyHint: если задано значение true, инструмент не изменяет свою среду. Значение по умолчанию – false.
  • destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
  • idempotentHint. Если задано значение True, повторный вызов инструмента с теми же аргументами не будет иметь дополнительного эффекта. Значение по умолчанию – false.
  • openWorldHint: если задано значение true, инструмент может взаимодействовать с "открытым миром" внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌

Области авторизации

Требует одной из следующих областей применения OAuth:

  • https://www.googleapis.com/auth/classroom.topics