MCP(모델 컨텍스트 프로토콜) 서버가 이미 설정된 경우 MCP 서버를 에이전트에 연결할 수 있습니다.
Copilot Studio의 MCP 서버에 에이전트를 연결하는 방법에는 두 가지가 있습니다.
- MCP 온보딩 마법사를 사용하여 Copilot Studio에서 MCP 서버 추가(권장)
- Power Apps를 통해 서버에 대한 사용자 지정 커넥터 만들기
MCP 서버를 아직 설정하지 않은 경우 시작하는 방법에 대한 자세한 내용은 새 MCP 서버 만들기 를 참조하세요.
지원되는 전송
MCP에서 전송은 클라이언트-서버 통신의 기초입니다. 전송은 메시지를 보내고 받는 메커니즘을 처리합니다. 현재 Copilot Studio는 스트리밍 가능한 전송 유형을 지원합니다.
비고
SSE 전송이 더 이상 사용되지 않는다는 점을 감안할 때 Copilot Studio는 2025년 8월 이후에 MCP용 SSE를 더 이상 지원하지 않습니다.
옵션 1: MCP 온보딩 마법사 사용(권장)
기존 MCP 서버에 연결하는 가장 간단한 방법은 MCP 온보딩 마법사를 사용하여 Copilot Studio 내에서 직접 수행하는 것입니다.
이 메서드에는 다음 두 부분이 있습니다.
- 기본 MCP 서버 세부 정보 구성
- MCP 서버를 사용하여 인증 구성
기본 서버 세부 정보 구성
에이전트의 도구 페이지로 이동합니다.
도구 추가를 선택합니다.
새 도구를 선택합니다.
모델 컨텍스트 프로토콜을 선택합니다. MCP 온보딩 마법사가 나타납니다.
필요한 필드 서버 이름, 서버 설명 및 서버 URL을 입력합니다. MCP 서버가 수행하는 일에 대해 간략하지만 명확한 설명을 작성해야 합니다. 에이전트 오케스트레이터는 이 정보를 사용하여 런타임에 서버를 호출할지 여부를 식별합니다.
해당하는 경우 MCP 서버에 대한 인증 유형을 선택합니다. 다음 세 가지 옵션이 있습니다.
- 없음
- API 키: API 키 인증 구성
- OAuth 2.0: OAuth 2.0 인증 구성
없음을 선택한 경우 만들기를 선택합니다. 도구 추가 대화 상자가 나타납니다. 새 연결 만들기로 건너뛰고 에이전트에 MCP 서버를 추가합니다.
MCP 서버를 사용하여 인증 구성
서버에 인증이 필요한 경우 두 가지 옵션이 있습니다.
- API 키: MCP 서버에 인증에 API 키가 필요한 경우 이 옵션을 선택합니다. API 키는 애플리케이션(에이전트)만 서버에서 인증해야 하는 간단한 옵션입니다.
- OAuth 2.0: MCP 서버에서 인증에 OAuth 2.0을 사용하는 경우 이 옵션을 선택합니다. OAuth 2.0을 사용하면 개별 사용자가 해당 자격 증명을 공유하지 않고 서버로 인증하고 애플리케이션(에이전트)에 권한을 부여할 수 있습니다.
인증을 사용하도록 선택하는 경우 인증 세부 정보를 구성해야 합니다. 단계는 선택한 인증 유형에 따라 달라집니다.
API 키 인증 구성
인증 유형으로 API 키를 선택합니다. API 키를 구성하기 위해 더 많은 필드가 표시됩니다.
사용할 API 키 유형을 선택합니다 . 두 가지 옵션이 있습니다.
- 헤더: MCP 서버에서 요청 헤더에 API 키를 보내야 하는 경우 이 옵션을 선택합니다.
- 쿼리: MCP 서버에서 API 키를 URL에서 쿼리 매개 변수로 보내야 하는 경우 이 옵션을 선택합니다.
API 키에 적절한 헤더 또는 쿼리 문자열을 입력합니다.
선택하고생성합니다. 도구 추가 대화 상자가 나타납니다. 새 연결 만들기로 건너뛰고 에이전트에 MCP 서버를 추가합니다.
OAuth 2.0 인증 구성
인증 유형으로 OAuth 2.0 을 선택합니다.
사용할 OAuth 2.0 인증 유형을 선택합니다. 다음 세 가지 옵션이 있습니다.
- 동적 검색: MCP 서버가 검색 메커니즘을 사용하여 OAuth 2.0 DCR(동적 클라이언트 등록)을 지원하는 경우 이 옵션을 선택합니다. 클라이언트는 검색 엔드포인트를 사용하여 필요한 엔드포인트를 자동으로 검색하고 ID 공급자에 등록할 수 있습니다.
- 동적: MCP 서버가 동적 OAuth 2.0 DCR을 지원하지만 동적 검색 메커니즘을 지원하지 않는 경우 이 옵션을 선택합니다. 클라이언트는 여전히 ID 공급자에 등록할 수 있지만 필요한 엔드포인트를 수동으로 제공해야 합니다.
- 수동: MCP 서버에 OAuth 2.0 설정을 수동으로 구성해야 하는 경우 이 옵션을 선택합니다.
동적 검색
MCP 서버가 OAuth 2.0 DCR(동적 클라이언트 등록) 메커니즘을 지원하는 경우 동적 검색 옵션을 사용할 수 있습니다. 지원되는 경우 검색이 포함된 DCR은 Copilot Studio에서 MCP 서버로 OAuth 2.0 인증을 구성하는 가장 간단한 방법입니다.
OAuth 2.0 인증 유형으로 동적 검색 을 선택합니다.
만들기를 선택하여 서버를 추가합니다. 클라이언트는 검색 엔드포인트를 사용하여 필요한 엔드포인트를 자동으로 찾고 ID 공급자에 등록합니다.
다음을 선택하여 작업을 계속할 수 있습니다. 도구 추가 대화 상자가 나타납니다.
동적인
OAuth 2.0 인증 유형으로 동적 을 선택합니다.
필수 필드를 입력합니다.
- 권한 부여 URL: 클라이언트 등록 및 권한 부여 엔드포인트에 액세스할 수 있는 ID 공급자 서버의 URL입니다.
- 토큰 URL 템플릿: 에이전트가 액세스 토큰 및 새로 고침 토큰에 대한 권한 부여 코드(또는 새로 고침 토큰)를 교환하는 엔드포인트입니다. 액세스 토큰을 사용하면 에이전트가 사용자를 대신하여 MCP 서버를 사용할 수 있습니다. 새로 고침 토큰을 사용하면 이전 액세스 토큰이 만료되면 에이전트가 새로 고침 엔드포인트에서 새 액세스 및 새로 고침 토큰을 가져올 수 있습니다.
만들기를 선택하여 서버를 추가합니다. 구성에 따라 콜백 URL 이 나타날 수 있습니다. 콜백 URL은 사용자가 로그인하고 에이전트에 권한을 부여하면 ID 공급자가 권한 부여 코드로 응답하는 위치입니다.
콜백 URL이 표시되면 콜백 URL을 복사하여 ID 공급자를 사용하여 애플리케이션의 등록에 추가합니다.
다음을 선택하여 작업을 계속할 수 있습니다. 도구 추가 대화 상자가 나타납니다.
설명서
OAuth 2.0 형식으로 수동을 선택합니다. OAuth 2.0 설정을 구성하는 데 더 많은 필드가 표시됩니다.
필수 필드를 입력합니다.
- 클라이언트 ID: 앱을 등록할 때 ID 공급자가 발급하는 클라이언트 식별자입니다. 클라이언트 ID를 통해 ID 공급자는 어떤 앱이 요청을 하는지 알 수 있습니다.
- 클라이언트 암호: 앱을 등록할 때 ID 공급자가 발급하는 클라이언트 암호입니다. 에이전트는 클라이언트 ID와 함께 클라이언트 암호를 전송하여 에이전트가 MCP 서버에 대한 액세스 토큰을 요청할 권한이 있음을 증명합니다.
- 권한 부여 URL: 에이전트가 사용자를 리디렉션하여 로그인하고 에이전트에 권한을 부여하는 ID 공급자 엔드포인트입니다(에이전트 채팅에 표시되는 동의 카드). 사용자가 여기에서 인증한 다음 ID 공급자가 인증 코드를 사용하여 콜백 URL에서 에이전트에 다시 응답합니다.
- 토큰 URL 템플릿: 에이전트가 액세스 토큰 및 새로 고침 토큰에 대한 권한 부여 코드(또는 새로 고침 토큰)를 교환하는 엔드포인트입니다. 액세스 토큰을 사용하면 에이전트가 사용자를 대신하여 MCP 서버를 사용할 수 있습니다. 새로 고침 토큰을 사용하면 이전 액세스 토큰이 만료되면 에이전트가 새로 고침 엔드포인트에서 새 액세스 및 새로 고침 토큰을 가져올 수 있습니다.
- 새로 고침 URL: 새로 고침 토큰을 사용하여 새 액세스 토큰을 요청하는 엔드포인트입니다(토큰이 만료되면 사용자가 다시 로그인할 필요가 없도록).
- 범위 (선택 사항): 앱이 요청하는 권한을 공백으로 구분하여 나열한 목록입니다.
만들기를 선택하여 서버를 추가합니다. 콜백 URL이 나타납니다. 콜백 URL은 사용자가 로그인하고 에이전트에 권한을 부여하면 ID 공급자가 권한 부여 코드로 응답하는 위치입니다.
콜백 URL을 복사하여 ID 공급자를 사용하여 애플리케이션 등록에 추가합니다.
다음을 선택하여 작업을 계속할 수 있습니다. 도구 추가 대화 상자가 나타납니다.
새 연결을 만들고 에이전트에 MCP 서버를 추가합니다.
도구 추가 대화 상자에서 MCP 서버에 대한 새 연결 만들기를 선택하거나 기존 연결을 사용합니다.
에이전트에 추가를 선택하여 에이전트에 MCP 서버 추가를 완료합니다.
옵션 2: Power Apps에서 사용자 지정 MCP 커넥터 만들기
Power Apps에서 수동으로 사용자 지정 커넥터를 만들어 서버에 대한 연결을 구성할 수 있습니다.
이 절차를 수행하려면 MCP 서버에 대한 스키마 파일이 필요합니다. 스키마 파일은 MCP 서버의 API를 설명하는 OpenAPI 사양 YAML 파일입니다.
사양 파일의 모양에 대한 지침은 제공된 MCP 서버 스키마 예제 중 일부를 확인하십시오.
에이전트의 도구 페이지로 이동합니다.
도구 추가를 선택합니다.
새 도구를 선택합니다.
사용자 지정 커넥터를 선택합니다. Power Apps로 이동하여 새 사용자 지정 커넥터를 만듭니다.
새 사용자 지정 커넥터 선택.
OpenAPI 파일 가져오기를 선택합니다.
스키마 파일로 이동하고 가져오기를 선택하여 파일을 가져옵니다.
계속을 선택하여 Power Apps에서 설정을 완료합니다. Power Apps 설명서의 OpenAPI 정의 가져오기에서 설정 프로세스에 대한 자세한 내용을 확인할 수 있습니다.
MCP 서버 스키마 예제
다음은 YAML 형식의 가상 데이터를 사용하는 MCP 서버에 대한 샘플 OpenAPI 스키마 파일입니다. 자신의 MCP 서버에 대한 세부 정보를 입력해야 합니다. 이 샘플에서는 Streamable 전송 유형을 사용합니다.
swagger: '2.0'
info:
title: Contoso
description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
version: 1.0.0
host: contoso.com
basePath: /
schemes:
- https
paths:
/mcp:
post:
summary: Contoso Lead Management Server
x-ms-agentic-protocol: mcp-streamable-1.0
operationId: InvokeMCP
responses:
'200':
description: Success
MCP 연결 편집
MCP 커넥터를 편집하거나 사용자 지정 매개 변수를 추가하려면 다음을 수행합니다.
- Power Apps 또는 Power Automate 포털로 이동하여 사용자 지정 커넥터를 선택합니다.
- 커넥터 목록에서 커넥터 파일을 찾고 사용 가능한 방법 중 하나를 사용하여 필요한 업데이트를 만듭니다.