구성 요소 계획에서 MCP 서버 결정을 사용하여 원격으로 호스팅되는 도구 또는 리소스를 제공합니다. 실행 중인 MCP 서버는 플러그 인 패키지와 별도로 유지되므로 원격 런타임과 대상 Microsoft 환경에 대한 지원되는 연결을 모두 구현하거나 확인해야 합니다.
MCP 서버 다시 사용
서버를 빌드하기 전에:
- 필요한 도구 또는 리소스를 노출하는 승인된 MCP 서버를 식별합니다.
- 도구 정의, 입력, 출력, 오류, 주석 및 확인 동작을 검토합니다.
- 해당 전송, 인증 모델 및 프로토콜 기능이 대상 Microsoft 환경에서 지원되는지 확인합니다.
- 서버 소유자, 엔드포인트, 버전, 가용성, 데이터 처리, 지원 및 변경 프로세스를 확인합니다.
- 액세스 권한을 얻고 개발 또는 테스트 연결을 구성합니다.
- 대표 검색, 인증, 호출 및 오류 시나리오를 테스트합니다.
MCP 서버를 참조한다고 해서 운영 책임이 이전되지 않습니다. 다시 사용하기 전에 서비스 소유자 및 지원 계약을 기록합니다.
MCP 서버 구축 및 운영
승인된 서버가 요구 사항을 충족하는 경우 새 MCP 서버를 빌드합니다.
- 구성 요소 계획에 필요한 도구와 리소스만 구현합니다.
- 명확한 이름, 설명, 입력, 출력, 오류 및 안전 주석을 정의합니다.
- 인증, 권한 부여, 데이터 액세스 및 최소 권한 동작을 구현합니다.
- 호스팅, 네트워킹, 비밀, 로깅, 모니터링, 크기 조정, 인시던트 대응을 구성합니다.
- 프로토콜 동작 버전 관리 및 문서 호환성 기대치.
- Microsoft 환경에 연결하기 전에 서버를 독립적으로 테스트합니다.
GitHub Copilot은 서버 코드, 스키마, 테스트 및 리포지토리 변경을 지원할 수 있습니다. MCP 런타임, 호스팅, 인증 또는 Microsoft 365 연결 자체는 제공하지 않습니다.
서버 연결
선택한 개발 도구 및 대상 환경에서 지원하는 통합을 사용합니다.
참고
WIQD를 사용하여 원격 MCP 서버를 참조하는 플러그 인을 만듭니다. Microsoft 365 앱 매니페스트의 배열을 통한 agentConnectors 수동 구성은 Microsoft 365 Copilot 플러그 인에 대한 원격 MCP 서버 구성을 참조하세요. 이 구성은 선언적 에이전트 작업에 사용되는 MCP 플러그 인 매니페스트와 다릅니다. 지원은 대상 환경에 따라 다릅니다.
| 개발 접근 방식 | 다음으로 시작 |
|---|---|
| Work IQ Dev 도구(지원되는 프로 코드 시나리오에 권장) | Work IQ Dev Tools로 플러그인을 빌드합니다. 에이전트 작업의 경우 WIQD 에이전트 작업 워크플로를 사용합니다 |
| 에이전트 도구 키트를 사용하는 기존 선언적 에이전트 프로젝트 | 도구 키트 기반 MCP 통합 연습 |
| Copilot Studio | Microsoft Copilot Studio 설명서 |
| 대화형 MCP 응답 | 선언적 에이전트에 MCP 앱 추가 |
| Agent 365 CLI로 BYO 원격 MCP 서버 등록 | 에이전트 도구에서 원격 MCP 서버 등록 |
중요
Agent 365 CLI BYO MCP 경로는 미리 보기 상태이며 Microsoft 365 선언적 에이전트용으로 패키지된 MCP 플러그인과 별도의 등록 및 관리 모델을 사용합니다. 문서화된 지원 클라이언트는 Copilot Studio, Visual Studio Code, Claude Code 및 GitHub Copilot CLI입니다. Microsoft 365 선언적 에이전트는 이 경로에서 지원되지 않습니다. 관리자는 에이전트 도구를 사용하여 등록된 서버를 검토, 승인, 동의, 차단 및 모니터링합니다.
Work IQ Dev 도구
이 wiqd plugin add connector 명령은 WIQD 플러그인 패키지에 원격 MCP 커넥터를 추가합니다. 문서화된 서버 요구 사항은 다음과 같습니다.
- TLS 1.2 이상을 사용하는 HTTPS
- JSON-RPC 2.0을 사용하여 스트리밍 가능한 HTTP 전송.
-
tools/list및tools/call. - 30초 이내에 완료되는 도구 호출.
매니페스트 버전 1.29에 대한 WIQD 스캐폴드. 여기서 mcpToolDescription 는 선택 사항입니다. 도구 설명 파일을 포함하는 경우 필요한 연결선 옵션과 함께 를 wiqd plugin add connector --tool-description <relative-file-path> 기준으로 상대 appPackage 경로를 전달합니다. 참조된 파일은 ZIP에 포함되어 있어야 합니다. 현재 Cowork 검색 동작 및 패키지 요구 사항은 Copilot Cowork용 플러그 인 빌드를 참조하세요.
OAuth 또는 API 키 인증의 경우 먼저 자격 증명을 등록하고 참조 식별자만 패키지에 추가합니다. 매니페스트에 클라이언트 암호, API 키 또는 토큰을 넣지 마세요. WIQD 플러그인 작성 참조를 참조하세요.
WIQD 플러그 인 패키지 경로의 경우 Microsoft 365 앱 매니페스트에서 인증 및 도구 검색을 구성합니다. 대신 서버를 선언적 에이전트에 MCP 작업으로 추가하는 경우 에이전트 작업 인증 및 동적 검색 또는 에이전트에 고정된 도구를 사용합니다. 매니페스트 모델 간에 구성을 복사하는 대신 선택한 통합의 요구 사항을 따릅니다.
MCP 기능이 작동하는지 확인
MCP 서버와 해당 연결은 다음과 같은 경우 통합할 준비가 완료됩니다.
- 끝점은 개발 또는 테스트 환경에서 사용할 수 있습니다.
- 대상 환경에서 필요한 도구 또는 리소스를 검색할 수 있습니다.
- 대표 작업은 예상되는 구조화된 결과를 반환합니다.
- 인증, 권한 부여, 동의 및 사용 권한이 의도한 대로 작동합니다.
- 확인, 시간 제한, 서비스 사용 불가, 잘못된 입력 및 부분 실패 동작은 이해할 수 있습니다.
- 로그와 모니터링은 오류를 진단하기에 충분한 정보를 제공합니다.
- 서버 소유자, 버전, 엔드포인트, 호스팅, 종속성, 제한 사항 및 테스트 증거가 기록됩니다.
개발 중에 서버에 공개적으로 연결할 수 없는 경우 로컬 MCP 및 API 디버깅 을 사용합니다.
계획의 다른 구성 요소를 계속 진행합니다. 완료되면 구성 요소를 통합하고 테스트합니다.