M2-4b. 커넥터 — 빌트인 · 커스텀 · REST API

한 줄 요약 — 커넥터는 Power Platform 커넥터 생태계로 에이전트를 외부 서비스에 잇는 도구입니다. 기성(빌트인) 커넥터가 있으면 그대로, 없으면 커스텀 커넥터로 만들고, 그 원료가 되는 것이 REST API + OpenAPI 정의입니다.

1. 세 갈래 한눈에

구분	무엇	언제
빌트인 커넥터	수백 개 사전 구축 커넥터 (SharePoint, Outlook, Excel Online, Teams, Salesforce, ServiceNow, SAP…)	잘 알려진 서비스 — 검색해서 바로 Add
커스텀 커넥터	OpenAPI 정의로 직접 등록하는 커넥터 (make.powerapps.com)	기성 커넥터에 없는 사내 API·공공 API
REST API	HTTP 엔드포인트 그 자체 — OpenAPI(swagger)로 기술	커스텀 커넥터의 입력물. (클래식의 REST API 도구 유형은 새 환경 미지원 — 커스텀 커넥터 경유)

판단 순서 — ① 빌트인 검색 → ② 없으면 OpenAPI 정의 확보 → ③ 커스텀 커넥터 등록 → ④ 도구로 추가.

2. 빌트인 커넥터

Build 탭 → Tools → Add a tool → Connectors 탭에서 검색 → Add
추가 후 구성 3종: 인증(Authenticate) → 작업 선택(Select actions) → 설명 검토(Review description)
다중 작업 커넥터(예: Outlook)는 에이전트에 노출할 작업만 선택 — 불필요한 작업 노출은 오호출의 원인

💡 RFP 시나리오 예 — Excel Online (Business)로 수신자 명단 조회, Office 365 Outlook으로 검토 보고서 발송.

3. 커스텀 커넥터

기성 커넥터에 없는 API를 쓰는 절차 (상세 실습 → 실습 ③):

OpenAPI(swagger) 파일 준비 — API 명세를 JSON/YAML로 기술
make.powerapps.com → Custom connectors → New custom connector → OpenAPI 파일 가져오기
보안(인증 방식: API Key 등) 구성 → 테스트 탭에서 호출 확인
DLP 정책 허용 여부 관리자 확인 → Copilot Studio Connectors 탭에 노출되는지 확인

공휴일 API 커스텀 커넥터 — 연결 구조

4. REST API — OpenAPI 정의가 핵심

커스텀 커넥터의 품질은 OpenAPI 정의의 품질입니다: operationId·summary·description·파라미터 description이 곧 오케스트레이터가 읽는 도구 설명이 됩니다.
파라미터에 default·형식(YYYYMMDD 등)을 명시하면 에이전트가 입력을 더 정확히 채웁니다.
응답이 JSON이면 에이전트가 표·요약으로 가공하기 쉽습니다 (_type=json 같은 형식 파라미터 활용).

5. 제약/주의

클래식의 모든 도구 유형이 새 환경에 있지는 않음 — 새 환경 커스텀 도구 추가는 현재 MCP 서버 기반이 공식 경로, 커넥터는 Power Platform에서 등록 후 Connectors 탭으로 노출되는 방식
커넥터 인증 자격 증명 만료 시 Tool details → Details에서 갱신
조직 DLP 정책이 커넥터 사용을 차단할 수 있음 — 실습 전 관리자 확인

핵심 정리

판단 순서: 빌트인 검색 → 없으면 OpenAPI → 커스텀 커넥터 → 도구 추가
추가 후 구성 3종: 인증 · 작업 선택 · 설명 검토 — 노출 작업은 최소로
OpenAPI의 description이 곧 도구 설명 — 정의 품질 = 호출 품질
REST API 도구 유형(클래식)은 새 환경 미지원 — 커스텀 커넥터로 우회

🧪 실습: ③ 커넥터·도구(읽기·커스텀·설명 실험) · 커넥터 심화(쓰기·발송·게시) · REST API 직접 제작

M2-4 도구로 · 다음: M2-4d. MCP

출처: Available tools (MS Learn) · Use connectors as tools (MS Learn) · Custom connectors (MS Learn)