Note
이 도구는 기본적으로 다음 MCP 서버에서 제공됩니다: Dynamics 365 Customer Service.
이 문서에 나오는 도구와 예제들은 현재의 역량을 보여줍니다. 도구명, 설명, 매개변수, 응답 형식, 사용 가능한 기능은 시간이 지남에 따라 변할 수 있습니다.
에이전트, 통합, 오케스트레이션 로직을 만들 때 특정 도구명, 매개변수 구조, 도구 메타데이터, 응답 스키마에 의존성을 하드코딩하지 마세요. 대신, 실행 가능한 도구를 발견하고 활용할 수 있도록 솔루션을 설계하세요.
플랫폼이 발전함에 따라 Microsoft는 도구와 도구 메타데이터를 추가, 삭제, 이름 변경 또는 수정할 수 있습니다. 특정 도구 식별자가 아닌 역량을 기준으로 설계하면 서비스 업데이트 간 호환성을 유지하는 데 도움이 됩니다.
이 기능은 등록 관리 위젯에서 외부 MCP 툴 서버 등록을 추가하거나 편집할 때 백그라운드에서 작동합니다.
용도
MCP 서버 관리 위젯에서 등록 양식을 작성하고 저장을 선택하면 이 도구가 Dynamics 365 환경에 등록을 영속화합니다. 새 등록 생성과 기존 등록 업데이트 모두를 처리합니다.
도구는 엔드포인트 URL의 보안을 검증하고, 인증 범위가 허용되는지 확인하며, 환경별 20개 등록 제한을 강제하고, 중복 엔드포인트나 도구 접두사를 방지합니다. 성공하면 등록 정보를 저장하고 서비스 에이전트의 도구 목록을 새로고침하여 새 서버의 도구가 사용 가능해집니다.
예를 들어 다음과 같은 질문을 시도해 보세요
적용할 수 없습니다. 이 도구는 관리 위젯에서 등록을 저장할 때 자동으로 호출됩니다. 프롬프트를 타이핑해서 호출되는 것이 아닙니다.
채팅에서 보게 될 내용
등록 위젯은 저장 성공을 확인하기 위해 업데이트되며, 등록 ID와 생성 또는 업데이트가 확인되었습니다. 검증이 실패하면(예: 중복 엔드포인트나 예약된 도구 접두사), 위젯은 수정할 항목을 설명하는 오류 메시지를 표시합니다.
유용한 팁
- 새 등록을 저장하기 전에 Test Connection을 실행해야 합니다. 테스트 결과의 도구 스냅샷이 보존됩니다.
- 각 서버 엔드포인트는 한 번만 등록할 수 있습니다. 같은 URL을 다시 등록해야 한다면 기존 등록을 먼저 삭제하세요.
- 도구 접두사는 환경 내 모든 등록 전반에 대해 고유해야 합니다.
- 등록을 저장하면 도구 캐시가 무효화되므로, 업데이트된 도구는 다음 대화에서 발효됩니다.
다음에 수행되는 내용
저장 후 등록 위젯은 다시 목록 뷰로 돌아갑니다. 다음을 할 수 있습니다:
- "연결을 다시 테스트해"
- "방금 저장한 등록증 편집해줘"
- "MCP 서버 하나 추가"
이게 데이터에 영향을 미치나요?
네, 이 경우 데이터가 바뀝니다.
등록을 저장하면 Dynamics 365 환경에서 구성 레코드를 생성하거나 업데이트하고, 서비스 에이전트의 사용 가능한 도구 목록을 새로고침합니다.
사전 요구 사항
이 도구는 다음을 요구합니다:
- 시스템 관리자 또는 Copilot 서비스 관리자 역할
도구 요약
| 재산 | Value |
|---|---|
| 사용자 이름 | 외부 MCP 등록 저장 |
| 내부 공구 명칭 | save_mcp_registration |
| Purpose | 새로운 또는 업데이트된 외부 MCP 서버 등록을 유지합니다 |
도구 동작
새 또는 업데이트된 외부 MCP 서버 등록이 유지됩니다. 이 도구는 사용자가 확장 등록 위젯과 상호작용할 때 자동으로 호출되는 위젯 지원 도구입니다. 모델이 직접 호출하도록 의도된 것은 아닙니다.
Annotations
| Annotation | Value | Meaning |
|---|---|---|
readOnlyHint |
false |
이 도구는 등록 데이터를 생성하거나 업데이트합니다. |
destructiveHint |
false |
업데이트는 파괴적이지 않습니다(업서트 패턴). |
idempotentHint |
true |
같은 입력으로 반복 호출해도 같은 결과가 나옵니다. |
openWorldHint |
설정 안 함 | 기본값을 사용합니다. |
입력 개념
등록 대상
| 입력 | Description | 필수 |
|---|---|---|
displayName, name, , endpointauthScope, mode, toolPrefix, ,tools |
서버 등록 세부 정보를 포함하여, ( name 고유 식별자), endpoint (HTTPS URL), authScope (Entra OBO 대상 범위), modetoolPrefixtools , 배열.displayName |
No |
등록 ID
| 입력 | Description | 필수 |
|---|---|---|
id |
id (선택 사항). 제공 시 기존 등록을 업데이트합니다; 생략 시 새로운 원칙이 생성됩니다. |
No |
조직 URL
| 입력 | Description | 필수 |
|---|---|---|
orgUrl |
orgUrl (선택 사항). 현재 선택된 환경 URL을 덮어씁니다. |
No |
응답 및 UI 동작
이 MCP 도구는 MCP 앱에서 지원됩니다.
응답 유형
위젯 업데이트
위젯이 새로고침되어 저장된 등록 기록이 표시됩니다.
라우팅 노트
이 도구는 위젯에서만 manage_mcp_registration 호출됩니다. 직접 발동하지 마세요.
관련 도구
| Tool | 관계 |
|---|---|
manage_mcp_registration |
등록 위젯을 여는 런처 도구 |
delete_mcp_registration |
등록 해제 |
test_mcp_registration_connection |
저장 전에 연결 상태를 테스트하세요 |
데이터 돌연변이 분류
쓰기(업서트). 조직 범위 등록 저장소에서 외부 MCP 서버 등록을 생성하거나 업데이트합니다.