MCP가 연결됐는데 작동하지 않나요? Mono에서 단계별로 진단하기

MCP 서버를 저장했다고 도구가 작동하는 것은 아닙니다. 주소가 맞아도 로그인이 끝나지 않았을 수 있습니다. 로그인이 성공해도 서버의 도구를 불러오지 못할 수 있습니다. 도구를 불러왔어도 잘못된 요청을 받을 수 있습니다. 설정을 바꾸기 전에 처음 실패하는 단계를 찾으세요.

이 가이드는 Reunified Mono의 문제 해결을 다룹니다. Mono는 아직 출시 전입니다(대기 명단에 등록할 수 있습니다). 처음 연결한다면 MCP 설정 가이드를 사용하세요. 여기서의 목표는 막연한 “안 돼요”를, 쓰기 작업을 실수로 반복하지 않으면서 다시 확인할 수 있는 분명한 관찰 하나로 바꾸는 것입니다.

1. 증상을 기록하고 결과가 불분명한 재시도를 멈추세요

서버 이름, 전송 방식, 기기, 앱 버전, 하려던 일, 정확한 오류를 비밀 정보 없이 적으세요. 같은 설정이 예전에는 작동했는지, 그 뒤로 무엇이 바뀌었는지도 적어 두세요. “MCP가 고장 났다”보다 “로그인 후 도구 목록이 비어 있다”가 더 쓸모 있습니다.

마지막 요청이 무언가를 만들거나, 보내거나, 바꿀 수 있었다면 다시 시도하기 전에 대상을 확인하세요. 응답이 사라졌다고 작업이 일어나지 않았다는 뜻은 아닙니다. 확인할 때는 직접 점검할 수 있는 테스트 프로젝트의 항목 하나를 나열하는 것처럼, 읽기 전용의 작은 요청으로 바꾸세요.

마지막으로 작동하던 설정의 사본을 비공개로 보관하세요. 공개 지원 요청에 토큰, 인증 코드, 도구의 비공개 출력을 붙여 넣지 마세요.

2. 계정보다 전송 방식을 먼저 확인하세요

Mono의 HTTP 연결에는 일반 홈페이지나 모델 API 주소가 아니라 MCP 서버 주소가 필요합니다. 경로를 포함한 전체 URL을 서버 제공자의 최신 문서와 비교하세요. 브라우저에서 페이지가 열린다는 것은 그 페이지에 접속된다는 뜻일 뿐, 거기서 MCP가 작동한다는 뜻은 아닙니다.

‘표준 입출력’(stdio)이라면, 그것을 실행해야 하는 기기에서 명령과 인수를 확인하세요. 명령이 없거나 기기에서 실행할 수 없는 문제는 다시 로그인해도 해결되지 않습니다. 휴대폰과 컴퓨터는 다르므로 컴퓨터용 명령이 휴대폰에서 실행되리라 기대하지 마세요.

localhost가 들어간 주소는 요청을 보내는 기기 자신을 가리킵니다. 실제 기기에서, 지원되고 로그인된 경로로 시험하세요. 테스트를 통과시키려고 잘 작동하는 서버의 접근 제어를 약하게 만들지 마세요.

3. 설정 저장과 인증 완료를 구분하세요

선택한 인증 방식을 확인하세요. ‘Bearer 토큰’은 해당 서비스의 올바른 토큰을 전용 칸에 넣어야 합니다. OAuth는 올바른 계정, 서버의 요구 사항, Mono로 완전히 돌아오는 과정이 필요합니다. 브라우저를 일찍 닫으면 로그인에 성공한 것이 아닙니다.

Mono는 로그인이 끝나기 전에도 서버를 저장할 수 있으므로, 저장된 서버가 로그인 성공을 증명하지는 않습니다. 로그인에 성공한 뒤에도 한동안 서버의 도구를 불러오지 못할 수 있습니다. 저장된 항목도, ‘서버에 연결됐어요’ 메시지도 특정 도구가 준비되었다는 증거는 아닙니다.

서버 URL이나 전송 방식을 바꾸면 Mono는 새 연결로 취급하므로 다시 로그인해야 할 수 있습니다. 주소의 실제 오류는 고치되, 잘 작동하는 URL을 초기화하듯 계속 바꾸지 마세요. 값을 추측하지 말고 제공자가 문서로 안내하는 클라이언트와 리디렉션 설정을 따르세요.

4. 제공 기능과 선택한 모델을 확인하세요

MCP 아키텍처는 도구, 리소스, 프롬프트를 구분합니다. 서버는 이 중 일부만 제공할 수 있으므로, 리소스만 제공하는 서버는 도우미가 호출할 도구를 주지 않습니다.

설치한 MCP 스킬은 ‘설정’ 섹션을 열어 Mono가 찾은 도구를 확인하세요. 비어 있다면 로그인과, 서버가 도구 목록을 제공하는지 확인하세요. 서비스의 모든 작업을 쓸 수 있다고 생각하지 마세요. 서버를 저장하는 것은 완전한 상태 점검이 아닙니다.

채팅에서 쓰는 모델도 확인하세요. 모든 모델이 도구를 호출할 수 있는 것은 아니며, 직접 연결한 모델 중에도 그런 모델이 있습니다. 텍스트로는 잘 답하는 모델이라도 연결된 도구가 한 번도 쓰이지 않는 원인이 될 수 있습니다. 자세한 내용은 사용자 지정 엔드포인트 가이드를 참고하세요.

5. 알고 있는 작업 하나를 시험하세요

무해한 요청을 사용하고 결과를 원래 서비스와 비교하세요.

내가 지정하는 기존 데모 항목의 제목을 읽어 주세요.
생성, 편집, 전송, 삭제는 하지 마세요.
접근에 실패하면 제목을 추측하지 말고 실패를 알려 주세요.

도구 자체의 오류는 비어 있지만 성공한 결과와 다릅니다. 반환된 상태와 관련 텍스트를 비밀 정보 없이 함께 보관하세요.

6. 해결 여부를 확인하고 지원 기록을 남기세요

한 번에 하나만 바꾸고, 같은 읽기 전용 테스트를 반복해 결과를 기록하세요. 나중에 쓰기 작업이 필요하면 정확한 대상을 확인하고, 다시 시도하기 전에 서비스에서 결과를 확인하세요.

실패한 단계, 버전, 바꾼 내용, 마지막으로 성공한 테스트를 짧게 기록해 두세요. Mono에서 연결을 삭제하는 것과 제공자 쪽에서 접근을 취소하는 것은 별개의 단계입니다. 사용 중 권한 결정에 대해서는 도구 권한 검토 가이드를 읽으세요. 승인을 거듭해도 연결은 고쳐지지 않습니다.