Hedy MCP 서버: 25개 도구와 API 액세스 개발자 가이드
Hedy MCP 서버 출시를 보완하는 기술 가이드입니다. 전체 25개 도구, OAuth 2.1 로그인, 읽기 및 쓰기 액세스, 호환 클라이언트, MCP와 Hedy API 및 웹훅의 관계를 설명합니다.
https://api.hedy.bot/mcp(EU 계정: https://eu-api.hedy.bot/mcp)에서 실행되며 Claude, ChatGPT, Cursor 등 MCP 클라이언트와 연동됩니다. 최초 출시 발표는 소개 글에서 확인하세요.
Hedy MCP 서버 개발자 가이드
이 글은 최초 MCP 출시 발표를 보완하는 기술 자료입니다. 전체 25개 도구를 갖춘 AI 회의 도우미를 통해 Claude 또는 다른 MCP 호환 클라이언트를 Hedy 회의 데이터에 연결하려는 개발자를 위해, 전체 도구 목록과 인증 모델, 워크플로 패턴을 설명합니다.
Hedy는 Model Context Protocol(MCP)을 통해 Claude 및 다른 AI 어시스턴트와 직접 연결됩니다. 애플리케이션 간에 정보를 수동으로 복사하지 않아도 AI 도구가 회의 데이터에 접근하고, 정리하고, 활용할 수 있습니다.
구체적으로 할 수 있는 일
MCP 서버는 25개 도구를 통해 Claude Desktop 같은 AI 어시스턴트가 Hedy 데이터에 직접 접근할 수 있게 합니다. 다음과 같은 작업이 가능해집니다.
세션 관리
AI 어시스턴트는 회의 녹취록, 요약, 인사이트를 가져올 수 있습니다. Claude에 “지난주 고객 회의에서 예산을 논의한 내용을 찾아 주세요”라고 요청하면 전체 맥락과 함께 해당 세션을 정확히 가져옵니다.
토픽 정리
프로그래밍 방식으로 토픽을 생성하고 관리할 수 있습니다. AI가 관련 회의를 자동으로 정리하고, 이어지는 대화에서 지식 베이스를 구축하고, 여러 세션에 걸친 프로젝트 진행 상황을 추적할 수 있습니다.
주요 내용 활용
저장된 주요 내용과 AI가 생성한 분석에 접근할 수 있습니다. 강의의 주요 내용으로 학습 가이드를 만들거나, 업무 회의의 의사 결정 사항을 정리하거나, 인터뷰에서 핵심 발언을 추출할 수 있습니다.
작업 연동
할 일을 워크플로에 바로 가져올 수 있습니다. AI 어시스턴트가 여러 프로젝트의 할 일을 모으고, 기한이 지난 작업을 찾고, 여러 회의에서 나온 작업을 하나의 목록으로 정리할 수 있습니다.
기술 구현
MCP 서버는 https://api.hedy.bot/mcp에서 실행되며(EU 계정은 https://eu-api.hedy.bot/mcp 사용), OAuth 2.1로 로그인합니다. 서버용 API 키는 없습니다. 설정에는 약 2분이 걸립니다.
- AI 클라이언트의 커넥터 또는 MCP 설정에 서버 URL을 추가하세요
- 열린 브라우저 창에서 Hedy 계정으로 로그인하세요
- 권한을 검토하고 허용을 클릭하세요
- 일상적인 표현으로 회의에 관해 질문해 보세요
API 키만 받거나 로컬 서버만 실행하는 클라이언트는 오픈 소스 mcp-remote 브리지를 통해 연결할 수 있습니다. 설정 가이드에서 클라이언트별 절차와 함께 설명합니다.
이 연동은 세션 단위 질문(“가격에 관해 어떤 이야기를 나눴나요?”)과 여러 세션을 아우르는 분석(“이번 달 고객 회의에서 나온 할 일을 모두 보여 주세요”)을 모두 지원합니다.
개인정보 보호 아키텍처
데이터는 전송 중에도 저장 시에도 암호화됩니다. 어시스턴트는 요청이 있을 때만 데이터를 읽으며, 쓰기 도구는 요약, 할 일, 토픽, 세션 컨텍스트, 어휘를 정리하는 용도로 제한됩니다. 녹음이나 녹취록을 삭제할 수 있는 도구는 없습니다.
액세스 권한은 계정에 연결됩니다. 로그인 과정에서 승인한 클라이언트만 데이터에 접근할 수 있으며, Hedy 설정에서 어느 클라이언트든 액세스 권한을 취소할 수 있습니다.
사용 가능한 도구
MCP 서버는 25개 도구를 제공합니다. 14개는 데이터를 읽고 11개는 데이터를 변경합니다.
세션
GetSessions: 최근 세션을 최신순으로 나열합니다GetSessionDetails: 한 세션의 녹취록, 요약, 메타데이터를 가져옵니다GetSessionHighlights,GetSessionToDos: 한 세션의 주요 내용과 할 일을 가져옵니다UpdateSessionSummary: 세션 요약을 교체합니다. 예를 들어 녹취록에서 잘못 인식한 이름을 수정할 수 있습니다
주요 내용
GetHighlights,GetHighlightDetails: 여러 세션에 걸쳐 저장된 주요 내용을 Hedy의 분석과 함께 가져옵니다
할 일
GetToDos: 여러 세션의 할 일을 가져옵니다UpdateToDoCompletion,UpdateToDoDueDate: 할 일을 완료 처리하거나 기한을 설정합니다
토픽
GetAllTopics,GetTopicDetails,GetTopicSessions: 토픽과 그 안의 세션을 살펴봅니다CreateTopic,UpdateTopic,DeleteTopic: 실시간 세션에서 Hedy가 사용하는 토픽 컨텍스트를 포함해 토픽을 관리합니다(토픽을 삭제해도 세션은 유지됩니다)AssignSessionToTopic: 세션을 토픽에 분류합니다
세션 컨텍스트
ListSessionContexts,GetSessionContext: Hedy가 실시간 제안에 사용하는 저장된 배경 정보를 읽습니다CreateSessionContext,UpdateSessionContext,DeleteSessionContext: 해당 정보를 작성하거나 변경합니다. 예를 들어 내일 통화를 위한 브리핑을 만들 수 있습니다
계정과 어휘
GetAccount: 로그인한 계정을 가져옵니다GetVocabulary,SetVocabulary: Hedy가 인식할 사용자 정의 용어를 읽거나 교체합니다
각 도구에는 읽기 전용인지, 데이터를 덮어쓰는지, Hedy 외부에 접근하는지를 클라이언트에 알려 주는 MCP 주석이 포함됩니다. 클라이언트는 이를 바탕으로 데이터를 변경하는 도구를 실행하기 전에 확인을 요청할 수 있습니다.
실제 활용 사례
연구 분석
연구자는 이 연동을 활용해 연속 강의에서 얻은 내용을 종합합니다. Claude에 “4~6주 차에 논의한 세 가지 이론적 틀을 비교해 주세요”라고 요청하면 여러 세션에서 관련 내용을 가져오고, 개념을 상호 참조하며, 비교 분석을 생성합니다.
고객 관리
컨설턴트는 고객과의 논의 이력을 빠짐없이 관리합니다. AI에 “내일 [고객]과의 회의에 대비해 4분기 전략에 관한 이전 논의를 모두 검토해 주세요”라고 요청하면 관련 맥락, 아직 이행하지 않은 약속, 제안할 논의 주제를 담은 브리핑 문서를 생성합니다.
지식 관리
팀은 조직의 지식을 축적합니다. MCP 연동을 통해 AI 어시스턴트가 일련의 회의를 체계적인 문서로 정리하고, 회고에서 모범 사례를 추출하고, 설계 논의에서 기술 사양을 취합할 수 있습니다.
워크플로 자동화
개발자는 Hedy 데이터를 맞춤형 시스템에 통합합니다. MCP 액세스에 n8n 또는 Make.com을 결합해 회의 인사이트를 프로젝트 관리 도구로 보내고, CRM을 업데이트하거나 후속 작업을 실행하는 자동화 워크플로를 구축하세요.
요구 사항과 호환성
서버는 OAuth 로그인이 가능한 원격 서버를 지원하는 모든 MCP 클라이언트에서 작동합니다. 확인된 클라이언트는 다음과 같습니다.
- Claude(웹, 데스크톱, Claude Code)
- ChatGPT
- Cursor, Windsurf, Zed, Cline
- 유료 요금제의 Perplexity
- MCP SDK로 구축한 맞춤형 클라이언트
MCP 액세스는 Hedy Pro와 Hedy Team에 포함됩니다. 서버가 Hedy 클라우드에서 세션을 읽으므로 클라우드 동기화를 켜야 합니다. 클라우드 동기화가 꺼져 있으면 세션은 기기에 남아 있으며 어떤 연동으로도 접근할 수 없습니다. 무료 요금제에는 MCP가 포함되지 않습니다.
시작하기
설정 가이드에는 클라이언트별 절차, OAuth를 지원하지 않는 클라이언트용 mcp-remote 브리지, 문제 해결 방법이 나와 있습니다.
AI 어시스턴트 대신 직접 작성한 코드에서 사용하려면 API 키로 Hedy API를 이용하세요. 세션 이벤트가 발생할 때마다 시스템으로 전송하려면 웹훅을 사용하세요.
달라지는 업무 방식
MCP 연동은 전문가가 회의에서 얻은 정보를 활용하는 방식을 바꿉니다. 과거 세션을 직접 검색하거나 정보를 문서에 복사하는 대신, AI 어시스턴트가 관련 맥락을 찾고 여러 대화의 정보를 종합하며 실행으로 옮길 수 있는 인사이트를 제시하는 번거로운 작업을 맡습니다.
전문적인 업무가 점점 더 대화를 통해 이루어지기 때문에 이러한 변화는 중요합니다. 회의, 통화, 논의에서 얻은 지식은 조직의 중요한 지적 자산입니다. MCP 연동을 통해 이미 분석, 글쓰기, 의사 결정에 사용하는 AI 도구로 이 지식에 접근할 수 있습니다.
조직에는 회의 데이터가 질의 가능한 지식 베이스가 된다는 의미입니다. 개인에게는 Hedy와 함께한 모든 대화를 현재 업무에 활용할 수 있다는 의미이며, 직접 정리할 필요도 없습니다.
기술 기반
서버는 스트리밍 가능한 HTTP를 통해 MCP로 통신합니다. PKCE와 동적 클라이언트 등록을 갖춘 OAuth 2.1을 구현하므로 클라이언트가 스스로 등록하며, 키를 붙여 넣을 필요가 없습니다. 도구는 텍스트와 함께 구조화된 결과도 반환하므로 이를 읽을 수 있는 클라이언트가 활용할 수 있습니다.
향후 개발
도구 모음은 사용자가 어시스턴트에 요청하는 작업에 맞춰 확장됩니다. 다음에 원하는 기능을 기능 요청 게시판에 알려 주세요.
도움 받기
설정 가이드는 각 클라이언트, 흔히 발생하는 설정 문제, 예시 프롬프트를 다룹니다. 질문이 있다면 Hedy Slack 커뮤니티에 참여하세요.
MCP 액세스는 Hedy Pro와 Hedy Team에 포함됩니다. AI 어시스턴트에 https://api.hedy.bot/mcp를 추가하고 Hedy 계정으로 로그인해 연결하세요.
자주 묻는 질문
Hedy MCP 서버는 몇 개의 도구를 제공하나요?
세션, 주요 내용, 할 일, 토픽, 세션 컨텍스트, 계정, 사용자 정의 어휘의 7개 그룹에 걸쳐 25개 도구를 제공합니다. 이 중 14개는 데이터를 읽고 11개는 데이터를 변경합니다.
Hedy MCP 서버는 쓰기 작업을 지원하나요?
네. AI 어시스턴트는 세션 요약을 다시 작성하고, 할 일을 완료 처리하고 기한을 설정하고, 토픽을 생성·편집·삭제하고, 세션을 토픽에 분류하고, 세션 컨텍스트를 관리하고, 사용자 정의 어휘를 교체할 수 있습니다. 녹음이나 녹취록을 삭제할 수 있는 도구는 없습니다. 웹훅은 MCP가 아닌 Hedy API를 통해 설정합니다.
Hedy MCP 인증은 어떻게 작동하나요?
Hedy MCP 서버는 OAuth 2.1을 사용합니다. AI 클라이언트가 로그인과 권한 검토를 위한 브라우저 창을 열고, 승인을 마치면 액세스 토큰이 발급됩니다. 주기적으로 교체해야 하는 고정 API 키는 없습니다. Hedy 설정에서 언제든지 액세스 권한을 취소할 수 있습니다.
Hedy MCP 서버의 URL은 무엇인가요?
미국 계정은 https://api.hedy.bot/mcp를 사용합니다. EU 내 데이터 보관 계정은 https://eu-api.hedy.bot/mcp를 사용합니다. MCP 호환 클라이언트(Claude, ChatGPT, Cursor, Windsurf, Zed, Cline, Claude Code)에 URL을 추가하고 OAuth로 인증하세요.
Hedy MCP 서버, API, 웹훅은 어떻게 다른가요?
MCP 서버는 AI 어시스턴트용으로, OAuth로 로그인하고 대화 중에 도구를 호출합니다. Hedy API는 직접 작성한 코드에서 사용하며 API 키로 인증합니다. 웹훅은 세션 이벤트가 발생할 때마다 지정한 엔드포인트로 전송합니다. 세 가지 모두 클라우드 동기화가 켜져 있는 유료 Hedy 요금제가 필요합니다.
About the author
Julian Pscheid is the founder and CEO of Hedy AI, a real-time AI meeting coach used by tens of thousands of professionals worldwide. He writes about how AI is changing the way people prepare for, capture, and understand important conversations.