팁
권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.
이 가이드에서는 Microsoft 365 Copilot 도구 키트를 사용하여 에이전트를 서버에 연결하는 MCP 플러그 인을 추가하여 서비스를 Microsoft 365 Copilot용 선언적 에이전트와 통합하는 방법을 보여 줍니다. 이러한 단계를 수행하면 비즈니스 사용자를 위한 MCP 노출 서비스에 대한 AI 기반 대화형 액세스를 사용할 수 있습니다.
이 연습에서는 MCP 플러그 인을 사용하여 선언적 에이전트를 만듭니다. 플러그인 매니페스트는 에이전트를 원격 MCP 서버에 연결합니다. 실행 중인 서버를 패키징하거나 호스팅하지 않습니다.
이 연습에서는 선언적 에이전트 작업 경로를 다룹니다. 대신 플러그 인 패키지 수준에서 서버를 연결하려면 앱 매니페스트에서 원격 MCP 서버 구성을 참조하세요. 두 매니페스트 모델의 관계는 플러그 인 및 선언적 에이전트 작업을 참조하세요. 대상 환경에서 지원하는 경로를 사용합니다.
이 연습에서는 GitHub MCP 서버를 예로 사용합니다. GitHub MCP 서버는 GitHub에서 제공 및 유지 관리하는 리포지토리, 문제, 끌어오기 요청 및 기타 GitHub 기능 작업을 위한 도구를 노출하는 원격 MCP 서버입니다. 여기서는 자연어 프롬프트에서 GitHub 리포지토리 및 사용자를 검색할 수 있는 에이전트를 빌드하는 데 사용합니다. 자체 MCP 서버에서 동일한 단계를 수행할 수 있습니다.
인증을 위한 OAuth 클라이언트 만들기, 에이전트 만들기, 개발을 위해 프로비전 및 사이드로드, 에이전트 사용의 네 단계로 기능을 빌드하고 테스트합니다.
필수 구성 요소
시작하기 전에 다음과 같은 필수 구성 요소가 갖춰져 있는지 확인합니다.
- Copilot 확장성 옵션 요구 사항에 지정된 요구 사항
- Visual Studio Code
- Microsoft 365 Agents Toolkit 버전 6.12.0 이상
이 연습에서 GitHub 예제를 완료하려면 GitHub 계정도 필요합니다. 자체 MCP 서버에서 플러그 인을 빌드하는 데 GitHub 계정이 필요하지 않습니다.
1단계: 인증을 위한 OAuth 클라이언트 만들기
GitHub MCP 서버는 데이터를 반환하기 전에 각 사용자가 로그인해야 하므로 플러그인에 OAuth 클라이언트가 필요합니다. 이 가이드에서는 OAuth(정적 등록 포함)를 사용합니다. 에이전트를 만들고 이 인증 유형을 선택하면 Agents Toolkit에서 해당 값을 묻는 메시지를 즉시 표시하므로 먼저 클라이언트를 만듭니다. 그런 다음 Copilot은 등록을 사용하여 에이전트가 MCP 서버를 호출할 때마다 로그인한 사용자를 대신하여 액세스 토큰을 얻습니다.
팁
MCP 서버가 OAuth 2.0 동적 클라이언트 등록(DCR)을 지원하는 경우 이 섹션을 건너뛸 수 있습니다. 에이전트를 만들 때 인증 유형으로 OAuth(동적 등록 포함) 를 선택합니다. MCP 서버는 런타임에 클라이언트를 등록하므로 클라이언트 ID 또는 암호가 필요하지 않습니다. Agents Toolkit은 사용자를 위해 플러그인 매니페스트에 등록을 기록합니다.
OAuth 클라이언트를 만들려면 다음을 수행합니다.
브라우저에서 로 이동합니다.https://github.com/settings/developers OAuth 앱>새 OAuth 앱을 선택합니다.
앱의 이름과 홈페이지 URL을 추가하고 인증 콜백 URL로 설정합니다
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect. 애플리케이션 등록을 선택합니다.앱을 만든 후 새 클라이언트 암호 생성을 선택합니다. 에이전트를 만들 때 입력할 비밀 및 클라이언트 ID 를 복사합니다.
참고
이러한 단계는 GitHub에만 적용됩니다. 자체 MCP 서버의 경우 서버에서 사용하는 ID 공급자를 사용하여 OAuth 클라이언트를 만들고 리디렉션(콜백) URL로 설정합니다 https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect . 에이전트를 만들고 OAuth(정적 등록 포함)를 선택하면 에이전트 도구 키트에서 클라이언트 ID, 클라이언트 암호 및 선택적 범위를 묻는 메시지를 표시합니다. MCP 서버가 동적 클라이언트 등록(DCR)을 지원하는 경우 대신 OAuth(동적 등록 포함)를 선택할 수 있으며 MCP 서버는 런타임에 클라이언트를 등록합니다. 수동 클라이언트 생성, 클라이언트 ID 또는 암호가 필요하지 않습니다. MCP 서버가 OAuth 대신 Microsoft Entra SSO(Single Sign-On)를 사용하는 경우 Entra SSO를 선택하면 에이전트 도구 키트에서 대신 Microsoft Entra 앱 클라이언트 ID를 묻는 메시지를 표시합니다. 모든 경우에 에이전트 도구 키트는 플러그인 매니페스트를 업데이트합니다. 각 옵션에 대한 자세한 내용은 에이전트에서 MCP 및 API 플러그인에 대한 인증 구성을 참조하세요.
2단계: 에이전트 만들기
에이전트를 만들려면 다음을 수행합니다.
Visual Studio Code를 열고 활동 표시줄에서 Microsoft 365 에이전트 도구 키트 아이콘을 선택합니다.
에이전트 도구 키트 작업 창에서 새 에이전트/앱 만들기 를 선택합니다.
선언적 에이전트를 선택합니다.
작업 추가를 선택한 다음 MCP 서버로 시작을 선택합니다.
GitHub MCP 서버 URL
https://api.githubcopilot.com/mcp/을 입력합니다.
인증 유형을 선택합니다. 이 연습에서는 OAuth(정적 등록 포함)를 선택합니다.
메시지가 표시되면 등록한 OAuth 앱의 클라이언트 ID 를 입력한 다음 클라이언트 암호를 입력합니다.
범위를 입력하라는 메시지가 표시되면 Enter 키를 눌러 계속합니다.
에이전트 프로젝트의 위치를 선택합니다.
에이전트의 이름을 입력합니다.
이 단계를 완료하면 에이전트 도구 키트에서 에이전트에 필요한 파일을 생성하고 에이전트 프로젝트가 로드된 새 Visual Studio Code 창을 엽니다.
Agents Toolkit은 동적 도구 검색을 위해 생성된 플러그인 매니페스트(ai-plugin.json)를 구성하므로 에이전트는 런타임 시 UI 위젯(MCP 앱)을 반환하는 도구를 포함하여 MCP 서버의 도구를 확인하고 사용자가 수동으로 도구를 추가하지 않아도 됩니다. 대신 고정되고 선별된 도구 집합을 고정하려면 에이전트 도구 키트를 사용하여 고정된 도구 구성을 참조하세요.
3단계: 개발용 에이전트 프로비저닝 및 사이드로드
개발 테넌트에서 에이전트를 프로비전하고 사이드로드하려면 다음을 수행합니다.
에이전트 도구 키트 계정 창에서 Microsoft 365에 로그인을 선택합니다. (이미 로그인한 경우 다음 단계를 계속 진행합니다.)
Microsoft 365 계정 아래에 사용자 지정 앱 업로드 사용 과 Copilot 액세스 사용이 모두 표시되는지 확인합니다. 그렇지 않은 경우 organization 관리자에게 검사하세요. 자세한 내용은 Copilot 확장성 옵션에 대한 요구 사항을 참조하세요.
수명 주기 창에서 프로비전을 선택합니다.
대화 상자에서 메시지를 읽고 확인 을 선택하여 계속합니다.
도구 키트에서 프로비저닝이 완료되었다고 보고할 때까지 기다립니다.
참고
Work IQ Dev Tools — 선언적 에이전트 프로젝트의 경우 서버에 필요한 인증 옵션과 함께 사용합니다 wiqd agent add action --mcp-server-url <https-endpoint> . 오프라인 원본 검사에 사용합니다 wiqd agent validate --mode source . 패키지 ID를 resolve 위해 선택한 환경을 프로비저닝한 다음 동일한 --env 값으로 실행 wiqd agent package 합니다. separate wiqd plugin add connector 명령은 선언형 에이전트 프로젝트에 작업이 아닌 독립 실행형 플러그 인 프로젝트에 원격 커넥터를 추가합니다. 현재 옵션은 WIQD 명령 참조를 참조하세요.
4단계: 에이전트 사용
에이전트를 사용하려면 다음을 수행합니다.
브라우저에서 로 이동합니다 https://m365.cloud.microsoft/chat.
사이드바의 에이전트 섹션에서 에이전트를 찾습니다. 2단계: 에이전트
dev만들기에서 지정한 이름으로 나열되며 끝에 추가됩니다. 에이전트를 선택합니다.에이전트에게 리포지토리 또는 사용자를 찾도록 요청합니다. 예를 들면
can you find a repo for kiota?.메시지가 표시되면 {agent-name}에 로그인을 선택합니다. 팝업 창에서 GitHub 계정으로 로그인하고 에이전트에 권한을 부여합니다.
팝업 창이 닫히면 에이전트가 응답을 반환합니다.
에이전트가 호출하는 도구가 UI 위젯(MCP 앱)을 반환하는 경우 에이전트가 응답에서 위젯을 인라인으로 렌더링하는지 확인합니다. 자세한 내용은 Microsoft 365 Copilot의 선언적 에이전트에 MCP 앱 추가를 참조하세요.
다음 단계
에이전트 및 해당 MCP 작업을 테스트한 후 플러그인 패키지에 에이전트를 포함하는 경우 플러그인 패키지 를 따르세요.