Plaud MCP

Plaud MCP

Plaud 녹음을 모든 MCP 호환 AI 클라이언트(Claude, Cursor, ChatGPT, Codex 등)에 연결하세요. AI 어시스턴트를 떠나지 않고 녹음을 검색하고, 대본을 읽고, 문서를 생성할 수 있습니다.

지원 클라이언트

클라이언트	자동 구성됨	설치 후 다시 시작
Claude Desktop	✓	⌘Q + 다시 열기
Claude Code	✓	종료 + 새 claude 세션
Codex Desktop	✓	종료 + 다시 열기
Cursor / Windsurf / VS Code / Zed	✓	클라이언트 UI별로 다시 로드
Claude Web / ChatGPT Web	대화형 가이드	다시 시작 불필요

---

사전 요구 사항

• Node.js ≥ 20 — 다운로드
• Plaud 계정

---

설치

한 번 실행하세요. 설치 프로그램이 AI 클라이언트를 감지하고, MCP 구성을 작성하며, 로그인을 위해 브라우저를 엽니다:

npx -y @plaud-ai/mcp@latest install

브라우저가 열리면 승인을 클릭한 다음, 설치 프로그램 출력에 나열된 클라이언트를 다시 시작하세요. 다음 세션에서 Plaud 도구를 즉시 사용할 수 있습니다.

옵션

플래그	기능
--yes	프롬프트 없이 감지된 모든 로컬 클라이언트 자동 구성
--no-login	브라우저 로그인 단계 건너뛰기 (원격 또는 헤드리스 머신에서 유용)

기타 MCP 클라이언트

클라이언트가 자동 감지되지 않으면, 클라이언트의 MCP 구성에 다음을 붙여넣어 Plaud를 수동으로 추가하세요:

{ "mcpServers": { "plaud": { "command": "npx", "args": ["-y", "@plaud-ai/mcp@latest"] } } }

**HTTP 기반 클라이언트 (Claude Web, ChatGPT Web)**

HTTP를 통해 연결할 때, 녹음 데이터는 Plaud의 MCP 서버(미국에 호스팅됨)를 통과합니다. Plaud는 요청 완료 후 이 데이터를 저장하지 않으며, 전송 중에만 처리됩니다. 데이터 처리는 Plaud의 개인정보 보호정책의 적용을 받습니다.

Claude Web

[claude.ai](https://claude.ai)로 이동하여 왼쪽 사이드바에서 사용자 지정 -> 커넥터로 이동합니다. **사용자 지정 커넥터 추가**를 클릭합니다. 양식을 작성합니다:

* **이름** — `Plaud Web MCP`
* **원격 MCP 서버 URL** — `https://mcp.plaud.ai/mcp`

**추가**를 클릭합니다.

Claude가 브라우저에서 Plaud 승인 페이지를 엽니다. Plaud 계정에 로그인하고 **승인**을 클릭합니다. Claude로 돌아가면 대화에서 Plaud 도구를 사용할 수 있습니다.

ChatGPT Web

[chatgpt.com](https://chatgpt.com) 왼쪽 사이드바에서 앱을 클릭하고 Plaud를 검색합니다. 연결을 클릭하고 Plaud로 로그인합니다.

---

빠른 시작

설치 후 AI 클라이언트에서 로그인하세요:

Plaud에 로그인해 줘

브라우저에 Plaud 승인 페이지가 열립니다. 승인을 클릭하고 클라이언트로 돌아가면 로그인됩니다.

그런 다음 시도해 보세요:

최근 녹음 목록 보여줘

화요일 스탠드업 요약해 줘

이 회의의 액션 아이템으로 후속 이메일 초안 작성해 줘

---

도구

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	Markdown 형식의 AI 생성 노트

---

스킬

스킬은 AI 클라이언트가 일반적인 Plaud 워크플로우를 자동으로 처리하도록 돕는 사전 구축된 지침입니다. 설치 프로그램이 실행될 때 로드되며 추가 단계가 필요하지 않습니다.

스킬	다음과 같은 요청 시 트리거됨…
plaud-browse	"녹음 목록 보여줘", "최근 파일 표시"
plaud-find	"주간 동기화 찾아줘", "월요일 회의"
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 / "인증되지 않음" 오류	AI 클라이언트에 *"Plaud에 로그인해 줘"*라고 요청하세요.
--yes 모드에서 구성된 로컬 클라이언트 없음	지원되는 로컬 클라이언트를 먼저 설치하거나, --yes 없이 실행하여 웹 클라이언트에 대한 대화형 가이드를 받으세요.
토큰 새로 고침 오류	~/.plaud/tokens-mcp.json을(를) 삭제하고 다시 로그인하세요.
로그인 중 브라우저가 열리지 않음	설치 프로그램이 출력하는 URL을 복사하여 수동으로 엽니다. 원격 머신에서는 먼저 포트 8199를 전달하세요: ssh -L 8199:localhost:8199 user@host.
Claude Desktop에서 "서버 연결 끊김"	설정을 다시 실행하세요: plaud-mcp unsetup && plaud-mcp setup, 그런 다음 Claude Desktop을 다시 시작하세요.
업그레이드 후 버전이 업데이트되지 않음	npx -y @plaud-ai/mcp clean-plugin을(를) 실행하고, Claude Code에서 /plugin install plaud을(를) 사용하여 다시 설치한 다음 다시 시작하세요.