MCP 서버 빌드 또는 다시 사용

구성 요소 계획에서 MCP 서버 결정을 사용하여 원격으로 호스팅되는 도구 또는 리소스를 제공합니다. 실행 중인 MCP 서버는 플러그 인 패키지와 별도로 유지되므로 원격 런타임과 대상 Microsoft 환경에 대한 지원되는 연결을 모두 구현하거나 확인해야 합니다.

MCP 서버 다시 사용

서버를 빌드하기 전에:

  1. 필요한 도구 또는 리소스를 노출하는 승인된 MCP 서버를 식별합니다.
  2. 도구 정의, 입력, 출력, 오류, 주석 및 확인 동작을 검토합니다.
  3. 해당 전송, 인증 모델 및 프로토콜 기능이 대상 Microsoft 환경에서 지원되는지 확인합니다.
  4. 서버 소유자, 엔드포인트, 버전, 가용성, 데이터 처리, 지원 및 변경 프로세스를 확인합니다.
  5. 액세스 권한을 얻고 개발 또는 테스트 연결을 구성합니다.
  6. 대표 검색, 인증, 호출 및 오류 시나리오를 테스트합니다.

MCP 서버를 참조한다고 해서 운영 책임이 이전되지 않습니다. 다시 사용하기 전에 서비스 소유자 및 지원 계약을 기록합니다.

MCP 서버 구축 및 운영

승인된 서버가 요구 사항을 충족하는 경우 새 MCP 서버를 빌드합니다.

  1. 구성 요소 계획에 필요한 도구와 리소스만 구현합니다.
  2. 명확한 이름, 설명, 입력, 출력, 오류 및 안전 주석을 정의합니다.
  3. 인증, 권한 부여, 데이터 액세스 및 최소 권한 동작을 구현합니다.
  4. 호스팅, 네트워킹, 비밀, 로깅, 모니터링, 크기 조정, 인시던트 대응을 구성합니다.
  5. 프로토콜 동작 버전 관리 및 문서 호환성 기대치.
  6. 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 디버깅 을 사용합니다.

계획의 다른 구성 요소를 계속 진행합니다. 완료되면 구성 요소를 통합하고 테스트합니다.