Copilot CLI MCP 서버: copilot mcp add로 Sume 추가

GitHub Copilot CLI에 MCP 서버를 추가하려면 터미널에서 copilot mcp add를 실행하거나, 세션 안에서 /mcp add를 실행하세요. 원격 서버에는 --transport http, 이름, URL을 넘기며, 이 하위 명령은 서버를 ~/.copilot/mcp-config.json에 저장합니다. Sume 호스팅 MCP 서버라면 copilot mcp add --transport http sume https://mcp.sume.com/mcp에 API 키 헤더나 OAuth 로그인을 더하고, --timeout은 기본값 30000 ms를 넘게 잡으세요. Sume의 jobs_wait는 호출 한 번을 55초까지 붙잡아 둘 수 있기 때문입니다.

GitHub 쪽 내용은 GitHub Copilot CLI용 MCP 서버 추가하기, CLI 명령어 레퍼런스, GitHub Copilot CLI 사용하기에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-28에 확인했습니다. Sume에는 Copilot CLI 전용 연동이 없습니다. CLI는 다른 원격 MCP 서버와 똑같이 Sume 원격 MCP 서버에 연결하며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. Copilot의 클라우드 에이전트는 다른 클라이언트이며, GitHub Copilot 코딩 에이전트 MCP에서 다룹니다.

copilot mcp add로 Sume를 어떻게 추가하나요?

copilot mcp add는 인터랙티브 세션을 시작하지 않고 사용자 설정에 기록합니다. 트랜스포트는 Sume 문서가 원격 클라이언트에 쓰라고 안내하는 Streamable HTTP, 즉 http를 고르세요. sse는 절대 쓰지 마세요.

셸이 $SUME_API_KEY를 확장하므로, ~/.copilot/mcp-config.json의 항목에는 키 값 자체가 저장됩니다. 이 파일은 남에게 공개하지 마세요. 이 파일의 headers 필드는 변수 확장을 지원하므로, 항목을 편집해 대신 환경 변수를 참조하게 할 수 있습니다. 그다음 서버의 유형, 상태, 사용할 수 있는 도구를 보여 주는 copilot mcp get sume를 실행하고, Copilot에게 Sume의 읽기 전용 탐색 도구인 mcp_health와 tools_list를 호출해 달라고 하세요.

copilot mcp add --transport http \
  --header "Authorization: Bearer $SUME_API_KEY" \
  --tools "mcp_health,tools_list,tools_schema,generate_image,jobs_status,jobs_wait,jobs_result" \
  --timeout 60000 \
  sume https://mcp.sume.com/mcp

Sume 서버의 타임아웃은 얼마로 잡아야 하나요?

55000 ms를 넘어야 하며, 이 글에서는 60000을 씁니다. 서버 항목의 timeout은 도구 탐색과 도구 호출에 적용되며 기본값은 30000 ms입니다. Sume의 jobs_wait는 호출 한 번을 최대 55초, timeout_seconds를 생략하면 50초 동안 열어 두므로, CLI 기본값 그대로라면 끝나지 않은 Job을 기다리는 대기가 CLI 한도를 넘어섭니다. 클라이언트 쪽 타임아웃은 Job을 취소하지 않으며, Job은 계속 실행되고 계속 청구됩니다.

긴 렌더링은 슬라이스 단위로 기다립니다. wait_slice_expired를 받으면 Copilot은 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 이 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

Copilot CLI는 OAuth로 Sume에 로그인할 수 있나요?

--header를 빼면 양쪽 문서에 나온 기본값이 서로 맞아떨어집니다. 원격 서버에 대한 CLI의 기본 OAuth 그랜트는 브라우저 기반 플로인 authorization_code이고, oauthPublicClient의 기본값은 true이며, 고정 oauthClientId를 지정하면 동적 등록을 건너뜁니다. 현재 Sume 서버는 등록 엔드포인트와, 퍼블릭 클라이언트용 PKCE를 쓰는 authorization_code 그랜트를 알리므로 oauthClientId는 설정하지 마세요. 동의는 Sume MCP 호스트에서 이뤄지며, Read는 고정 켜짐, Write 토글은 기본 꺼짐입니다. 읽기 전용 세션은 generate_image 같은 유료 도구에서 insufficient_scope를 받으므로, Copilot이 미디어를 생성해야 한다면 Write를 켜세요.

한계 두 가지는 현재 Sume 코드에서 나옵니다. OAuth 토큰은 한 시간 동안 유효하고, Sume는 리프레시 토큰을 발급하지 않습니다. 토큰이 만료되면 CLI에 needs-auth 상태가 표시될 수 있으니, 대략 한 시간마다 이 상태를 보게 된다고 생각하세요. /mcp auth sume를 실행하면 브라우저에서 새 OAuth 플로가 시작됩니다. CLI의 헤드리스 방식인 client_credentials 그랜트에는 컨피덴셜 클라이언트가 필요한데, 현재 Sume 서버는 authorization_code만 제공하므로 CI와 copilot -p 스크립트에서는 API 키 헤더를 쓰세요. 자세한 내용은 Sume MCP OAuth 플로의 동작 방식에서 다룹니다.

Copilot이 묻지 않고 비용을 쓰지 않게 하려면 어떻게 하나요?

GitHub 레퍼런스에 따르면 모든 MCP 도구 호출에는 명시적인 허가가 필요하며, 읽기 전용 도구도 마찬가지입니다. 도구 승인 프롬프트에 대해 GitHub 가이드는 다음번에 다시 묻는 일반 Yes와, 실행 중인 세션이 끝날 때까지 그 도구를 승인하는 Yes를 설명합니다. Sume 유료 도구에는 일반 Yes를 고르세요.

시작할 때 --allow-tool과 --deny-tool은 SERVER-NAME(tool) 패턴을 받으며, 여러 패턴은 따옴표로 감싼 쉼표 구분 목록 하나로 넘깁니다. 거부 규칙은 --allow-all이 설정돼 있어도 항상 우선합니다. 이 점은 스크립트에서 중요합니다. 레퍼런스에 따르면 프로그래밍 방식으로 쓸 때는 모든 도구를 확인 없이 실행하는 --allow-all-tools가 필요하므로, 스크립트에서는 Sume 유료 도구를 거부하세요. 다음 세션은 Sume의 Job 읽기 도구를 묻지 않고 실행하며, 유료 이미지는 시작할 수 없습니다.

copilot --allow-tool='sume(jobs_status),sume(jobs_wait),sume(jobs_result)' \
  --deny-tool='sume(generate_image)'

실제로 쓰기 전에 또 무엇을 알아야 하나요?

• Sume 유료 도구에는 각각 idempotency_key가 필요합니다. dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다. 이 인수들은 모델이 작성하므로, 여러분의 설정이 강제하는 한도가 아닙니다.
• API 키 세션에는 Sume의 전체 호스팅 도구 세트가 보이며, 지출은 그 키의 워크스페이스로 귀속됩니다.
• 저장소에서는 .github/mcp.json으로 서버를 공유할 수 있습니다. 이 파일은 저장소에 커밋되는 설정을 두는 GitHub의 위치이며, .mcp.json은 로컬 설정이나 체크아웃별 설정용입니다. 두 파일 모두 신뢰하는 폴더에서만 로드됩니다. 항목은 키를 빼고 커밋하세요.
• Copilot CLI는 VS Code의 .vscode/mcp.json을 읽지 않습니다. 그 클라이언트는 VS Code 원격 MCP 서버에서 다룹니다.