AI 에이전트에서 사용하기(MCP)
Madoake는 MCP(Model Context Protocol)를 지원합니다. Claude 등 AI 에이전트에게 말을 걸기만 하면 예약·세미나 신청·폼 응답을 확인하거나, 예약 페이지·세미나·폼·추적 링크를 만들 수 있습니다.
사용 전에 필요한 것
- Madoake 회사 계정(14일 무료 체험. 여기에서 가입)
- 해당 회사의 멤버로 등록된 Google 계정 또는 Microsoft 계정
- MCP를 지원하는 AI(Claude·ChatGPT·Claude Code·Cursor 등. MCP를 지원하면 어떤 AI든 연결할 수 있습니다)
연결 방법
Madoake는 MCP 표준을 따르므로 MCP를 지원하는 AI라면 어디서든 연결할 수 있습니다. 연결 방법은 다음 2가지입니다.
- URL만으로 연결(OAuth): AI 설정에
https://madoake.com/api/mcp를 입력하면 Madoake 로그인 화면이 열리고, ‘허가하기’를 누르면 연결됩니다. 키 발급은 필요 없습니다. Claude·ChatGPT는 이 방법을 사용합니다. - API 키로 연결: OAuth를 지원하지 않는 AI나 Claude Code·Cursor 등 개발 도구는 관리 화면의 ‘AI 연동’에서 발급한 API 키를
Authorization: Bearer헤더에 넣어 연결합니다.
인증은 OAuth 2.1(동적 클라이언트 등록·PKCE)이며, 통신은 Streamable HTTP입니다.
Claude(claude.ai·Claude Desktop·Claude 모바일 앱)
claude.ai·Claude Desktop·Claude 모바일 앱에서는 Madoake를 ‘커스텀 커넥터’(Custom connector)로 추가하면 Claude와의 대화에서 예약·세미나·폼을 확인하거나 임시 저장 상태로 만들 수 있습니다. 키 발급은 필요 없습니다. 한 번 연결하면 같은 Claude 계정이라면 PC에서도 스마트폰에서도 사용할 수 있습니다.
사용 가능한 Claude 플랜
Free·Pro·Max·Team·Enterprise 모두에서 사용할 수 있습니다. Free에서 추가할 수 있는 커스텀 커넥터는 1개까지입니다.
연결 방법(Free·Pro·Max)
- 1Claude를 열고 왼쪽 아래 메뉴에서 “Customize”(사용자 지정) > “Connectors”(커넥터) 메뉴를 엽니다.
- 2“+ Add”(+ 추가) 버튼을 누르고 “Add custom connector”(커스텀 커넥터 추가) 항목을 선택합니다.
- 3이름에 Madoake 입력 후, 원격 MCP 서버 URL에 다음을 입력하고 “Continue”(계속) 버튼을 누릅니다.
https://madoake.com/api/mcp - 4인증 설정은 Claude가 읽어 온 그대로 두셔도 됩니다. 다시 선택할 때는 “Authentication”(인증) 에서 “Sign in now”(지금 로그인), “OAuth client”(OAuth 클라이언트) 에서 “Register automatically”(자동 등록) 항목을 선택하고 “Add”(추가) 버튼을 누릅니다. API 키나 요청 헤더는 필요 없습니다.
- 5Madoake 로그인 화면이 열립니다. Madoake 회사의 멤버로 등록한 Google·Microsoft 계정으로 로그인하고, 사용할 회사를 선택한 뒤 “Allow”(허가하기) 버튼을 누릅니다.
- 6대화에서 사용할 때는 입력란 왼쪽 아래의 “+”(+) → “Connectors”(커넥터) 에서 Madoake를 켭니다. 대화마다 켜고 끌 수 있습니다.
Team·Enterprise의 경우
커스텀 커넥터는 Claude 조직의 소유자가 “Organization settings”(조직 설정) > “Connectors”(커넥터) 에서 추가합니다(“Add”(추가) → 커스텀 → Web. 입력할 URL은 위와 같습니다). 멤버는 “Customize”(사용자 지정) > “Connectors”(커넥터) 에서 Madoake를 찾아 “Connect”(연결) 버튼을 누르고, 위의 5단계와 같이 Madoake에 로그인합니다. Madoake 데이터는 연결한 사람마다 그 사람이 Madoake에서 볼 수 있는 범위만 다룹니다.
연결 후 이렇게 요청해 보세요
- “Madoake에서 이번 주 예약을 회사명과 유입 경로를 포함해 목록으로 보여 줘”
- “11월 세미나 신청자를 회차별로 알려 줘”
- “12월 3일 14시부터 1시간짜리 온라인 세미나를 임시 저장으로 만들어 줘”
- “Madoake에서 캘린더가 연결되지 않으면 어떻게 해?” (도움말을 찾아보고 답합니다)
Claude가 만든 항목은 임시 저장(비공개) 상태입니다. 공개는 관리 화면에서 내용을 확인한 뒤 진행해 주세요. 삭제·취소·고객에게 메일 발송은 Claude에서 할 수 없습니다.
연결되지 않을 때·연결 해제
- Madoake의 새 기능이 Claude에 나타나지 않을 때는 “Connectors”(커넥터) 목록에서 Madoake 연결을 한 번 해제한 뒤 다시 연결해 주세요.
- 로그인 화면에 회사가 나타나지 않을 때는 그 회사의 멤버로 등록된 계정으로 로그인했는지 확인해 주세요.
- 사용을 중단하려면 Claude의 “Customize”(사용자 지정) > “Connectors”(커넥터) 에서 Madoake의 “Remove”(삭제) 버튼을 누릅니다. Madoake 관리 화면 ‘AI 연동’의 ‘발급한 키’에서 삭제해도 해당 연결은 사용할 수 없게 됩니다.
ChatGPT
ChatGPT에서는 Madoake를 ‘커스텀 MCP 서버’(Custom MCP server)로 추가하면 대화에서 예약·세미나·폼을 확인하거나 임시 저장 상태로 만들 수 있습니다.
사용 가능한 ChatGPT 플랜
Business·Enterprise·Edu의 웹 버전에서 사용할 수 있습니다. Business에서는 워크스페이스 관리자나 소유자가 추가합니다. Pro에서는 읽기만 가능하며 예약 페이지 등은 만들 수 없습니다. 모바일 앱에서는 추가할 수 없습니다.
연결 방법
- 1ChatGPT(웹 버전)에서 “Plugins”(플러그인) 메뉴를 엽니다.
- 2“+”(+) 버튼을 누르고 “Add custom MCP server”(커스텀 MCP 서버 추가) 항목을 선택합니다.
- 3이름에 Madoake 입력 후, “Connection”(연결) 항목에 다음 URL을 입력합니다.
https://madoake.com/api/mcp - 4인증은 OAuth를 선택합니다. API 키는 필요 없습니다.
- 5“I understand and want to continue”(이해했으며 계속 진행합니다) 항목에 체크하고 “Create as a plugin”(플러그인으로 만들기) 버튼을 누릅니다.
- 6Madoake 로그인 화면이 열립니다. Madoake 회사의 멤버로 등록한 계정으로 로그인하고, 사용할 회사를 선택한 뒤 “Allow”(허가하기) 버튼을 누릅니다. 찾은 도구 목록이 표시되면 완료입니다.
- 7대화에서 사용할 때는 입력란에 @ 기호를 입력하고 Madoake를 선택합니다. 선택한 메시지 1건에만 적용되므로, 이어서 요청할 때도 @로 다시 선택해 주세요.
연결 후 이렇게 요청해 보세요
- “@Madoake 이번 주 예약을 회사명과 유입 경로를 포함해 목록으로 보여 줘”
- “@Madoake 11월 세미나 신청자를 회차별로 알려 줘”
- “@Madoake 12월 3일 14시부터 1시간짜리 온라인 세미나를 임시 저장으로 만들어 줘”
예약 페이지 등을 만들 때 ChatGPT가 실행해도 되는지 확인할 수 있습니다. 만든 항목은 임시 저장(비공개) 상태이며, 삭제·취소·고객에게 메일 발송은 할 수 없습니다.
연결 해제
Madoake 관리 화면 ‘AI 연동’의 ‘발급한 키’에서 ChatGPT 연결을 삭제해 주세요. 삭제하면 해당 ChatGPT에서는 더 이상 사용할 수 없습니다.
Claude Code·Cursor·그 밖의 AI(API 키)
Madoake 관리 화면의 ‘AI 연동’에서 API 키를 발급하고, 화면에 표시되는 설정을 복사합니다. 예(Claude Code):
claude mcp add --transport http madoake https://madoake.com/api/mcp --header "Authorization: Bearer mdk_…"
할 수 있는 일
| 도구 | 종류 | 내용 |
|---|---|---|
| search_help | 읽기 | Madoake 도움말 검색(AI가 추측으로 답하지 않도록) |
| get_help | 읽기 | 도움말 문서 읽기 |
| get_organization | 읽기 | 회사명·공개 페이지 URL·멤버(담당자) |
| list_event_types | 읽기 | 예약 페이지 목록 |
| get_available_slots | 읽기 | 예약 페이지의 빈 시간 |
| list_bookings | 읽기 | 예약 목록(고객·유입 경로 포함) |
| list_seminars | 읽기 | 세미나와 회차·신청 인원 |
| list_seminar_registrations | 읽기 | 세미나 신청자 |
| list_forms | 읽기 | 폼 목록과 응답 수 |
| list_form_responses | 읽기 | 폼 응답 |
| list_tracking_links | 읽기 | 추적 링크와 클릭 수·예약 수 |
| create_tracking_link | 만들기 | 추적 링크 만들기 |
| create_event_type | 만들기 | 예약 페이지 만들기(임시 저장) |
| create_seminar | 만들기 | 세미나 만들기(임시 저장) |
| create_form | 만들기 | 폼 만들기(임시 저장). 응답 후 예약 페이지로 안내하거나 세미나 사후 설문으로도 사용 가능 |
요청 예시
- “앞으로의 예약을 회사명과 유입 경로를 포함해 목록으로 보여 줘” → 예약 일시·고객·유입 경로가 반환됩니다
- “무료 상담의 다음 주 빈 시간을 알려 줘” → 날짜별 예약 가능한 시간이 반환됩니다
- “11월 세미나 신청자를 알려 줘” → 회차별 신청자와 유입 경로가 반환됩니다
- “전시회 전단지용으로 무료 상담 추적 링크를 만들어 줘” → 추적 링크 URL이 반환됩니다
- “12월 3일 14시부터 1시간짜리 온라인 세미나를 임시 저장으로 만들어 줘” → 임시 저장된 세미나와 관리 화면 URL이 반환됩니다
- “Madoake에서 세미나 리마인드는 언제 발송돼?” → AI가 Madoake 도움말을 찾아보고 답합니다
할 수 없는 일·주의 사항
- 삭제·취소·고객에게 메일 발송은 할 수 없습니다(관리 화면에서 진행해 주세요)
- AI가 만든 예약 페이지·세미나는 임시 저장 상태로 저장됩니다. 공개는 관리 화면에서 내용을 확인한 뒤 진행해 주세요
- AI는 연결한 멤버가 볼 수 있는 것만 다룹니다(예: 비공개 항목은 다른 멤버에게 보이지 않습니다)
- 연결 1개당 10분에 300회까지 호출할 수 있습니다
- 시간은 모두 일본 시간(JST, UTC+9)입니다
연결 해제
관리 화면 ‘AI 연동’의 ‘발급한 키’에서 삭제하면 해당 AI에서는 더 이상 사용할 수 없습니다(claude.ai에서 연결한 것도 목록에 표시됩니다).
데이터 처리
AI에 전달되는 것은 호출된 도구가 반환하는 정보뿐입니다. Madoake는 AI와의 대화 내용을 받지 않습니다. 자세한 내용은 개인정보 처리방침을 확인해 주세요.
문의
lanitech LLC Madoake 담당 info@lanitech.jp