Padlet Server

Claude Desktop에서 Padlet을 자동으로 읽고 쓸 수 있는 MCP 서버입니다. 학생 성찰문 수집, 교사 피드백 자동 댓글, 교수학습 과정안 기반 게시물 자동 생성 등에 활용할 수 있습니다.

---

이게 뭔가요?

MCP(Model Context Protocol) 서버란, Claude AI가 외부 서비스(여기서는 Padlet)와 직접 대화할 수 있게 연결해주는 다리입니다.

이 서버를 설치하면 Claude에게 이렇게 말할 수 있습니다:

• "이 패들렛의 학생 게시물 전부 가져와줘"
• "성찰문을 분석하고 학생마다 댓글 달아줘"
• "교수학습 과정안 내용으로 패들렛에 게시물 만들어줘"

---

사용하기 전에 필요한 것

항목	설명
Padlet 유료 계정	API 키는 유료 플랜(Padlet Neon 이상)에서만 발급 가능합니다
Claude Desktop	claude.ai/download 에서 무료 다운로드
Node.js	nodejs.org 에서 무료 다운로드 (LTS 버전 권장)

---

Padlet API 키 발급 방법

1. Padlet에 로그인합니다
2. 오른쪽 위 프로필 사진 클릭 → 설정(Settings)
3. 왼쪽 메뉴에서 개발자(Developers) 클릭
4. API 키 생성(Generate API Key) 버튼 클릭
5. 생성된 키를 복사해두세요 (pdltp_... 로 시작하는 긴 문자열)

⚠️ API 키는 절대 다른 사람과 공유하거나 인터넷에 올리지 마세요!

---

설치 방법 (단계별)

1단계 — 이 저장소 다운로드

오른쪽 위 초록색 Code 버튼 → Download ZIP 클릭 후 압축 해제

또는 Git이 설치된 경우:

git clone https://github.com/사용자명/padlet-mcp-server.git
cd padlet-mcp-server

2단계 — 의존성 패키지 설치

다운로드한 폴더 안에서 터미널(명령 프롬프트)을 열고 아래 명령어를 실행합니다:

npm install

💡 터미널 여는 방법 (Windows): 폴더에서 주소창을 클릭 → cmd 입력 후 Enter

3단계 — Claude Desktop 설정 파일 수정

아래 경로의 파일을 메모장으로 엽니다:

C:\Users\[내 이름]\AppData\Roaming\Claude\claude_desktop_config.json

파일 안에 아래 내용을 추가합니다 ("mcpServers" 부분):

{
  "mcpServers": {
    "padlet": {
      "command": "node",
      "args": ["C:\\Users\\[내 이름]\\padlet-mcp-server\\index.js"],
      "env": {
        "PADLET_API_KEY": "여기에_발급받은_API_키_붙여넣기"
      }
    }
  }
}

⚠️ [내 이름] 부분을 실제 Windows 사용자 이름으로 바꾸세요.

4단계 — Claude Desktop 재시작

Claude Desktop을 완전히 종료했다가 다시 시작합니다. 왼쪽 하단에 🔨 망치 아이콘이 보이면 연결 성공입니다!

---

사용 예시

학생 성찰문 읽기

Claude에게 말하기:

"패들렛 https://padlet.com/username/boardname 의 게시물 전부 가져와줘"

학생별 피드백 댓글 달기

Claude에게 말하기:

"각 학생 성찰문을 분석하고, 학생 이름으로 맞춤 피드백 댓글을 달아줘"

교수학습 과정안 기반 게시물 자동 생성

Claude에게 말하기:

"이 수업 내용을 바탕으로 패들렛 boardId 에 오늘 학습 정리 게시물을 만들어줘"

---

제공되는 기능 (도구 목록)

도구 이름	기능
get_padlet_posts	특정 패들렛의 게시물 전체 읽기
create_padlet_post	새 게시물 자동 생성
create_padlet_comment	특정 게시물에 댓글 자동 등록

---

패들렛 보드 ID 찾는 방법

패들렛 주소에서 마지막 부분이 보드 ID입니다:

https://padlet.com/username/abcd1234efgh5678
                            ↑ 이 부분이 보드 ID

---

주의사항

• API는 관리자 권한이 있는 패들렛에서만 사용 가능합니다
• 댓글을 너무 빠르게 많이 달면 API 속도 제한(Rate Limit)에 걸릴 수 있습니다. 잠시 기다렸다가 재시도하세요
• API 키는 절대 코드 안에 직접 적지 마세요

---

문의 / 개선 제안

Issues 탭에 남겨주시면 확인하겠습니다.

---

초등 교사의 AI 수업 연구 프로젝트 — 대구교육대학교 박사과정