MCP Tools Reference: classroommcp.googleapis.com

ツール: list_courses

ユーザーのコースとその詳細(セクション、教室、教科、学年レベル、説明、学習目標、状態、ユーザーのロール)を一覧表示します。このメソッドは、コースを検出してその ID を取得するための主なエントリ ポイントとして使用します。コースのタイトルは同じになることが多いため、セクションを使用して区別します。courseState が設定されていない限り(例: ARCHIVED)、ACTIVE コースのみを返します。

Classroom ウェブアプリのコースにユーザーをリンクするには、https://classroom.google.com/c/{course_id}(ストリーム)または https://classroom.google.com/w/{course_id}/t/all([授業] ページ)を使用します。ID は返されたとおりに使用します。推測したり変更したりしないでください。

次のコードサンプルは、curl を使用して list_courses MCP ツールを呼び出す方法を示しています。

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": "list_courses",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

コースの一覧を取得するリクエスト。

ListCoursesRequest

JSON 表現
{
  "courseState": enum (State),
  "createdDateRange": {
    object (DateRange)
  },
  "timeZone": string,
  "titleContains": string,
  "pageSize": integer,
  "pageToken": string
}
フィールド
courseState

enum (State)

省略可。コースのステータスでフィルタします。デフォルトは ACTIVE です。

createdDateRange

object (DateRange)

省略可。作成日の範囲でフィルタします。

timeZone

string

必須。ユーザーの IANA タイムゾーン(例: "America/Los_Angeles")。このリクエストの日付はこのタイムゾーンで解釈され、レスポンスの日付はこのタイムゾーンでフォーマットされます。これは、ユーザーが Classroom で表示する内容と一致します。

titleContains

string

省略可。大文字と小文字を区別しない部分文字列でタイトルをフィルタします。

pageSize

integer

省略可。ページサイズを制御します。デフォルトは 10、最大は 50 です。

pageToken

string

省略可。ページ設定用のトークン。

DateRange

JSON 表現
{
  "startDate": string,
  "endDate": string
}
フィールド
startDate

string

期間の開始日(この値を含む、形式: YYYY-MM-DD)。

endDate

string

範囲の終了日(YYYY-MM-DD 形式)。

州

コースの状態。

列挙型
STATE_UNSPECIFIED 未指定の状態
ACTIVE アクティブ状態。
ARCHIVED アーカイブ状態。
PROVISIONED プロビジョニングされた状態。

出力スキーマ

コースを一覧表示するレスポンス。

ListCoursesResponse

JSON 表現
{
  "courses": [
    {
      object (Course)
    }
  ],
  "nextPageToken": string
}
フィールド
courses[]

object (Course)

コースのリスト。

nextPageToken

string

次のページトークン。

コース

JSON 表現
{
  "id": string,
  "title": string,
  "role": enum (Role),
  "creationDate": string,
  "state": enum (State),
  "section": string,
  "room": string,
  "subject": string,
  "gradeLevels": string,
  "description": string,
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ]
}
フィールド
id

string

ID。このコースの識別子。

title

string

コースのタイトル。

role

enum (Role)

このコースでのユーザーの役割。

creationDate

string

コースの作成日(形式: YYYY-MM-DD)。作成日が不明な場合は空です。

state

enum (State)

出力専用。コースの状態。

section

string

省略可。セクション。

room

string

省略可。コースの教室。

subject

string

省略可。コースの件名。

gradeLevels

string

省略可。コースの学年レベル。

description

string

省略可。コースの説明。

learningGoals[]

object (LearningGoal)

出力専用。このコースに添付されている学習目標。

LearningGoal

JSON 表現
{
  "id": string,
  "type": enum (Type),
  "standardCode": string,
  "title": string,
  "documentTitle": string
}
フィールド
id

string

出力専用。学習目標の ID。標準を添付するには、search_course_standards の id を使用します(standardCode ではありません)。

type

enum (Type)

出力専用。学習目標のタイプ。

standardCode

string

出力専用。標準コード(例: 「NY-2.NBT.4」)。標準の場合のみ、値が入力されます。

title

string

出力専用。基準のステートメントの説明、またはスキルの人が読める形式のタイトル。

documentTitle

string

出力専用。カリキュラム ドキュメントの名前。標準の場合のみ、値が入力されます。

ロール

コース内のユーザーのロール。

列挙型
ROLE_UNSPECIFIED ロールが指定されていません。
TEACHER 講師の役割。
COTEACHER 副担任の役割。
STUDENT 受講生の役割。
INVITED_OR_INACTIVE 招待されたロールまたは無効なロール。

州

コースの状態。

列挙型
STATE_UNSPECIFIED 未指定の状態
ACTIVE アクティブ状態。
ARCHIVED アーカイブ状態。
PROVISIONED プロビジョニングされた状態。

タイプ

学習目標のタイプ。

列挙型
TYPE_UNSPECIFIED 学習目標タイプが指定されていません。
STANDARD 学術カリキュラムの学習基準。
SKILL 教育的なコンセプトや能力を表すスキル。Classroom でスキルを追加または削除できるのは教師のみです。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値ヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的な影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/classroom.courses.readonly
  • https://www.googleapis.com/auth/classroom.rosters.readonly