뮤즈 사용법 ⑤ 외부 MCP 연결과 오류 해결
Speak AI와 Restream의 공식 연결 예시로 커스텀 커넥터를 이해하고 인증·권한·작업 실패를 구분합니다.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.
연결 오류를 만났을 때 먼저 볼 화면
화면을 보며 따라가기: 아래 이미지는 2026년 10월 26일 확인한 Meta 공식 제품 투어의 모바일 시연 화면입니다. 직접 연결한 계정의 실행 결과가 아니며, 한국어 실습 문장은 이 가이드를 위해 작성했습니다. 웹·Mac·모바일과 업데이트에 따라 메뉴 위치가 다를 수 있습니다. 영어 화면의 버튼 이름을 함께 적었으니 같은 이름을 찾아보세요. 화면에 없는 연결 단계는 공식 도움말로 설명합니다.
커넥터를 연결했는데 답이 없으면 마지막으로 무엇을 했는지부터 봅니다. 공식 시연의 프로필 아래 목록 아이콘에는 실행한 작업과 시간이 표시됩니다. 같은 화면이 제공된다면 실패 직전의 작업 이름과 시각을 확인하세요. 이 이미지는 MCP 설정 화면이 아니며, MCP 연결 경로는 아래 서비스별 공식 문서에 따라 안내합니다.
- Chat에 “방금 연결에서 어느 단계까지 완료됐는지 설명해줘. 인증, 도구 조회, 실제 실행을 나눠줘”라고 요청합니다.
- 로그인 실패라면 외부 서비스 계정과 승인 절차를 확인합니다.
- 로그인은 됐지만 도구가 없으면 해당 서비스의 MCP 주소와 지원 기능을 확인합니다.
- 조회는 되는데 수정만 실패하면 쓰기 권한과 서비스 요금제 조건을 확인합니다.
- 같은 요청을 반복하기 전 실제 외부 서비스에서 이미 실행됐는지 살펴봅니다.
연습 완료 기준: 연결 문구만 보는 대신 회의 한 건 또는 채널 목록처럼 예상 가능한 읽기 결과를 받는 것입니다. 아래 Speak AI·Restream 예시에서 하나만 고르세요.
기본 커넥터에 없는 서비스를 연결할 때
MCP는 AI 도구가 외부 서비스의 기능을 호출하는 데 쓰이는 연결 규약입니다. Muse에서 기본 목록에 없는 서비스를 사용하려면 그 서비스가 제공하는 공식 연결 방법부터 확인하세요. 웹사이트 주소만 붙여 넣는 것과 MCP 서버 주소를 등록하는 것은 다릅니다.
Meta는 대화에서 커스텀 커넥터 생성을 요청하는 경로를 안내합니다. 이번 편에서는 제공자가 Muse 연결법을 직접 문서화한 Speak AI와 Restream을 예로 사용합니다. 이 사이트에서 연결을 실행한 기록은 아니며, 실제 계정의 요금제와 권한을 확인해야 합니다. Meta 커넥터 안내
1. 연결 전에 필요한 정보 네 가지
먼저 아래 정보를 짧게 정리하세요. 값이 없으면 추측해서 채우지 말고 해당 서비스 문서를 확인합니다.
| 확인할 정보 | 확인하는 이유 |
|---|---|
| 서비스의 공식 문서 | 제3자가 만든 비슷한 서버와 구분 |
| MCP 서버 주소 | 일반 홈페이지·REST API 주소와 구분 |
| 인증 방식 | OAuth 로그인인지 API 키 방식인지 확인 |
| 계정·요금제·사용 범위 | 연결 성공과 실제 기능 사용을 구분 |
OAuth는 서비스 로그인 화면에서 접근을 승인하는 흐름입니다. API 키를 사용하는 서비스라면 발급·보관·폐기 절차가 따로 있어요. Muse가 임의로 API 키를 생성할 수 있다고 생각하면 안 됩니다. 로그인 정보는 제공되는 공식 인증 절차에서 처리하세요.
2. Speak AI 연결 예제
Speak AI의 Muse 안내는 서버 주소를 **https://api.speakai.co/v1/mcp**로 제시하고, Muse에 연결을 요청한 뒤 Speak AI에 로그인해 Allow를 선택하는 OAuth 흐름을 설명합니다. 해당 경로에는 API 키를 붙여 넣을 필요가 없다고 명시되어 있어요. Speak AI 공식 문서
실습 순서는 다음과 같습니다.
- 먼저 Speak AI 계정에서 자신이 열 수 있는 녹음이나 전사 자료를 확인합니다.
- Muse에 아래 연결 요청을 보냅니다.
- 표시된 인증 화면에서 올바른 Speak AI 계정인지 확인하고 접근을 승인합니다.
- 연결 후 기존 자료 한 건을 읽는 작은 요청을 합니다.
- 원래 Speak AI 화면에서 같은 자료의 제목·내용을 비교합니다.
Speak AI 연결 요청
Speak AI 읽기 검증
“녹음이 없습니다”는 연결 실패와 다를 수 있어요. 계정이 비어 있거나 다른 워크스페이스를 선택했을 가능성부터 확인하세요. 새 파일을 올려 처리하는 작업에는 별도 사용량이 발생할 수 있으므로 첫 확인은 기존 자료로 진행하는 편이 좋습니다.
3. Restream 연결 예제
Restream은 Muse 채팅에서 https://mcp.restream.io/mcp 연결을 요청하고 계정을 승인한 뒤, 연결된 채널 목록으로 확인하는 방법을 안내합니다. MCP 연결이 요금제 밖의 기능을 해제해 주지는 않는다고 설명합니다. Restream 공식 FAQ
Restream 연결 요청
목록이 나오면 Restream 대시보드에 보이는 채널과 비교합니다. 다음 단계로 특정 과거 방송의 정보를 읽고 싶다면 제목이나 날짜를 지정하세요. “최근 방송”이라는 말이 계정의 여러 채널 중 어느 것을 뜻하는지 모호할 수 있습니다.
실제 방송 예약을 연습할 때는 제목, 날짜, 시간대, 목적지를 먼저 표로 확인합니다. 저장 후에는 예약 ID나 원본 화면에서 상태를 다시 확인하세요. 재시도 전에 같은 예약이 이미 생성됐는지 확인하는 습관은 중복 방송 일정을 막는 데 도움이 됩니다.
4. 직접 만든 API도 바로 연결할 수 있나요?
일반 REST API와 MCP 서버는 같지 않습니다. 홈페이지 URL, 관리자 페이지 URL, 내부 API의 경로를 MCP 주소 대신 넣으면 맞는 응답을 받을 수 없어요. 자체 서비스를 연결하려면 제공자가 지원하는 커스텀 API 연결 절차 또는 별도로 구현한 MCP 서버가 필요할 수 있습니다.
개발자에게 전달할 정보는 “AI랑 연결해 주세요”보다 구체적이어야 합니다. 읽을 데이터, 허용할 변경, 인증 방식, 사용자별 접근 범위, 오류 응답과 로그를 적어주세요. 처음에는 상태 조회처럼 작고 되돌릴 필요가 없는 기능 한 개로 확인하는 편이 좋습니다.
Muse Code의 설정 파일과 터미널 명령은 개발자용 제품의 기능입니다. Muse Code 확장 문서의 설정을 사용자용 Muse 앱의 메뉴라고 소개하지 마세요. 이 시리즈는 휴대전화·웹에서 쓰는 개인 비서 Muse의 연결을 중심으로 설명합니다.
5. 오류를 단계별로 구분하기
| 증상 | 먼저 확인할 것 | 다음 행동 |
|---|---|---|
| 인증 창이 안 열림 | 공식 서버 주소와 앱의 안내 | 주소를 원문과 대조하고 오류 기록 |
| 로그인 뒤 권한 오류 | 계정·워크스페이스·승인 범위 | 서비스에서 접근 권한 확인 |
| 연결됐지만 자료 없음 | 계정 안의 실제 자료 유무 | 알고 있는 제목·날짜로 좁혀 조회 |
| 읽기는 되지만 편집 불가 | 제공 도구·역할·요금제 | 편집 기능이 제공되는지 확인 |
| 작업이 오래 걸림 | 마지막 성공 단계·처리 상태 | 새 작업 생성 전 기존 상태 조회 |
| 결과가 두 번 생김 | 재시도한 시점·기존 작업 ID | 중복 여부 확인 후 정리 범위 결정 |
이 표는 일반적인 진단 순서이지 특정 오류 코드의 공식 해설은 아닙니다. 실제 오류 메시지를 함께 보아야 원인을 좁힐 수 있어요. 화면에 실패가 떴다고 곧바로 계정 전체를 초기화하지 마세요.
실패한 작업 진단
6. 연결을 끝낼 때 정리할 것
더 이상 사용하지 않는 연결은 Muse의 Connectors에서 해제하고 필요하면 원래 서비스에서도 연결 권한을 확인합니다. 예전에 읽은 내용까지 모두 지워졌다고 가정하지 말고, 남은 대화·기억·파일을 별도로 점검하세요.
자동 작업과 연결은 함께 살펴보는 것이 좋습니다. 특정 서비스를 끊었는데 그 서비스를 읽는 예약이 남아 있으면 다음 실행에 실패할 수 있어요. 사용하지 않을 예약도 이름을 확인해 중지 또는 삭제하도록 요청하고 현재 상태를 확인하세요.
이번 실습의 완료 기준
서버가 목록에 나타나는 것만으로 완료하지 않습니다. 올바른 계정으로 인증했고, 의도한 도구가 보이며, 알고 있는 자료 한 건을 정확히 읽었는지까지 확인합니다. 첫 읽기 확인이 성공한 뒤에야 생성·편집 같은 다음 기능으로 넘어가세요. 이 순서라면 문제가 발생했을 때 연결, 자료, 권한, 실행 중 어느 단계인지 찾기 쉽습니다.