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✓재시작할 필요 없음

사전 요구 사항


설치

한 번만 실행하면 됩니다. 설치 프로그램이 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를 검색한 다음 연결하세요.

claude-connect

3. 인증

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

claude-authorize

ChatGPT Web

1. ChatGPT Web 열기

chatgpt.com

2. Plaud 플러그인 찾기

왼쪽 사이드바에서 Plugins를 클릭하고 Plaud를 검색하세요.

gpt-connect

3. 연결

Connect를 클릭하고 Plaud 계정으로 로그인하세요.


기타 클라이언트

[accordion] Kiro 설정

1. Kiro Server Directory 방문

Kiro Server Directory

2. Plaud MCP 서버 추가

kiro

빠른 시작

설치가 완료되면 AI 클라이언트에서 로그인하세요.

Plaud에 로그인해 줘

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

그런 다음 다음을 시도해 보세요.

최근 녹음을 나열해 줘

화요일 스탠드업을 요약해 줘

이 회의의 실행 항목을 바탕으로 후속 이메일 초안을 작성해 줘


도구

Plaud MCP에 연결하면 AI 클라이언트에서 다음 도구를 사용할 수 있습니다.

도구설명
loginOAuth 로그인을 위해 브라우저 열기
logout로그아웃하고 인증 취소
get_current_user현재 계정 정보 표시
list_files선택적 필터를 적용해 녹음 목록 표시
get_file단일 녹음의 전체 세부 정보 반환
get_noteAI가 생성한 요약, 실행 항목, 주요 주제 반환
get_transcript타임스탬프와 화자 레이블이 포함된 전체 녹취록 반환

list_files으로 녹음 필터링

매개변수설명
query녹음 이름에서 대소문자를 구분하지 않는 키워드 일치
date_from시작 날짜, YYYY-MM-DD
date_to종료 날짜, YYYY-MM-DD
page / page_size페이지네이션(필터가 설정되면 무시됨)

데이터 참조

list_files 및 get_file에서 반환되는 필드

필드유형설명
idstring고유한 녹음 ID
namestring녹음 이름
created_atstring생성 시간(ISO 8601)
start_atstring녹음 시작 시간(ISO 8601)
durationnumber밀리초 단위의 길이
serial_numberstring기기 일련번호

get_file에서만 반환되는 추가 필드

필드유형설명
presigned_urlstring임시 오디오 다운로드 URL(24시간 동안 유효)
source_listarray타임스탬프와 화자 레이블이 포함된 녹취록 세그먼트
note_listarrayAI가 생성한 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 Desktopplaud-mcp unsetup
Claude Codeclaude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin
Codex Desktopplaud-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에서 빌드 및 호스팅됩니다.