Copilot Studio MCP 서버: Sume 호스팅 MCP 연결

Copilot Studio 에이전트를 MCP 서버에 연결하려면 에이전트의 Tools 페이지를 열고 Add a tool, New tool, Model Context Protocol을 차례로 선택한 뒤, 서버 이름, 설명, 서버 URL(Sume 호스팅 서버라면 https://mcp.sume.com/mcp)을 입력하세요. Copilot Studio는 SSE가 아닌 Streamable 트랜스포트를 지원하며, Sume가 제공하는 것이 바로 Streamable HTTP입니다. 인증은 헤더 이름이 x-api-key인 API 키 방식을 고르세요. Sume 키는 에이전트 사용자가 입력합니다.

Copilot Studio 쪽 내용은 Microsoft의 기존 MCP 서버에 에이전트 연결, MCP 서버의 도구와 리소스 추가, Model Context Protocol로 에이전트 확장 문서에서, Sume 쪽 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. 따로 밝힌 부분은 현재 서버 코드에서 가져왔습니다. Sume에는 Copilot Studio 전용 커넥터가 없으며, 이 방식은 일반적인 원격 MCP 연결입니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다. 대신 플로에서 Sume REST API를 호출하려면 Power Automate HTTP 요청 API: Sume 실행 시작과 폴링을 참고하세요.

MCP 온보딩 마법사에서 Sume를 어떻게 추가하나요?

Microsoft는 다른 경로인 사용자 지정 커넥터(OpenAPI 스키마 파일로 Power Apps에서 만드는 커넥터)보다 이 마법사를 권장합니다. 또한 MCP를 쓰려면 에이전트에 생성형 오케스트레이션이 켜져 있어야 합니다.

• 에이전트의 Tools 페이지로 가서 Add a tool, New tool, Model Context Protocol을 차례로 선택합니다.
• Server name, Server description, Server URL(https://mcp.sume.com/mcp)을 채웁니다. 오케스트레이터는 런타임에 서버를 호출할지 설명을 읽고 판단하므로, 서버가 하는 일을 적으세요. 예를 들면 “Generates images, video, speech, and music with Sume, and checks those jobs' status.”(Sume로 이미지, 영상, 음성, 음악을 생성하고 그 Job의 상태를 확인함) 같은 설명입니다.
• 인증 유형을 고르고(다음 섹션 참고) Create를 선택합니다.
• Add tool 대화 상자에서 새 연결을 만들거나 기존 연결을 고른 뒤 Add to agent를 선택합니다.

어떤 인증을 선택해야 하나요?

API key를 선택하고 Type은 Header로, 헤더 이름은 x-api-key로 설정하세요. Microsoft 페이지에 따르면 에이전트 사용자가 키를 입력하고, 에이전트는 서버에 보내는 요청에 그 키를 넣습니다. Sume는 호스팅 MCP에서 x-api-key를 받으며, API 키와 지출은 워크스페이스 단위로 해석되므로 에이전트의 호출은 입력된 키가 속한 워크스페이스에 청구됩니다. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다.

OAuth 2.0의 Dynamic discovery는 디스커버리를 통한 동적 클라이언트 등록을 지원하는 서버용입니다. 현재 코드에서 Sume 서버는 등록 엔드포인트를 알리지만 공개 클라이언트만 등록합니다. 즉 S256 PKCE를 쓰고 클라이언트 시크릿은 없습니다. Microsoft 페이지는 Copilot Studio가 어떤 종류의 클라이언트를 등록하는지 밝히지 않으므로, 양쪽 문서가 모두 확인해 주는 경로는 API 키입니다. Sume OAuth 세션은 사용자가 동의 단계에서 Write를 켜기 전까지 읽기 전용이며, 현재 코드에서 토큰은 한 시간 동안 유효하고 갱신할 리프레시 토큰이 없습니다.

에이전트가 알아서 비용을 쓰지 않게 하려면 어떻게 하나요?

에이전트가 쓸 수 있는 도구를 제한하세요. 연결된 MCP 서버가 게시하는 모든 도구는 Copilot Studio에서 쓸 수 있으며, 서버를 추가하면 모두 켜집니다. Sume 서버의 설정 페이지(에이전트의 Tools 탭에서 서버 선택)에서 Allow all 토글을 끄고 에이전트에 필요한 도구만 켜세요. 그러면 MCP 서버의 도구와 리소스 추가에서 설명하듯, Sume가 나중에 추가하는 도구는 기본적으로 꺼진 상태로 남습니다.

Copilot Studio의 도구 세부 정보에는 Ask the end user before running 옵션도 있습니다. 기본값은 No이며, 켜면 에이전트가 도구를 실행하기 전에 확인을 요청합니다. Microsoft는 MCP 서버의 Details 섹션이 다른 도구의 것과 비슷하다고 설명하므로, Sume 서버 페이지에 이 옵션이 보이면 켜세요. 그렇지 않으면 켜 둔 유료 도구는 오케스트레이터가 고를 때마다 실행될 수 있습니다.

Sume 자체 게이트는 사람에게 묻지 않습니다. 유료 호출에는 idempotency_key가 필요하지만, 이는 중복 제거용 키이지 사람의 승인이 아닙니다. dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주고, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다. 에이전트에 대한 Sume의 안내는 읽기 전용 호출부터 시작하고, 유료 생성 전에는 명시적인 확인을 요구하라는 것입니다. 이 게이트들은 유료 API를 호출하는 AI 에이전트의 안전한 자동화에서 다룹니다.

긴 영상 Job은 어떻게 되나요?

영상 렌더는 도구 호출 한 번보다 오래 걸릴 수 있습니다. Sume의 jobs_wait는 호출 한 번을 최대 55초, 기본 50초 동안 열어 둡니다. wait_slice_expired를 받으면 에이전트는 같은 id로 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 도구를 테스트하려면 에이전트에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출한 다음, 세션에 보이는 모든 도구를 나열하는 tools_list를 호출해 달라고 하세요.