이 문서에서는 MCP(Learn Docs Model Context Protocol) 서버를 사용하는 모범 사례를 설명합니다.
MCP LEARN 서버에 대해 이해하기
LEARN MCP Server 개요 문서를 참조하세요.
동적 검색 및 도구 선택
MCP 클라이언트는 연결 시 도구/목록을 호출하여 현재 도구 집합 및 해당 설명을 가져옵니다. 에이전트는 이러한 설명을 사용하여 호출할 도구와 디자인에 필요한 수동 매핑이 없는 매개 변수를 결정합니다. 프로토콜은 도구 가용성을 고정되지 않은 동적으로 처리합니다.
사용자 지정 통합을 빌드하는 경우 동일한 패턴을 따릅니다. 도구 이름, 매개 변수 스키마 또는 예상 동작을 하드 코딩하지 마세요. 런타임에 도구 목록을 가져오고, 설명을 모델에 전달하여 모델이 라우팅하도록 합니다. 호출이 400 또는 404로 실패하는 경우 캐시가 부실하다고 가정합니다. 도구/목록을 통해 새로 고치고, 호환성이 손상되는 변경에 클라이언트 업데이트가 필요한 기존 API 계약과 달리 도구가 추가, 이름 바꾸기 또는 업데이트될 때 통합 복원력을 유지하기 위해 다시 시도합니다.
토큰 예산 제어
엔드포인트 URL에 maxTokenBudget를 추가하여 검색 응답에서 토큰 수를 제한합니다.
https://dotnet.territoriali.olinfo.it/api/mcp?maxTokenBudget=2000
이렇게 하면 콘텐츠가 결과에서 잘려 예산 내에서 유지됩니다. 각 도구 호출이 컨텍스트 윈도우나 과금에 영향을 주는 에이전트 루프에서 실행할 때 유용합니다. 에이전트가 턴당 많은 호출을 수행하는 경우 낮게 설정하고, 더 풍부한 단일 응답을 원하는 경우 더 높게 설정합니다. 매개 변수는 검색 결과에만 영향을 줍니다. fetch는 항상 전체 페이지를 반환합니다.
실험 및 피드백 공유
MCP 서버를 사용하는 것은 Microsoft Learn 콘텐츠와 상호 작용하는 새로운 방법입니다. 다른 애플리케이션에서도 사용되는 이 솔루션의 구성 요소를 테스트했습니다. 하지만 MCP 서버가 사용되지 않고 적절하게 응답하지 않는 예기치 않은 동작이 발생할 수 있습니다.
다음 단계
다음 링크를 방문하여 Learn MCP Server에 대해 자세히 알아볼 수 있습니다.
- Microsoft Learn MCP 서버 시작
- 의견 및 질문에 대한 MCP Server 리포지토리에 대해 알아봅니다.