MCP Tools Reference: classroommcp.googleapis.com

도구: list_courses

사용자의 수업을 세부정보(섹션, 교실, 과목, 학년, 설명, 학습 목표, 상태, 사용자의 역할)와 함께 나열합니다. 이 메서드를 기본 진입점으로 사용하여 강의를 검색하고 ID를 가져옵니다. 강의는 제목을 공유하는 경우가 많으므로 섹션을 사용하여 구분하세요. courseState가 설정되지 않은 경우(예: ARCHIVED) ACTIVE 과정만 반환합니다.

사용자를 클래스룸 웹 앱의 수업에 연결하려면 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")입니다. 이 요청의 날짜는 이 시간대로 해석되고 응답의 날짜는 이 시간대로 형식이 지정되어 사용자가 클래스룸에서 보는 것과 일치합니다.

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

식별자. 이 수업의 식별자입니다.

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 교육 개념 또는 역량을 나타내는 스킬입니다. 클래스룸에서 교사만 기술을 추가하거나 삭제할 수 있습니다.

도구 주석

도구 주석은 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.courses.readonly
  • https://www.googleapis.com/auth/classroom.rosters.readonly