Padlet MCP에 관리자 분석(베타)을 요청하려면 어떻게 해야 하나요?

학교 또는 팀 관리자 대시보드에서 원하는 방식으로 수치를 분류해 보여 주지 않나요? Padlet MCP를 AI 어시스턴트에 연결해 학교, 강의실 또는 팀 분석을 일상적인 표현으로 요청하거나, 조직 분석 API를 직접 호출해 보세요.

대상

이 문서는 다음 사용자를 위한 것입니다.

• Padlet for Schools 또는 팀 계정의 소유자 및 관리자
• Classroom 계정의 소유자 및 교사

MCP 경로를 사용하기 위해 코드를 작성할 필요는 없습니다. API 경로는 이미 Public API를 사용하는 고급 사용자를 위한 선택 사항입니다.

이미 이용할 수 있는 기능

설정의 조직 분석 페이지에서는 현재 결제 기간에 맞춰 엄선된 탭을 제공합니다. 학교와 강의실에는 개요, 사용량, 영향, 안전, 상위 사용자, 전체 사용자 탭이 표시됩니다. 팀에는 일반, Padlet, 사용자 탭이 표시됩니다.

• 학교 계정 분석 (Padlet for Schools 및 Classroom)
• 팀 계정 분석

빠르게 시각적 현황을 확인하려면 대시보드를 사용하세요. 탭만으로 원하는 항목을 명확히 확인하기 어려운 경우에는 MCP 또는 API를 사용하세요.

MCP/API의 추가 기능

대시보드에서는 엄선된 탭을 제공합니다. MCP와 API를 사용하면 필요한 항목만 정확히 요청할 수 있습니다.

• AI 클라이언트에서 일상적인 표현으로 질문하기 (“지난 결제 기간에 비활성 상태였던 교사는 누구인가요?”)
• 참여도, 멤버십, 콘텐츠 안전 측정항목을 원하는 대로 조합하기
• 날짜 범위에 걸친 월별 추이 확인하기
• 역할별 분류 (교사와 학생, 제작자와 기여자)
• 요청한 기준에 따라 순위를 매긴 상위 padlet, 상위 사용자, 상위 미디어 확인하기
• 분기별 비즈니스 검토(QBR) 또는 갱신 자료에 바로 붙여 넣을 수 있는 답변 받기

Padlet MCP 빠른 시작

1. AI 클라이언트에서 Padlet MCP를 연결하세요. 서버 URL은 https://mcp.padlet.com입니다. 전체 설정 단계는 Padlet MCP 서버에서 확인하세요.
2. 분석을 조회하려는 조직의 관리자로 로그인하고 권한을 승인하세요. Classroom에서는 교사도 분석을 조회할 수 있습니다.
3. 일상적인 표현으로 질문하세요. 내부 도구의 이름을 지정할 필요가 없습니다. 학교, 강의실 또는 팀에 대해 알고 싶은 내용을 AI 어시스턴트에게 말하면 대신 Padlet MCP를 사용해 조회합니다.

예시는 다음과 같습니다.

선택 사항: 조직 분석 API

직접 스크립트를 작성하고 싶으신가요? 관리자 API 키를 사용해 Public API를 이용하세요 (Classroom에서는 교사 키 사용 가능).

1. 설정의 개발자 페이지에서 API 키를 만들거나 복사하세요. 자세한 내용은 Public API 문서를 참고하세요.
2. GET /me?include=organizations를 사용해 조직 ID를 찾으세요. wksp_ ID가 필요합니다. padlet.org의 org_ 조직은 아직 이 엔드포인트에서 지원되지 않습니다.
3. 원하는 측정항목을 포함해 /organizations/{org_id}/analytics로 POST 요청을 보내세요.
4. 응답이 202이거나 meta.pending이 비어 있지 않으면 Retry-After에 지정된 시간만큼 기다린 뒤 동일한 요청을 다시 보내세요. 분석은 비동기적으로 계산되므로 처리 대기 중인 측정항목은 0이 아니라 응답에 포함되지 않습니다. 대기 중인 값을 절대 0으로 간주하지 마세요.

파일럿 액세스

프롬프트 예시

다음은 MCP 클라이언트에 복사해 사용할 수 있는 시작용 프롬프트입니다. 학교, 강의실 또는 팀에 맞게 문구를 조정하고, 고객에게 보여 줄 자료를 준비할 때는 분석 페이지에서 수치를 확인하세요.

• “이번 결제 기간에 우리 학교에서 활성 교사는 몇 명이고 라이선스는 몇 개인가요? 사용량이 감소한 달은 언제인가요?”
• “조직에서 조회수가 가장 많은 padlet은 무엇인가요? 상위 3개 보드/샌드박스를 알려 주세요.”
• “교사 역할을 가진 구성원 중 지난 12개월 동안 Padlet을 사용하지 않은 사람은 누구인가요?”
• “이메일 도메인이 <ouremaildomain.edu>가 아닌 구성원은 몇 명인가요?”

대시보드가 여전히 더 나은 경우

다음 기능을 사용하려면 설정의 분석 페이지를 이용하세요.

• 시각적 개요 배너, 주요 기회 안내, 한 번의 클릭으로 보내는 PD 요청
• 검색, 역할 필터, 원클릭 CSV 다운로드를 지원하는 전체 사용자/사용자 테이블
• 선택한 기간에 활성 및 비활성 교사를 내려받을 수 있는 목록 (학교 및 강의실)
• 파일럿 등록이 필요 없는 보기 — 적격 역할을 가진 사용자는 API 참여 신청 없이 설정 페이지를 이용할 수 있습니다.

시연이나 갱신 논의에 필요한 정확한 질문에 엄선된 탭이 답해 주지 못할 때 MCP와 API가 유용합니다.

제한사항:

• 요청 제한: API 키 및 조직별 시간당 요청 60회. 202 이후의 상태 확인 요청도 포함됩니다.
• 날짜 범위: 요청당 최대 24개월
• 콘텐츠 안전: 학교 및 강의실만 해당 — 팀에서 해당 측정항목을 요청하면 400 오류가 반환됩니다.
• 멤버십 수: 과거 특정 시점의 구성원 현황이 아닌 현재 명단을 반영합니다.
• 대기 중 ≠ 0: 계산 중인 측정항목은 응답에 포함되지 않습니다. 이를 0으로 간주하지 마세요.
• 조직 유형: 현재는 wksp_만 지원합니다.

자주 묻는 질문

관련 문서

• Padlet MCP 서버
• 학교 계정 분석
• 팀 계정 분석
• Public API
• 조직 분석 읽기 (개발자 문서)