Lab 0-5 — 커넥터·MCP 추가 (Mail · OneDrive)
▶ 목표: 스킬에 인코딩된 작업(메일 발송·링크 첨부)을 실제로 수행하기 위해 필요한 도구를 붙인다. 최소 큐레이션(겹치는 도구 금지, M2-3).
1. 추가할 도구
| 도구 | 용도 | 비고 |
|---|---|---|
| Work IQ Mail (MCP) | 메일 초안·발송 | 메일 도구는 하나만 |
| OneDrive (MCP) | 대시보드를 링크로 첨부 | 직접 첨부(Base64) 토큰 폭발 우회 |
| (자동) 코드 인터프리터 | 엑셀 분석·HTML 생성 | 새 코어 기본 역량, 별도 커넥터 불필요 |
| (선택) 공휴일 API 커스텀 커넥터 | 공공데이터포털 공휴일 조회 — 연차 권장일 계산에 활용 | 커스텀 커넥터·MCP·REST API로 등록 가능(선택 실습) |
- Tools → Add a tool 대화 상자에서 도구를 검색합니다 — 필터 탭은 Featured / Model Context Protocol (MCP) / Connectors / Workflows. 여기서 Office 365 Outlook · 비즈니스용 OneDrive를 고릅니다.
Tools → Add a tool에서 Office 365 Outlook · 비즈니스용 OneDrive 선택
- Office 365 Outlook 안에서 Use an MCP server → Work IQ Mail MCP를 선택합니다(단발 액션이 아니라 MCP 서버로). Work IQ는 Agent 365 MCP 게이트웨이 기반으로 M365 데이터에 연결되는 소스입니다.
Office 365 Outlook → Use an MCP server → Work IQ Mail MCP 선택
2. 절차
- Build 화면 우측 컴포넌트 패널에서 Tools → Add a tool.
- Mail MCP 추가 → 연결(로그인/권한 동의 프롬프트가 뜨면 진행).
- OneDrive MCP 추가 → 연결.
- 도구 목록에서 설명(description)을 확인 — 오케스트레이션 런타임이 설명을 보고 호출 여부를 판단하므로 기능을 정확히 반영해야 합니다.
3. 도구 팁 (M2-3 요약)
- 겹치는 도구 금지 — 메일 커넥터를 두 개 붙이면 에이전트가 매번 헷갈립니다. Mail MCP 하나만. 도구 간 설명이 모호하거나 중복되지 않게 관리하세요.
- 코드로 되는 건 안 붙인다 — docx/pptx/HTML 생성은 코드 인터프리터로 충분 → 문서 생성 커넥터 불필요.
- OneDrive는 첨부 토큰 우회용 — HTML을 그대로 붙이면 Base64 변환에 토큰이 터집니다. 업로드 → 링크 첨부가 표준(메일·보고서 스킬에 절차 인코딩됨).
- (선택) 공휴일 API — 기성 커넥터에 없는 공공 성격의 API(공공데이터포털 공휴일/기상청 날씨)는 커스텀 커넥터로 등록해 “다음 달 공휴일을 반영한 연차 권장일” 같은 답을 시켜볼 수 있습니다(일반 예시).
짚고 가기: 세션 시작 시 OneDrive 도구가 보이지 않으면 MCP 재연결이 필요합니다. 메일 첨부가 안 되면 가장 먼저 도구 연결(인증 자격 증명 만료 여부)을 확인하세요.
← 4. 스킬 패키지 · 다음: 6. 테스트
출처: Add a tool to an agent — Microsoft Learn · Microsoft IQ overview for agents — Microsoft Learn · 3부 · 커넥터·MCP 추가 — Microsoft Copilot Agentic Blog