외부 도구 연결하기

MCP는 언제 필요한가요?#

MCP는 Mirr Code에서 외부 서비스의 도구를 사용할 수 있게 연결하는 방식입니다. 예를 들어 이슈 관리 서비스의 목록을 읽거나 디자인 도구의 자료를 작업에 참고할 때 사용할 수 있습니다. 외부 연결이 필요 없는 일반적인 코딩 작업에는 따로 설정할 필요가 없습니다.

연결할 서비스 준비하기#

연결 주소와 로그인 방법은 서비스가 제공하는 공식 MCP 연결 안내에서 확인하실 수 있습니다. 사용하는 서비스의 계정과 이용 권한이 필요할 수 있습니다. 주소만 입력하면 되는 서비스도 있고, 별도 프로그램 설치나 인증이 필요한 서비스도 있습니다.

연결에는 서비스가 공식적으로 제공하는 주소와 출처가 확인된 설치 명령을 사용해 주세요.

주소로 연결하기#

Mirr Code 입력창에서 /mcp를 실행하면 도구 관리 화면이 열립니다. 주소로 연결하는 서비스는 다음 형식으로 추가할 수 있습니다.

/mcp add my-service --http https://example.com/mcp

위 주소는 형식 예시이며 실제 서비스가 아닙니다. my-service는 알아보기 쉬운 이름으로, 주소는 서비스의 공식 안내에서 받은 실제 MCP 주소로 바꿔 입력합니다. 로컬 프로그램으로 제공되는 도구는 배포자의 설치 명령에 따라 설치합니다.

인증이 필요한 경우 /mcp에서 해당 서비스를 선택하고 로그인 안내를 따릅니다. API 키를 사용하는 서비스는 해당 서비스가 안내하는 안전한 방법으로 키를 저장해야 합니다. 키는 대화나 프로젝트 파일에 붙여 넣지 않도록 해 주세요.

연결 후 사용하기#

/mcp에서 연결 상태와 제공 도구를 확인할 수 있습니다. 위 예시의 연결 이름을 사용했다면 /mcp tools my-service로 도구 목록을 볼 수 있습니다.

연결한 서비스가 이슈 조회를 지원한다면 “이 서비스에서 나에게 배정된 미완료 이슈를 보여 줘”처럼 요청하실 수 있습니다. 실제로 제공되는 도구에 따라 가능한 작업이 다릅니다.

외부 도구 연결과 모델 선택은 별개입니다. 실행 권한은 작업 모드와 도구와 권한의 영향을 받습니다. 읽기만 필요한 작업이라면 서비스 계정의 권한도 읽기 범위로 제한해 주세요.

연결 해제와 문제 해결#

더 이상 사용하지 않는 연결은 /mcp remove my-service로 제거할 수 있습니다. 이름은 실제 연결 이름으로 바꿔 입력합니다. 서비스 계정에 부여한 권한을 철회하려면 해당 서비스에서도 연결된 앱이나 토큰을 관리해야 합니다.

도구가 보이지 않을 때는 /mcp에 표시된 연결 상태와 오류부터 확인해 주세요. 주소 오류라면 공식 연결 안내와 비교하고, 로그인 오류라면 해당 서비스에서 인증을 다시 진행합니다. 별도 프로그램이 필요한 연결은 그 프로그램의 설치 여부도 확인해야 합니다.