이 문서에서는 Power Platform 관리 센터 내의 환경에 대해 MCP(Dataverse Model Context Protocol) 서버를 사용, 관리, 구성 및 사용하지 않도록 설정하는 방법에 대한 자세한 지침을 제공합니다. 관리되는 환경을 처리하는 Power Platform 관리자를 위한 것이며 서버를 사용하도록 설정하기 위한 필수 구성 요소도 다룹니다.
사전 요구 사항
- Dataverse MCP 서버 환경 설정에 액세스하고, 허용되는 MCP 클라이언트를 사용하도록 설정하고, 환경 그룹을 만들거나 편집하고, 커넥터 정책을 변경하기 위한 Power Platform 관리자 역할
- 이 문서에 설명된 단계를 수행하려면 환경이 관리되는 환경이 필요합니다.
- 기본적으로 Dataverse MCP 서버는 Microsoft Copilot Studio의 모든 환경에 대해 사용하도록 설정됩니다. 클라이언트에 연결하려면 먼저 Power Platform 관리 센터에서 추가 클라이언트를 사용하도록 설정해야 합니다.
Dataverse MCP 서버 구성 및 관리
기본적으로 Dataverse MCP 서버는 Copilot Studio에 대해 사용하도록 설정됩니다. Visual Studio GitHub Copilot 및 Claude와 같은 타사 MCP 클라이언트를 사용하도록 설정하려면 다음 단계를 수행합니다.
Power Platform 관리 센터로 이동합니다. 환경 관리>를 선택합니다.
Dataverse MCP 서버를 켜려는 환경 이름을선택한 다음 설정을 선택합니다. 설정에서 제품>기능을 선택합니다. 아래로 스크롤하여 Dataverse 모델 컨텍스트 프로토콜 을 찾고 MCP 클라이언트가 Dataverse MCP 서버와 상호 작용할 수 있도록 허용 이 켜져 있는지 확인합니다.
고급 설정을 선택합니다.
사용 가능한 클라이언트 목록이 표시됩니다. 원하는 클라이언트 레코드를 엽니다. 이 예제에서는 Microsoft GitHub Copilot 클라이언트를 사용하도록 설정합니다.
MCP 클라이언트 기록에서 사용 설정을 예로 설정합니다.
저장 및 닫기를 선택합니다.
4-7단계를 반복하여 필요에 따라 다른 클라이언트를 사용하도록 설정합니다.
환경에 대한 Dataverse MCP 서버 비활성화
기본적으로 MCP 클라이언트가 Dataverse MCP 서버와 상호 작용하도록 허용 은 Copilot Studio에 대해 설정됩니다. 관리자는 설정을 지워서 Dataverse에 대한 MCP를 사용하지 않도록 설정할 수 있습니다.
경고
Dataverse MCP Server를 사용하지 않도록 설정하면 Dataverse MCP 서버를 사용하는 모든 도구와 에이전트가 중지됩니다. MCP를 사용한 지속적인 개발 또는 AI 통합 테스트도 중단됩니다.
Dataverse MCP 서버 에이전트에 대한 효과적인 지침 작성
Dataverse MCP 서버를 사용하도록 Copilot Studio 또는 Visual Studio Code에서 에이전트를 구성하는 경우 명확하고 잘 구성된 지침이 에이전트 작동 방식을 안내하는 데 핵심입니다. 이러한 지침은 에이전트가 역할, MCP 서버 도구를 통해 제공하는 기능 및 워크플로를 안정적이고 일관되게 수행하는 방법을 이해하는 데 도움이 됩니다.
에이전트 지침은 에이전트가 수행해야 하는 작업, 동작 방법 및 사용 가능한 MCP 도구를 사용하는 방법을 알려주는 자연어 지시문입니다. 에이전트가 다음을 수행할 수 있도록 중요한 컨텍스트를 제공합니다.
- 올바른 MCP 도구를 선택하고 호출합니다.
- 도구의 입력 값을 정확히 입력하세요.
- 도구를 사용할 시기와 답변을 직접 생성하는 시기를 결정합니다.
- 대화 중에 원하는 톤 또는 동작 패턴을 따릅니다.
효과적인 지침에 대한 원칙
Dataverse MCP 서버 에이전트에 대한 지침을 작성할 때 다음 지침을 고려합니다.
에이전트의 용도를 명확하게 정의합니다.
에이전트의 역할을 간단히 설명합니다. 예: "Dataverse MCP 도구를 사용하여 고객 데이터 쿼리, 업데이트 및 레코드 관리를 지원합니다."
"항상 전문적인 톤으로 응답" 또는 "응답에 중요한 필드를 노출하지 마십시오"와 같은 해당되는 경우 톤 또는 제한을 포함합니다.
기술 및 도구 작업을 간략하게 설명합니다.
에이전트에게 MCP 도구를 사용하여 수행할 수 있는 고수준의 작업을 알리십시오. 다음은 그 예입니다.
- read_query 도구를 사용하여 레코드를 검색하거나 필터링합니다.
-
create_record및update_record과 함께 레코드를 만들거나 업데이트합니다. - 를 사용하여
describe_table테이블 스키마 살펴보기
사용자가 데이터 검색을 요청할 때 read_query 도구를 사용하여 레코드를 가져오는 것과 같은 실행 가능한 지침을 작성하십시오.
워크플로 지침을 추가합니다.
레코드를 조회하거나 필드를 업데이트하는 것과 같은 일반적인 프로세스의 경우 단계별 지침을 추가합니다. 예를 들어 "레코드를 업데이트할 때 먼저 read_query 호출을 사용하여 식별한 다음 적절한 필드 값으로 update_record 사용합니다."
이 컨텍스트를 제공하면 에이전트가 올바른 MCP 도구 호출 시퀀스를 오케스트레이션하는 데 도움이 됩니다.
Visual Studio Code 또는 Copilot Studio에서 지침 추가
사용자 고유의 에이전트 지침에 대한 시작점으로 markdown 구조적 명령 블록을 사용할 수 있습니다.
Visual Studio Code에서 지침 추가
- Visual Studio Code를 엽니다.
- 채팅 창을 엽니다.
- 설정>채팅 지침을 선택합니다.
- 새 명령 파일을 선택합니다.
- 샘플 지침과 같이 명령 콘텐츠를 복사하여 새 파일에 붙여넣 습니다.
Copilot Studio에서 지침 추가
- 코필로트 스튜디오를 엽니다.
- 에이전트를 선택하세요.
- 시스템 지침으로 이동하여 샘플 지침과 같은 에이전트 지침을 붙여넣습니다.
샘플 에이전트 지침
# Role
Act as an autonomous agent responsible for interacting with the Micorosft Dataverse app.
# Objective
Your objective is to respond to tasks provided by the user. First execute each step of the provided task workflow using your MCP tools. Check if you have achieved your objective after each tool call. If you have not achieved your objective then continue to execute the next step in the task workflow. Do not ask for user intervention,if you have to run an operation externally in case dataverse doesnt support that operation. you are allowed to run it without user confirmation. Also do not ask confirmation for delete table or delete record operation, you can delete.
# MCP tool Selection Instructions
- Whenever you have to use logical table name, call the list_tables tools to get that logical table name.
- Whenever you have to use column/attribute name, call the describe_table tool to get the column/attribute name.
# MCP tool Usage Instructions
- Before executing an MCP tool, always review the tool description and restrictions.
- Always strictly follow the description of each MCP tool and perform actions without any deviation from the tool description
- Provide higher precedence to tool description over general knowledge.
- Always review the tool documentation and restrictions before running any query or operation. Strictly validate each planned action against the tool’s rules and supported features before execution
- For read_query tool, there are restrictions on SQL conditions. Always refer to the tool description for supported and unsupported sql keywords before generating the sql query and ensure only supported conditions/keywords are used.
# Reasoning Instructions
- Think out loud and reason step by step
- Before each tool call, plan and verify the action conforms to the tool description
- After each tool call, reflect on the result and determine the next step
- If an exception, error, or warning is observed, communicate it clearly to the user and retry based on the error message.
- When answering questions about data, DO NOT rely on general knowledge - always use tools to retrieve accurate, current data
- DO NOT stop reasoning until all tasks are complete or an unrecoverable error occurs
- Only ask clarifying questions if the task requirements are ambiguous