# 플레이그라운드
> **이 장에서 배우는 것**
> 연결한 도구를 에이전트 없이 직접 불러보는 자리, 그리고 언제 쓰는지.
도구를 붙인 뒤 이 화면에서 목록을 확인하고 시험합니다.
## 도구를 직접 눌러봅니다
[MCP 서버를 붙이면](/guide/cn-mcp) 도구가 여러 개 들어옵니다. 그런데 붙인
직후에는 이런 것들을 모릅니다.
```
□ 이 도구가 실제로 동작하나 (자격증명이 맞나)
□ 인자를 무엇을 넣어야 하나
□ 결과가 어떤 모양으로 오나
□ 얼마나 큰 결과가 오나
```
**플레이그라운드는 그걸 대화 없이 직접 확인하는 자리**입니다. 도구를 고르면
인자 입력란이 나오고, 값을 넣고 실행하면 결과가 그대로 보입니다.
## 입력란이 자동으로 만들어집니다
도구가 선언한 인자 명세를 읽어 **타입에 맞는 입력란**을 그립니다.
| 인자 타입 | 입력 형태 |
|---|---|
| 문자열 | 텍스트 입력 |
| 숫자 | 숫자 입력 |
| 참/거짓 | 토글 |
| 정해진 값 중 하나 | 선택 목록 |
| 목록·객체 | 구조 입력 |
**필수 인자가 무엇인지도 표시됩니다.** [도구 설명이 부실하면 모델이 인자를
자주 틀린다](/guide/mcp-capabilities)고 했는데, 여기서 눌러보면 그게 눈에
보입니다.
## 언제 쓰나
### 1. 도구를 붙인 직후
```
붙임 → 플레이그라운드에서 한 번 호출 → 성공 확인 → 그 다음 대화에서 사용
```
**대화에서 처음 시험하지 마세요.** 실패했을 때 원인이 도구인지 모델의 판단인지
구분이 안 됩니다. 플레이그라운드에서 먼저 확인하면 **도구 문제는 여기서
걸립니다.**
### 2. 결과 크기를 볼 때
[도구 결과가 크면 덜어냅니다](/guide/cn-tool-settings). 어떤 도구가 얼마나
큰 결과를 내는지 미리 보면, 범위 인자를 쓸지 판단할 수 있습니다.
### 3. 자격증명이 만료됐는지 확인
[분기 점검에서 가장 흔한 문제](/guide/cn-tool-settings)가 토큰 만료입니다.
플레이그라운드에서 한 번 부르면 바로 드러납니다.
### 4. 도구 설명을 고칠 때
직접 불러보면 **이 도구가 언제 쓰여야 하는지**가 명확해집니다. 그걸 설명에
반영하면 모델의 선택이 정확해집니다.
## 대화와 무엇이 다른가
| | 대화 | 플레이그라운드 |
|---|---|---|
| 도구를 고르는 주체 | **모델** | **나** |
| 인자를 정하는 주체 | 모델 | 나 |
| 실패했을 때 | 원인이 섞임 | **도구 문제로 확정** |
| 쓰는 목적 | 일을 시킴 | **확인** |
**"모델의 판단"을 빼고 도구만 남긴 것**이 플레이그라운드입니다.
## 주의할 것
### 실제로 실행됩니다
시험이라고 안전한 게 아닙니다. **쓰기 도구를 누르면 실제로 씁니다.**
```
✓ 조회 도구 — 마음껏 눌러보세요
⚠ 생성·발송·삭제 도구 — 실제로 일어납니다
```
[도구는 권한](/guide/mcp-security)이라는 관점이 여기서도 그대로입니다.
되돌릴 수 없는 도구는 시험용 값으로도 함부로 누르지 마세요.
### 사용량에 잡힙니다
플레이그라운드 호출도 [사용량](/guide/cn-usage)에 기록됩니다. 큰 결과를 여러 번
불러보면 그만큼 비용입니다.
---
## 확인
**1. 도구를 붙인 뒤 대화에서 바로 시험하면 안 되는 이유는?**
답
**실패했을 때 원인이 도구인지 모델의 판단인지 구분되지 않기** 때문입니다.
플레이그라운드는 모델을 빼고 도구만 부르므로, 여기서 실패하면 도구 문제로
확정됩니다.
**2. 플레이그라운드가 대화와 다른 핵심은?**
답
**도구와 인자를 모델이 아니라 내가 고른다는 것**입니다. 모델의 판단을 빼고 도구만
남긴 자리입니다.
**3. 시험이라도 조심해야 하는 도구는?**
답
**되돌릴 수 없는 것** — 생성·발송·삭제·결제입니다. 플레이그라운드에서도 실제로
실행됩니다.
---
어떤 도구를 켜둘지 정합니다 → [도구 켜고 끄기](/guide/cn-tool-settings)