Microsoft 365에 앱 연결하기
Microsoft Outlook, Teams, OneDrive, Word, Excel, PowerPoint, OneNote를 Lovable 앱에 연결하세요. 모두 동일한 Microsoft 로그인과 Microsoft Graph 패턴을 사용합니다 — 모든 Microsoft 커넥터에 적용되는 하나의 가이드입니다.
Lovable은 여러 Microsoft 앱 커넥터를 제공합니다. 각 커넥터는 특정 제품을 대상으로 하지만 모두 동일한 방식으로 동작합니다. Microsoft(Entra ID / Microsoft 계정)로 로그인하면 Lovable이 토큰을 안전하게 저장하고, 앱은 Lovable의 커넥터 게이트웨이를 통해 **Microsoft Graph**를 호출하며 토큰이 자동으로 갱신됩니다.
포함된 Microsoft 커넥터
| Lovable의 커넥터 | 용도 |
|---|---|
| Microsoft Outlook | 이메일: 로그인된 사서함에서 메일을 읽고 보내고 관리(부여된 권한 범위 내). |
| Microsoft Teams | 팀 및 채널: 메시지, 팀/채널 목록, 관련 대화 API. |
| Microsoft OneDrive | 파일: 사용자의 OneDrive에 파일을 업로드, 다운로드, 작업. |
| Microsoft Word | 문서: Graph를 통해 Word 파일 읽기/쓰기(예: OneDrive/SharePoint에 저장된 파일). |
| Microsoft Excel | 스프레드시트: Graph를 통해 Excel 워크북 읽기/작업. |
| Microsoft PowerPoint | 프레젠테이션: Graph를 통해 PowerPoint 파일 읽기/쓰기. |
| Microsoft OneNote | 노트: OneNote의 전자 필기장, 섹션, 페이지. |
구축하려는 것에 맞는 커넥터를 선택하세요. 서로 다른 Microsoft 계정이나 환경이 필요하면 여러 개의 연결을 추가할 수 있습니다.
Microsoft 연결 방식
- OAuth 2.0: 해당 제품에 대해 Microsoft 계정을 승인합니다. 권한은 해당 커넥터에 대해 요청되는 scope에 따라 다릅니다(일부 커넥터는 scope에 대한 선택적 Advanced settings를 노출합니다 — 앱에 필요한 권한만 부여하세요).
- Microsoft Graph: 요청은 Lovable의 커넥터 게이트웨이를 통해
https://graph.microsoft.com/v1.0/로 전송됩니다. 안전한 토큰 처리와 프로젝트별 요청 제한에 대해서는 게이트웨이 기반 커넥터를 참고하세요. - 어디서나 동일한 플로우: 연결 추가 → Microsoft로 로그인 → 동의 승인 → 프로젝트에 연결을 연결. Outlook, Teams, OneDrive 등에서 커넥터 이름과 API 표면만 달라집니다.
Microsoft 365의 라이선싱, 테넌트 정책, Graph 스로틀링은 Lovable이 아닌 Microsoft와 해당 조직에서 관리합니다.
연결하기 (모든 Microsoft 제품)
워크스페이스 admin과 owner가 Microsoft 연결을 생성할 수 있습니다.
- Connectors → App connectors를 엽니다.
- 필요한 Microsoft 커넥터를 선택합니다. 예: Microsoft Outlook 또는 Microsoft Teams (각 제품마다 고유한 타일이 있습니다).
- Add connection을 클릭하고 Display name을 입력한 뒤 Connect / Sign in with Microsoft를 완료합니다.
- 해당 제품에 표시되는 권한을 수락합니다.
- 이 연결을 사용할 Lovable 프로젝트에 연결을 Link합니다.
조직에서 조건부 액세스 또는 관리자 동의를 사용하는 경우, IT 관리자가 테넌트에 대한 앱을 승인해야 할 수 있습니다.
특정 워크로드의 API 세부 정보는 Microsoft Graph REST API 레퍼런스를 참고하세요.
연결 관리 및 제거
다른 앱 커넥터와 동일한 단계이며, Settings에서 선택하는 제품만 달라집니다.
연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결을 삭제하지 않고 프로젝트를 연결 해제할 수 있습니다.
- Connectors → App connectors를 열고 사용했던 것과 동일한 Microsoft 커넥터를 선택합니다(예: Microsoft OneDrive).
- 연결 열기 → Linked projects → 프로젝트 선택 → Unlink projects.
연결 삭제
워크스페이스 admin 또는 owner가 연결을 삭제할 수 있습니다.
연결 삭제는 영구적입니다. 새 연결을 추가할 때까지 연결된 프로젝트는 접근 권한을 잃습니다.
- Connectors → App connectors → Microsoft 제품 선택(예: Microsoft Excel).
- 연결 열기 → Linked projects 검토 → 삭제 옵션에서 Delete → 확인.
제한 사항
- 각 연결은 하나의 승인된 Microsoft 신원(그리고 해당 신원의 메일, 파일, 팀 등, scope에 따라)에 연결됩니다. 별도의 인증 구조를 직접 구축하지 않는 한 각 방문자의 계정에 연결되지 않습니다.
- 테넌트 및 관리자 정책(동의, MFA, 차단된 앱)이 로그인을 차단하거나 제한할 수 있습니다. 이 문제는 Microsoft 365 / Entra ID에서 해결하세요.
- 게이트웨이 기반 커넥터에서 설명한 게이트웨이 제한이 적용됩니다.