CalendarBridge MCP
공식캘린더 동기화, 일정 링크, AI 임원 일정 도우미, 통합 캘린더
CalendarBridge MCP(으)로 무엇을 할 수 있나요?
자신의 AI 에이전트를 연결하여 Google, Microsoft 365, iCloud 전반의 캘린더, 이벤트, 스케줄러 및 동기화를 읽고 관리하세요.
- 일정 확인 — 에이전트에게 캘린더 목록을 요청하고 Google, Microsoft 365, iCloud 전반의 모든 날짜 범위에 대한 이벤트를 읽게 하세요.
- 이벤트 관리 — 에이전트가 일반 언어로 캘린더 이벤트를 생성, 수정 또는 삭제하게 하세요. 예: 회의 예약 또는 이동.
- 예약 링크 만들기 — 에이전트에게 스케줄러를 나열, 생성, 수정 또는 삭제하도록 요청하고 예약 링크를 공유하게 하세요.
- 동기화 설정 — 에이전트에게 단방향 또는 양방향 캘린더 동기화를 나열, 생성, 수정 또는 삭제하도록 지시하세요.
- 계정 관리 — 에이전트가 연결된 계정을 나열하고 연결, 재인증 또는 제거를 위한 링크를 반환하게 하세요.
- AI 어시스턴트 구동 — 에이전트에게 어시스턴트 구성을 나열하고, 대화를 검토하며, 새 메시지나 답장을 보내도록 요청하세요.
문서
나만의 AI 에이전트(Claude, ChatGPT, Cursor 및 기타 MCP 호환 클라이언트)를 CalendarBridge 계정에 직접 연결하세요. 에이전트가 사용자가 제어하는 권한으로 캘린더, 이벤트, 스케줄러, 동기화를 대신 읽고 관리할 수 있습니다.
Bring Your Own Agent는 AI 어시스턴트가 외부 도구에 연결할 수 있게 해주는 개방형 표준인 MCP(Model Context Protocol)를 사용합니다. CalendarBridge는 호스팅된 MCP 서버를 실행하므로 MCP를 지원하는 모든 클라이언트가 계정에 연결하여 캘린더를 대신 관리할 수 있습니다.
이메일로 일정을 조율하는 CalendarBridge AI Scheduling Assistant와는 다릅니다. Bring Your Own Agent에서는 사용자가 직접 AI(이미 사용하고 비용을 지불하는 AI)를 가져와 CalendarBridge에 연결합니다.
CalendarBridge MCP 서버로 캘린더 관리하기
외부 에이전트(MCP) 인증
CalendarBridge MCP 서버는 AI 어시스턴트를 캘린더 관리자로 바꿔줍니다. 에이전트를 연결하면 일상 언어로 캘린더를 관리할 수 있습니다. Google Calendar, Microsoft 365 / Outlook, iCloud 전반에 걸쳐 단일 Model Context Protocol(MCP) 엔드포인트를 통해 일정 확인, 이벤트 생성 및 일정 변경, 예약 링크 생성, 캘린더 동기화 설정이 가능합니다.
대시보드를 클릭하는 대신 에이전트에게 원하는 것을 말하면 에이전트가 CalendarBridge의 MCP 도구를 사용하여 처리합니다. 이미 사용 중인 어시스턴트와 함께 작동하는 AI 캘린더 관리입니다.
에이전트가 할 수 있는 작업
연결되면 에이전트는 다음을 수행할 수 있습니다.
- 캘린더 및 이벤트 — 캘린더 목록 확인, 모든 날짜 범위의 이벤트 읽기, 이벤트 생성·편집·삭제
- 스케줄러 — 스케줄러 목록 확인, 생성, 편집, 삭제
- 동기화 — 단방향 또는 양방향 캘린더 동기화 목록 확인, 생성, 편집, 삭제
- 연결된 계정 — 연결된 캘린더 계정 목록 확인 및 계정 연결, 재인증, 제거 링크 가져오기
- AI 어시스턴트 — AI Scheduling Assistant 구성 목록 확인, 최근 대화 검토, 어시스턴트를 통한 새 메시지 또는 답장 보내기
에이전트가 수행하는 각 작업은 연결 시 부여한 권한으로 제한됩니다(권한 선택 참조).
이용 가능 여부 및 요금제
정보
에이전트 연결은 Basic을 포함한 모든 요금제에서 이용할 수 있습니다. 구매할 토큰도, 복사할 항목도 없습니다. 에이전트를 통한 작업 수행(캘린더 읽기 또는 변경, 동기화 생성 등)에는 활성 CalendarBridge 구독이 필요합니다. 구독이 만료되면 에이전트는 연결된 상태로 유지되지만 각 작업은 재활성화를 요청하는 메시지를 반환합니다.
1단계: Bring Your Own Agent(MCP) 탭 열기
https://app.calendarbridge.com/login/에 로그인하고 사이드 레일에서 AI Assistant를 연 다음 Bring Your Own Agent (MCP) 탭을 선택합니다.
2단계: 서버 URL 복사
탭에 CalendarBridge Server URL이 표시됩니다. 형식은 다음과 같습니다.
https://manageapi.calendarbridge.com/mcp
이 URL 하나면 클라이언트에 필요한 모든 것입니다. 복사할 API 키나 토큰은 없습니다. 클라이언트는 연결 시 보안 브라우저 로그인으로 사용자를 인증합니다(권한 선택 참조).
3단계: 클라이언트에 CalendarBridge 추가
각 클라이언트는 원격 MCP 서버를 추가하는 방식이 조금씩 다릅니다. 탭에는 선택한 클라이언트에 대한 단계별 지침이 포함되어 있으며, 가장 일반적인 방법은 아래와 같습니다. URL이 요청되는 곳에는 2단계의 Server URL을 사용하세요. 클라이언트 이름은 각 플랫폼의 공식 문서로 연결됩니다.
| 클라이언트 | 추가 방법 |
|---|---|
| Claude.ai (web) | 설정 → Connectors → + → Add custom connector. 이름을 입력하고 Server URL을 붙여넣은 다음 Add를 클릭합니다. |
| Claude Desktop | 설정 → Connectors → Add custom connector. 이름을 입력하고 Server URL을 붙여넣습니다. |
| Claude Code | claude mcp add calendarbridge --transport http <Server URL>를 실행한 다음 /mcp를 입력하고 인증합니다. |
| ChatGPT | Developer Mode를 활성화한 다음 설정 → Plugins에서 새 플러그인을 만들고 Server URL을 붙여넣습니다. |
| Cursor | 설정 → Cursor Settings → Tools & MCP에서 Server URL로 새 MCP 서버를 추가한 다음 Connect를 클릭합니다. |
| Codex CLI | codex mcp add calendarbridge --url <Server URL>를 실행한 다음 /mcp를 입력하고 calendarbridge를 선택합니다. |
| Grok | 채팅을 시작하고 + → Add connector → Custom을 클릭합니다. Server URL을 붙여넣고 인증합니다. |
| Manus | 설정 → Connectors → Add connectors → Custom MCP 탭 → Add custom MCP → Direct configuration. 이름을 입력하고 전송 유형을 HTTP로 유지한 다음 Server URL을 붙여넣고 Save를 클릭한 후 브라우저에서 액세스를 승인합니다. |
| Gemini CLI | gemini mcp add --transport http calendarbridge <Server URL>를 실행한 다음 Gemini CLI가 OAuth 서버를 감지하면 로그인합니다(또는 gemini mcp auth calendarbridge 실행). |
| Antigravity IDE | 에이전트 패널에서: ⋯ → MCP Servers → Manage MCP Servers → View raw config. mcpServers 아래에 "serverUrl"을 Server URL로 설정하여 항목을 추가하고(Antigravity는 url이 아닌 serverUrl를 사용), 저장한 후 새로고침합니다. |
| OpenClaw | openclaw mcp add calendarbridge --url <Server URL> --transport streamable-http를 실행한 다음 openclaw mcp login calendarbridge를 실행하고 브라우저에서 액세스를 승인합니다. |
| Hermes | hermes mcp add calendarbridge를 실행하고(또는 ~/.hermes/config.yaml의 mcp_servers 아래에 auth: oauth로 서버를 추가), hermes mcp login calendarbridge를 실행한 후 승인합니다. |
| 기타 클라이언트 | 사용자 지정 또는 원격 MCP 서버(connector, integration, tool server라고도 함)를 추가합니다. Server URL을 붙여넣고, 요청 시 HTTP / streamable HTTP 전송을 선택하고, 인증은 OAuth / Sign in을 선택합니다. 입력할 API 키, 클라이언트 ID 또는 시크릿은 없습니다. |
어떤 방식으로 추가하든 흐름은 동일합니다. Server URL을 붙여넣고 브라우저에서 CalendarBridge에 로그인한 다음 허용할 항목을 선택합니다.
4단계: 로그인 및 권한 선택
클라이언트가 처음 연결하면 브라우저에 CalendarBridge 로그인 페이지가 열립니다. 로그인하면 에이전트가 요청하는 권한이 나열된 동의 화면이 표시됩니다. 부여하려는 권한만 선택한 다음 Allow를 클릭합니다.
| 권한 | 허용되는 작업 |
|---|---|
| 캘린더 이벤트 읽기 | 캘린더 목록을 확인하고 이벤트를 읽습니다. |
| 캘린더 이벤트 생성, 편집, 삭제 | 캘린더에서 이벤트를 생성, 편집, 삭제합니다. |
| 연결된 계정 읽기 | 연결된 캘린더 계정 목록을 확인합니다. |
| 계정 연결 및 제거 | 계정 연결 또는 재인증 링크를 가져오고 연결된 계정을 제거합니다. |
| 스케줄러 읽기 | 스케줄러 목록을 확인합니다. |
| 스케줄러 생성, 편집, 삭제 | 스케줄러를 생성, 편집, 삭제합니다. |
| 캘린더 동기화 읽기 | 캘린더 동기화 목록을 확인합니다. |
| 캘린더 동기화 생성, 편집, 삭제 | 캘린더 동기화를 생성, 편집, 삭제합니다. |
| 어시스턴트 읽기 | 어시스턴트 구성 및 대화 목록을 확인합니다. |
| 어시스턴트 생성 및 수정 | 어시스턴트 구성을 생성, 편집, 삭제합니다. |
| 어시스턴트를 통한 메시지 전송 | 에이전트가 AI 스케줄링 어시스턴트를 통해 새 메시지와 답장을 보낼 수 있게 합니다. |
인증된 사용자
권한은 모든 요청에 적용됩니다. 에이전트는 사용자가 허용한 도구만 사용할 수 있습니다. 여러 에이전트를 연결하고 각각 다른 권한 세트를 부여할 수 있습니다.
5단계: 사용해 보기
연결이 완료되면 에이전트에게 다음과 같이 요청해 보세요.
- "이번 주 내 캘린더 일정이 뭐야?"
- "내일 오후 2시에 Design review라는 1시간 회의를 잡고 alex@example.com을 초대해 줘."
- "오늘 오후 3시 회의를 오후 4시로 옮겨 줘."
- "평일 오후에 사용 가능한 30분 스케줄러를 만들고 링크를 알려 줘."
- "업무 캘린더에서 개인 캘린더로 이벤트를 바쁨으로 표시하는 단방향 동기화를 설정해 줘."
- "연결된 계정 목록을 보여 주고 재인증이 필요한 계정이 있는지 알려 줘."
AI Scheduling Assistant 사용하기
CalendarBridge AI Scheduling Assistant를 설정했다면 연결된 에이전트가 이를 대신 사용할 수 있습니다. 새 스케줄링 이메일을 시작하거나 기존 대화에 답장할 수 있습니다.
- 새 요청 시작 — 예: "내 어시스턴트에게 다음 주에 alex@example.com과 30분 슬롯을 찾아 달라고 요청해 줘." 에이전트가 어시스턴트를 통해 이메일을 보내면 어시스턴트가 그다음부터 처리합니다.
- 대화에 답장 — 예: "내 최신 어시스턴트 대화에 답장하고 목요일 오전 10시를 제안해 줘." 에이전트가 대화 스레드를 가져와 수신자와 제목을 추론하고 답장을 보냅니다.
일정
어시스턴트는 이메일과 마찬가지로 비동기적으로 작동합니다. 메시지를 보내면 전달되고 어시스턴트의 답장은 잠시 후 도착합니다. 응답을 확인하려면 에이전트에게 대화를 다시 확인하라고 요청하세요.
이 기능을 사용하려면 연결된 이메일 계정 중 하나에 대해 구성된 어시스턴트와 Send through your assistants 권한이 필요합니다. 이 권한이 생기기 전에 에이전트를 연결했다면 다시 연결하고 동의 화면에서 권한을 부여하세요.
연결된 에이전트 관리
탭의 Connected agents 섹션에는 연결된 모든 에이전트, 부여된 권한, 마지막 사용 시점이 표시됩니다. 에이전트를 연결 해제하려면 Revoke를 클릭하면 즉시 액세스가 차단됩니다. 클라이언트에서 다시 연결하면 로그인 및 권한을 다시 요청합니다.
문제 해결
- "Subscription is not active" — 연결은 무료이지만 작업을 수행하려면 활성 구독이 필요합니다. app.calendarbridge.com에서 재활성화한 후 다시 시도하세요. 결제했지만 계정이 활성 상태가 아닌 경우를 참조하세요.
- 에이전트가 편집할 이벤트를 찾지 못함 — 먼저 이벤트 목록을 요청한 다음 해당 목록에서 이벤트를 선택하여 작업하세요.
- 캘린더 계정 재인증 필요 — 에이전트가 링크를 반환할 수 있습니다. 또는 캘린더 액세스 재인증을 참조하세요.
- 클라이언트가 연결되지 않음 — 탭에 표시된 대로
https://을 포함한 전체 Server URL을 정확히 붙여넣었는지 확인하세요.