Copilot Studio MCP Server
Microsoft Copilot Studio에서 사용할 수 있는 예제 MCP 서버입니다. Python과 공식 MCP Python SDK를 사용하며, 아래 두 도구를 제공합니다.
echo: 입력한 문장을 3번 반복multi: 입력한 숫자를 제곱
기술 기준
- 언어: Python
- SDK:
mcp[cli] - 전송 방식:
Streamable HTTP - 권장 실행 구성:
stateless_http=True,json_response=True
파일 구성
.
├─ server.py
├─ pyproject.toml
├─ README.md
├─ CUSTOM_INSTRUCTIONS.md
└─ MCP_SERVER_REQUIREMENTS.md
요구 사항
- Python 3.10 이상
- Copilot Studio에서 MCP를 사용하려면
Generative orchestration이 활성화되어 있어야 함
설치
uv 사용
uv sync
pip 사용
pip install "mcp[cli]>=1.9.0"
실행
python server.py
서버는 MCP Streamable HTTP 방식으로 실행됩니다. 기본 경로는 일반적으로 /mcp를 사용합니다.
PowerShell 빠른 실행
프로젝트 폴더에서 아래 스크립트로 실행할 수 있습니다.
.\start_mcp_server.ps1
중지할 때는 아래 스크립트를 사용합니다.
.\stop_mcp_server.ps1
PowerShell 실행 정책 때문에 .ps1 실행이 막히면 아래 .cmd 파일을 사용합니다.
.\start_mcp_server.cmd
.\stop_mcp_server.cmd
start_mcp_server.cmd는 새 PowerShell 창을 열어 서버를 실행하므로, 그 창이 열려 있는 동안 MCP 서버가 유지됩니다.
도구 설명
1. echo
- 설명: 입력된 문장을 정확히 3번 반복해서 반환
- 입력:
{
"message": "안녕하세요"
}
- 출력:
"안녕하세요 안녕하세요 안녕하세요"
2. multi
- 설명: 입력된 숫자를 제곱해서 반환
- 입력:
{
"number": 5
}
- 출력:
25
Copilot Studio 연결 개요
- Copilot Studio에서 에이전트를 연다.
Generative orchestration이 활성화되어 있는지 확인한다.- MCP 서버 추가 화면에서 이 서버의 URL을 등록한다.
- 연결 후
echo,multi도구가 자동으로 표시되는지 확인한다.
참고
- Copilot Studio는 MCP 서버의 도구 이름, 설명, 입력, 출력을 자동 반영한다.
- Copilot Studio는
Streamable transport를 지원한다. - SSE는 Copilot Studio에서 2025년 8월 이후 지원되지 않는다.
