Help Center

Wave Agents 툴킷: 내 데이터를 어떤 도구와도 연결하기

Wave 녹음을 다른 도구로 가져오는 세 가지 방법을 소개합니다. AI 어시스턴트용 MCP, 직접 작성하는 코드용 REST API, 터미널용 CLI가 있습니다.

최종 업데이트:

Wave AI가 기록하는 모든 데이터(전사, 요약, 할 일, 화자 라벨, 오디오 및 동영상 파일)는 Wave 앱 밖에서도 읽을 수 있습니다. Wave Agents는 이를 위한 세 가지 방법을 묶어 부르는 이름입니다. AI 어시스턴트용 MCP, 직접 작성하는 코드용 REST API, 스크립트용 명령줄 도구가 있습니다. 세 가지 모두 본인 계정에서 동작하고, 직접 부여하고 취소할 수 있는 권한을 사용하며, 모든 Wave 요금제에서 무료입니다.

연결하려는 도구에 맞는 방법을 선택하세요.

MCP — AI 어시스턴트용

Model Context Protocol(MCP)을 사용하면 AI 어시스턴트가 대화 중에 Wave 라이브러리를 조회할 수 있습니다. Claude, ChatGPT, Claude Code, Codex, Cursor, Grok, Muse, Perplexity를 비롯해 대부분의 코딩 에디터가 MCP를 지원합니다. URL 하나(https://mcp.wave.co)와 브라우저 로그인만으로 설정이 끝납니다. 코드나 설정 파일은 필요 없습니다.

연결하면 어시스턴트가 의미 기반으로 회의를 검색하고, 최근 세션 목록을 보고, 요약을 열고, 화자 라벨이 붙은 전사를 가져오고, 할 일을 읽고, 특정 인물이 참여한 세션을 찾을 수 있습니다. 다음 작업도 할 수 있습니다.

  • 세션에 할 일 기록하기
  • 세션의 제목, 메모, 요약, 태그를 수정하고 즐겨찾기로 표시하기
  • 폴더를 만들고 이름을 바꾸고 삭제하기, 폴더를 다른 폴더 안에 하위 폴더로 넣기, 세션을 폴더에 정리하기
  • 요청할 때 세션 공유하기
  • 별도 권한을 부여한 경우 Wave로 녹음 가져오기(아래 참고)

세션을 삭제하거나 전사나 오디오를 변경할 수는 없으며, 폴더를 삭제해도 그 안의 세션은 삭제되지 않습니다. Wave MCP 서버에는 총 23개의 도구가 있으며, 전체 목록은 api.wave.co/mcp에서 확인할 수 있습니다.

요청 범위를 폴더나 태그로 한정하면 어시스턴트가 개인 녹음에 접근하지 않게 할 수 있습니다. MCP 도구 자체가 폴더와 태그 필터를 지원하므로 "업무 폴더의 세션만 사용해 줘"처럼 요청하면 됩니다. 하위 폴더가 있는 폴더를 지정하면 하위 폴더의 세션도 포함되며, "Clients/Acme"처럼 경로로 하위 폴더를 지정할 수도 있습니다. Wave 폴더 알아보기를 참고하세요.

설정 가이드: Claude, Claude Code, ChatGPT, Codex, Cursor, Grok, Muse, Gemini CLI를 포함한 기타 AI 도구.

기본 제공 프롬프트

Wave는 요청을 직접 입력하는 대신 바로 시작할 수 있는 6가지 프롬프트를 제공합니다. MCP 프롬프트를 지원하는 도구에서 표시됩니다. Claude에서는 채팅의 + 메뉴를 열고, Claude Code에서는 /를 입력한 뒤 Wave 항목을 찾으세요.

프롬프트기능
Weekly recap(주간 요약)특정 날짜 이후(기본값: 최근 7일) 녹음 전반의 주제, 결정 사항, 미완료 할 일
Prep for a meeting(회의 준비)지난 녹음을 바탕으로 한 특정 인물이나 주제에 대한 브리핑
후속 이메일 초안 작성세션 하나의 요약, 결정 사항, 다음 단계를 바로 보낼 수 있게 정리
Action items to tasks(할 일을 작업으로)세션 하나 또는 최근 세션의 할 일을 깔끔한 작업 목록으로 정리
What did someone say(누가 무슨 말을 했나)특정 인물이 어떤 주제에 대해 한 말을 인용과 함께 정리
Decisions log(결정 기록)폴더 또는 특정 날짜 이후(기본값: 최근 30일) 세션의 결정 사항을 날짜별로 정리

Claude Code용 Wave 플러그인과 Gemini CLI용 Wave 확장 프로그램은 같은 6가지 프롬프트를 스킬로 추가합니다.

세션 수정하기

어시스턴트에게 세션 이름 변경, 메모 정리, 요약 재작성, 태그 변경, 즐겨찾기 표시를 요청할 수 있습니다. 요청한 항목만 변경됩니다. Wave가 녹음을 처리하는 중에는 새 제목이나 요약을 저장할 수 없습니다. 처리가 끝나면 덮어써지기 때문입니다. 이 경우 어시스턴트가 알려 주며, 몇 분 후 다시 시도하면 됩니다. 메모, 태그, 즐겨찾기는 언제든 변경할 수 있습니다.

녹음 가져오기

어시스턴트가 Wave에 녹음을 대신 추가할 수 있습니다. 오디오나 동영상 파일 링크(예: 팟캐스트 에피소드나 직접 다운로드 링크)에서 가져올 수 있고, Claude Code나 Codex처럼 로컬 파일을 업로드할 수 있는 도구에서는 컴퓨터의 파일에서도 가져올 수 있습니다. 그러면 Wave가 다른 가져오기와 똑같이 텍스트로 변환하고 요약합니다.

가져오기에는 읽기·쓰기와는 별도의 권한이 필요합니다. Wave는 Wave로 녹음 가져오기(가져오기 한도 사용) 항목이 표시된 동의 화면에서 이 권한을 요청합니다. 이 연결은 제가 직접 [도구]에서 시작했습니다에 체크하고 Allow [tool]([도구] 허용)을 선택하기 전에는 아무것도 가져올 수 없습니다. 가져오기는 Wave 앱에서 가져올 때와 같은 가져오기 한도를 사용합니다. 사용 중인 도구가 이 권한을 요청하지 않으면 녹음 가져오기 허용에 체크한 개인 액세스 토큰을 대신 사용할 수 있습니다(기타 AI 도구 참고). ChatGPT는 녹음을 가져오지 않습니다.

개발자 API — 직접 작성하는 코드용

https://api.wave.co/v1에서 제공하는 REST API로, Wave 설정에서 만든 범위 지정 토큰으로 인증합니다. 세션을 CRM에 동기화하거나, 전사를 백업하거나, 대시보드를 만들거나, 맞춤 에이전트에 데이터를 제공할 때 사용하세요.

세션 목록 조회 및 필터링, 요약, 전사, 할 일, 의미 기반 검색, 폴더, 공유, 통계, 한 번의 요청으로 최대 50개 세션 일괄 내보내기, 오디오·동영상용 서명된 다운로드 URL, 녹음 가져오기를 지원합니다. 녹음 처리가 끝나는 즉시 서버로 웹훅을 보내며, 원하면 전사와 할 일도 함께 보낼 수 있어 폴링할 필요가 없습니다.

시작하기: Wave Developer API.

CLI — 터미널용

@waveai/cli는 npm으로 설치하며, 스크립트, cron 작업, 일회성 내보내기에 쓸 수 있는 wave 명령을 제공합니다. 데이터를 반환하는 모든 명령에 --json 플래그가 있어 다른 셸 도구와 함께 사용할 수 있습니다.

시작하기: Wave CLI.

Slack — 팀이 대화하는 곳에서 질문하기

Slack에서 DM으로, 스레드에서 @Wave로, 또는 /wave로 회의에 대해 Wave에게 물어보세요. 답변은 본인의 녹음에서만 가져오며 공유하기 전까지 비공개로 유지됩니다. Wave가 녹음이 끝날 때마다 요약을 게시하도록 할 수도 있습니다.

시작하기: Slack에서 Wave 사용하기.

Zapier — 코드 없는 자동화용

Zapier는 세션 처리가 끝날 때마다 New Session Ready(새 세션 준비됨) 트리거를 실행하며, 제목, 요약, 화자 라벨이 붙은 전사, 메모, 링크를 함께 전달합니다. 코드 없이 요약을 채널에 게시하거나, 시트에 행을 추가하거나, CRM에 메모를 기록할 수 있습니다. Zapier는 Wave 계정으로 로그인하므로 관리할 토큰이 없습니다.

시작하기: Zapier로 Wave 자동화하기.

공유

세 가지 모두 공유 기능도 지원합니다. 다른 Wave 사용자가 공유한 세션을 읽기 전용으로 볼 수 있고, 내 세션을 공유할 수도 있습니다. 초대 링크를 만들고, 이메일로 초대하고, 액세스 권한이 있는 사람을 확인하고, 사람을 제거할 수 있습니다. AI 어시스턴트는 무언가를 공유하기 전에 먼저 확인합니다. Claude, ChatGPT, API, CLI에서 세션 공유하기를 참고하세요.

할 수 있는 일과 할 수 없는 일

직접 연결하기 전에는 아무것도 연결되지 않으며, 모든 연결은 본인 계정으로 범위가 제한됩니다. 다른 사람의 녹음 중 접근할 수 있는 것은 그 사람이 나와 공유하기로 한 세션뿐입니다.

권한은 기본적으로 읽기 전용이 아닙니다. API 토큰을 만들 때 원하는 권한을 직접 선택하며, 목록에는 세션 및 할 일 쓰기, 세션 삭제, 폴더 관리, 세션 공유 및 액세스 관리가 있습니다. 녹음 가져오기는 별도 권한이며 직접 선택하지 않으면 포함되지 않습니다. 브라우저로 CLI에 로그인하면 세션 삭제를 포함한 모든 권한이 부여됩니다. MCP는 권한 범위가 가장 좁습니다. 할 일 기록, 세션 수정, 폴더 정리, 세션 공유는 할 수 있지만 세션을 삭제할 수는 없으며, 녹음 가져오기는 허용한 경우에만 할 수 있습니다.

연동에 실제로 필요한 권한만 부여하세요. 세션 삭제 권한이 있는 토큰은 녹음을 영구적으로 삭제할 수 있으며, API로 삭제하면 앱 내 휴지통과 다르게 동작합니다. 최근 삭제된 항목을 참고하세요.

웹에서 언제든 권한을 취소할 수 있습니다. 로그인한 AI 앱은 설정 → 통합 → 연결된 AI 앱에 표시되며, 각 앱의 권한, 연결 시점, 마지막 사용 시점을 확인할 수 있습니다. 연결 해제를 선택하면 즉시 접근 권한이 사라집니다. AI 도구용 개인 액세스 토큰은 같은 페이지의 고급: 개인 액세스 토큰에 있습니다. API 및 CLI 토큰은 설정 → 개발자 → API 토큰 및 웹훅에 있습니다.

AI 어시스턴트에게 문서 전달하기

api.wave.co의 모든 페이지 헤더에는 복사 버튼이 있습니다. 버튼 이름은 Copy integration docs(연동 문서 복사)이고, MCP 페이지에서는 Copy MCP docs(MCP 문서 복사)입니다. 엔드포인트, 범위, 페이로드 형식, 예시 등 플랫폼 전체를 설명하는 일반 텍스트가 복사되므로, Claude나 ChatGPT에 붙여 넣고 "연동 코드를 작성해 줘"라고 요청하면 됩니다. 같은 텍스트는 api.wave.co/llms.txt에도 있으며, 전체 대화형 레퍼런스는 api.wave.co/reference에서 확인할 수 있습니다.

지원

설정에 도움이 필요하면 app.wave.co의 앱 내 채팅을 이용하거나 support@wave.co로 이메일을 보내세요. API, MCP, CLI 기반 개발에 관한 질문은 가장 완전한 최신 레퍼런스인 api.wave.co를 참고하세요.

이 문서가 도움이 되었나요?

도움이 더 필요하신가요?

이메일로 문의하기

이 페이지의 내용