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	대화형 가이드	재시작 불필요
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"] 
    } 
  } 
}

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

HTTP로 연결할 때 녹음 데이터는 Plaud의 MCP 서버(미국 호스팅)를 통해 전달됩니다. Plaud는 요청 완료 후 이 데이터를 저장하지 않으며, 전송 중에만 처리됩니다. 데이터 처리는 Plaud 개인정보 처리방침에 따릅니다.

Claude Web

[claude.ai](https://claude.ai)로 이동하여 왼쪽 사이드바에서 사용자 지정(Customize) -> 커넥터(Connectors)를 클릭하세요. 커넥터(Connectors)를 클릭하고 Plaud Web MCP를 검색하여 연결하세요

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-connect.png?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=002c6e580441b8855f6893353fccbb22" alt="claude-connect" width="2560" height="1529" data-path="assets/claude-connect.png" />
</Frame>

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

<Frame>
  <img src="https://mintcdn.com/plaud/T9vhBbV0G8_IPDu5/assets/claude-authorize.jpeg?fit=max&auto=format&n=T9vhBbV0G8_IPDu5&q=85&s=78a2a4242c986e961063cfaa1df65e07" alt="claude-authorize" width="2560" height="1348" data-path="assets/claude-authorize.jpeg" />
</Frame>

ChatGPT Web

[chatgpt.com](https://chatgpt.com) 왼쪽 사이드바에서 플러그인(Plugins)을 클릭하고 Plaud를 검색하세요

<Frame>
  <img src="https://mintcdn.com/plaud/K9rhUzfIEHohj91s/assets/gpt-connect.png?fit=max&auto=format&n=K9rhUzfIEHohj91s&q=85&s=733f6ac382ba202e7cf9ffd7d3b2e737" alt="gpt-connect" width="2230" height="1250" data-path="assets/gpt-connect.png" />
</Frame>

연결(Connect)을 클릭하고 Plaud로 로그인하세요

---

기타 클라이언트

[Kiro 서버 디렉토리](https://kiro.dev/docs/mcp/servers/)

<Step title="Add the Plaud MCP Server">
  <Frame>
    <img src="https://mintcdn.com/plaud/TwHXjNWgs8jnS7KS/assets/kiro.png?fit=max&auto=format&n=TwHXjNWgs8jnS7KS&q=85&s=3e17df30ca4afe46c1a934f912a73c07" alt="kiro" width="2546" height="1440" data-path="assets/kiro.png" />
  </Frame>
</Step>

빠른 시작

설치 후 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	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로 재설치한 후 재시작하세요.