Plaud MCP
공식Plaud 녹음을 MCP 호환 AI 클라이언트에 연결하세요. AI 어시스턴트를 떠나지 않고 녹음 검색, 대본 읽기, 문서 생성이 가능합니다.
Plaud MCP(으)로 무엇을 할 수 있나요?
- 녹음 목록 보기 — 어시스턴트에게 최근 Plaud 녹음 목록을 요청하세요. 키워드나 날짜 범위로 필터링할 수도 있습니다.
- 녹취록 읽기 — 타임스탬프와 화자 레이블이 포함된 녹음의 전체 녹취록을 가져오세요.
- AI 노트 가져오기 — 녹음의 AI 생성 요약, 실행 항목, 주요 주제를 가져오세요.
- 후속 이메일 초안 작성 — 어시스턴트에게 회의의 실행 항목을 바탕으로 후속 이메일 초안을 작성해 달라고 요청하세요.
- 로그인 관리 — AI 클라이언트에서 Plaud에 로그인하거나 로그아웃하고, 현재 계정 정보를 확인하세요.
문서
Plaud MCP
Plaud 녹음을 Claude, Cursor, ChatGPT, Codex 등 MCP 호환 AI 클라이언트에 연결하세요. AI 어시스턴트를 벗어나지 않고 녹음을 검색하고, 녹취록을 읽고, 문서를 생성할 수 있습니다.
지원되는 클라이언트
| 클라이언트 | 자동 구성 | 설치 후 재시작 |
|---|---|---|
| Claude Desktop | ✓ | ⌘Q를 누른 후 다시 열기 |
| Claude Code | ✓ | 종료 후 새 claude 세션 시작 |
| Codex Desktop | ✓ | 종료 후 다시 열기 |
| Cursor / Windsurf / VS Code / Zed | ✓ | 클라이언트 UI에서 다시 로드 |
| Claude Web / ChatGPT Web | 대화형 가이드 | 재시작할 필요 없음 |
| Kiro | ✓ | 재시작할 필요 없음 |
사전 요구 사항
- Node.js ≥ 20 — 다운로드
- Plaud 계정
설치
한 번만 실행하면 됩니다. 설치 프로그램이 AI 클라이언트를 감지하고 MCP 구성을 작성한 다음, 로그인을 위해 브라우저를 엽니다.
npx -y @plaud-ai/mcp@latest install
브라우저가 열리면 Authorize를 클릭한 다음, 설치 프로그램 출력에 표시된 클라이언트를 재시작하세요. 다음 세션부터 Plaud 도구를 바로 사용할 수 있습니다.
옵션
| 플래그 | 기능 |
|---|---|
--yes | 메시지 표시 없이 감지된 모든 로컬 클라이언트를 자동 구성 |
--no-login | 브라우저 로그인 단계 건너뛰기(원격 또는 헤드리스 머신에서 유용) |
기타 MCP 클라이언트
클라이언트가 자동 감지되지 않으면 클라이언트의 MCP 구성에 다음 내용을 붙여 넣어 Plaud를 수동으로 추가하세요.
{
"mcpServers": {
"plaud": {
"command": "npx",
"args": ["-y", "@plaud-ai/mcp@latest"]
}
}
}
[!NOTE]
HTTP 기반 클라이언트(Claude Web, ChatGPT Web)
HTTP를 통해 연결하면 녹음 데이터가 Plaud의 MCP 서버(미국에서 호스팅됨)를 거칩니다. Plaud는 요청이 완료된 후 이 데이터를 저장하지 않으며, 전송 중에만 처리합니다. 데이터 처리는 Plaud 개인정보 처리방침의 적용을 받습니다.
Claude Web
1. Connectors 열기
claude.ai로 이동한 다음 왼쪽 사이드바에서 Customize -> Connectors를 클릭하세요.
2. Plaud MCP 서버 추가
Connectors를 클릭하고 Plaud Web MCP를 검색한 다음 연결하세요.

3. 인증
Claude가 브라우저에서 Plaud 인증 페이지를 엽니다. Plaud 계정에 로그인하고 Authorize를 클릭하세요. Claude로 돌아오면 대화에서 Plaud 도구를 사용할 수 있습니다.

ChatGPT Web
1. ChatGPT Web 열기
2. Plaud 플러그인 찾기
왼쪽 사이드바에서 Plugins를 클릭하고 Plaud를 검색하세요.

3. 연결
Connect를 클릭하고 Plaud 계정으로 로그인하세요.
기타 클라이언트
[accordion] Kiro 설정
1. Kiro Server Directory 방문
2. Plaud MCP 서버 추가
빠른 시작
설치가 완료되면 AI 클라이언트에서 로그인하세요.
Plaud에 로그인해 줘
브라우저에서 Plaud 인증 페이지가 열립니다. Authorize를 클릭하고 클라이언트로 돌아오면 로그인됩니다.
그런 다음 다음을 시도해 보세요.
최근 녹음을 나열해 줘
화요일 스탠드업을 요약해 줘
이 회의의 실행 항목을 바탕으로 후속 이메일 초안을 작성해 줘
도구
Plaud MCP에 연결하면 AI 클라이언트에서 다음 도구를 사용할 수 있습니다.
| 도구 | 설명 |
|---|---|
login | OAuth 로그인을 위해 브라우저 열기 |
logout | 로그아웃하고 인증 취소 |
get_current_user | 현재 계정 정보 표시 |
list_files | 선택적 필터를 적용해 녹음 목록 표시 |
get_file | 단일 녹음의 전체 세부 정보 반환 |
get_note | AI가 생성한 요약, 실행 항목, 주요 주제 반환 |
get_transcript | 타임스탬프와 화자 레이블이 포함된 전체 녹취록 반환 |
list_files으로 녹음 필터링
| 매개변수 | 설명 |
|---|---|
query | 녹음 이름에서 대소문자를 구분하지 않는 키워드 일치 |
date_from | 시작 날짜, YYYY-MM-DD |
date_to | 종료 날짜, YYYY-MM-DD |
page / page_size | 페이지네이션(필터가 설정되면 무시됨) |
데이터 참조
list_files 및 get_file에서 반환되는 필드
| 필드 | 유형 | 설명 |
|---|---|---|
id | string | 고유한 녹음 ID |
name | string | 녹음 이름 |
created_at | string | 생성 시간(ISO 8601) |
start_at | string | 녹음 시작 시간(ISO 8601) |
duration | number | 밀리초 단위의 길이 |
serial_number | string | 기기 일련번호 |
get_file에서만 반환되는 추가 필드
| 필드 | 유형 | 설명 |
|---|---|---|
presigned_url | string | 임시 오디오 다운로드 URL(24시간 동안 유효) |
source_list | array | 타임스탬프와 화자 레이블이 포함된 녹취록 세그먼트 |
note_list | array | AI가 생성한 Markdown 메모 |
스킬
스킬은 AI 클라이언트가 일반적인 Plaud 워크플로를 자동으로 처리하도록 돕는 사전 제작된 지침입니다. 설치 프로그램 실행 시 로드되므로 추가 단계가 필요하지 않습니다.
| 스킬 | 다음과 같은 요청을 하면 실행됩니다… |
|---|---|
plaud-browse | "내 녹음 목록을 보여 줘", "최근 파일을 보여 줘" |
plaud-find | "Weekly Sync를 찾아 줘", "월요일 회의" |
plaud-read | "녹취록을 보여 줘", "이 녹음을 요약해 줘" |
plaud-digest | "주간 보고서", "이번 주에 어떤 회의가 있었지" |
plaud-followup | "후속 이메일 초안을 작성해 줘", "실행 항목을 나열해 줘" |
plaud-export | "Notion에 저장해 줘", "Slack에 게시해 줘" |
업그레이드
npm install -g @plaud-ai/mcp@latest
업그레이드한 후 AI 클라이언트를 재시작하세요.
Claude Code의 경우:
npx -y @plaud-ai/mcp clean-plugin
그런 다음 Claude Code 내에서 다시 설치하세요.
/plugin install plaud
제거
| 클라이언트 | 정리 명령 |
|---|---|
| Claude Desktop | plaud-mcp unsetup |
| Claude Code | claude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin |
| Codex Desktop | plaud-mcp unsetup codex |
그런 다음 패키지와 로컬 데이터를 제거하세요.
npm uninstall -g @plaud-ai/mcp
rm -rf ~/.plaud
문제 해결
| 증상 | 해결 방법 |
|---|---|
| 설치 후 Plaud 도구가 표시되지 않음 | 클라이언트를 완전히 재시작했는지 확인하세요. 창을 닫았다가 다시 여는 것만으로는 충분하지 않습니다. Claude Code의 경우 종료한 다음 새 claude 세션을 시작하세요. |
401 / "Not authenticated" 오류 | AI 클라이언트에 *"Plaud에 로그인해 줘"*라고 요청하세요. |
--yes 모드에서 구성된 로컬 클라이언트가 없음 | 먼저 지원되는 로컬 클라이언트를 설치하거나, 웹 클라이언트에 대한 대화형 안내를 받으려면 --yes 없이 실행하세요. |
| 토큰 새로 고침 오류 | ~/.plaud/tokens-mcp.json을 삭제하고 다시 로그인하세요. |
| 로그인 중 브라우저가 열리지 않음 | 설치 프로그램이 출력한 URL을 복사해 직접 여세요. 원격 머신에서는 먼저 포트 8199를 포워딩하세요: ssh -L 8199:localhost:8199 user@host. |
| Claude Desktop에서 "Server disconnected" 표시 | 설정을 다시 실행하세요: plaud-mcp unsetup && plaud-mcp setup. 그런 다음 Claude Desktop을 재시작하세요. |
| 업그레이드 후 버전이 업데이트되지 않음 | npx -y @plaud-ai/mcp clean-plugin을 실행하고, Claude Code에서 /plugin install plaud를 사용해 다시 설치한 다음 재시작하세요. |
이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드 및 호스팅됩니다.
