# 📋 Padlet MCP Server for Claude Desktop

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

---

## 이게 뭔가요?

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

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

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

---

## 사용하기 전에 필요한 것

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

---

## Padlet API 키 발급 방법

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

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

---

## 설치 방법 (단계별)

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

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

또는 Git이 설치된 경우:
```bash
git clone https://github.com/사용자명/padlet-mcp-server.git
cd padlet-mcp-server
```

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

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

```bash
npm install
```

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

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

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

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

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

```json
{
  "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 수업 연구 프로젝트 — 대구교육대학교 박사과정*