claude-code·발행 2026.06.01·조회 3
Claude가 내 Gmail·구글시트를 못 본다고요? /mcp로 외부 앱 연결하는 법
/mcp는 대화 중에 Gmail·GitHub 같은 외부 앱 연결(MCP)을 관리하는 명령입니다. 연결 상태 보기, OAuth 로그인 인증, 작업별 연결 관리를 단계별로 정리했습니다.
클로드 코드(Claude Code)에게 "내 Gmail에서 거래처 메일 찾아줘"라고 했더니 "메일에 접근할 수 없다"고 한 적 있나요? AI는 기본적으로 내 외부 앱(메일, 시트, GitHub 등)을 못 봅니다. 이걸 이어주는 통로가 바로 MCP고, /mcp는 그 연결을 관리하는 명령이에요. 연결하는 순간 클로드 코드가 진짜 내 일을 하기 시작합니다.
정의
/mcp는 대화 중에 외부 앱 연결(MCP)을 관리하는 명령입니다.
여기서 'MCP(Model Context Protocol)'란 클로드 코드와 외부 서비스를 잇는 표준 연결 통로예요. USB 케이블이 컴퓨터와 기기를 잇듯, MCP는 AI와 Gmail·구글시트·GitHub 같은 앱을 잇습니다. /mcp로는 어떤 앱이 연결돼 있는지 보고, 새 앱을 붙이고, 로그인(OAuth) 인증을 할 수 있어요.
(참고로 'OAuth'는 비밀번호를 직접 넘기지 않고 "이 앱에 접근 허용" 버튼만 눌러 권한을 주는 표준 로그인 방식입니다. 터미널에서 관리하고 싶다면 claude mcp 명령도 있어요.)
사용법 (난이도별)
기초 — 연결 상태 보기
대화창에 입력합니다.
/mcp
그러면 현재 연결된 서버(앱) 목록과 각각의 연결 상태가 화면에 뜹니다. 무엇이 연결돼 있고, 무엇이 인증이 필요한 상태인지 한눈에 볼 수 있어요.
응용 — 앱 로그인 인증하기
/mcp
/mcp 화면에서 인증이 필요한 앱을 고르면 로그인(OAuth) 절차가 시작됩니다. 보통 브라우저가 열리면서 "이 앱에 접근을 허용하시겠습니까?" 화면이 떠요. 허용을 누르면 인증이 끝나고, 그때부터 클로드 코드가 그 앱(예: Gmail)의 데이터를 다룰 수 있습니다.
심화 — 작업별로 연결 관리하기
필요한 앱만 연결하고, 끝나면 해제
작업에 맞춰 도구를 붙였다 뗐다 하세요. 메일 정리 작업엔 Gmail만, 코드 작업엔 GitHub만 연결하는 식이에요. 안 쓰는 연결은 정리해두면 권한 범위가 좁아져 더 안전합니다.
흔한 함정 — 연결만 하고 인증을 안 했을 때
앱을 목록에 추가했는데도 "접근 권한이 없다"는 답이 나온다면, 연결은 했지만 로그인(OAuth) 인증을 안 끝낸 경우가 많습니다. 연결 추가와 인증은 별개의 단계예요. /mcp 화면에서 해당 앱의 상태가 '인증 필요'로 떠 있는지 확인하고, 로그인 절차를 마쳐주면 됩니다.
실전 사례
쌓인 메일을 정리하는 작업을 맡기기 전에, /mcp로 Gmail 연결을 먼저 인증했습니다. 브라우저에서 접근 허용을 한 번 누르니, 클로드 코드가 메일을 읽고 분류할 수 있게 됐어요. 작업이 끝난 뒤엔 연결을 정리해 권한을 거둬들였습니다. 필요할 때만 통로를 열고, 끝나면 닫는 식이죠.
이렇게 더 씁니다
- 연결 추가·인증: 새 앱을 붙이고 OAuth 로그인을 승인.
- 터미널 버전: 터미널에서는
claude mcp명령으로도 관리할 수 있습니다. - 앱 이어붙이기: Gmail과 구글시트를 함께 연결하면 "메일 읽어 시트에 정리" 같은 한 흐름이 가능.
- 작업별 연결: 필요할 때만 붙이고, 끝나면 정리해 권한을 최소화.
팁: 모든 앱을 항상 연결해둘 필요는 없습니다. 지금 작업에 필요한 앱만 그때그때 연결하는 게 보안에도, 관리에도 깔끔해요.
다른 사람들은 이렇게 씁니다
- HTTP transport 덕분에 GitHub MCP를 명령 한 줄로 간단히 연결할 수 있다(Docker 불필요). — Adding an MCP server to Claude Code (MCPcat)
- GitHub 공식 MCP로 이슈·PR 관리, CI 실패 분석, 릴리스 관리까지 터미널에서 처리. — GitHub 공식 MCP Server
정리
핵심은 한 문장입니다. 연결할수록 클로드 코드가 강해진다. MCP는 AI와 내 앱을 잇는 케이블이고, /mcp로 그 연결을 관리해요. 연결 추가와 로그인 인증은 별개 단계라는 것만 기억하세요. 필요한 도구를 하나씩 붙여가면, 클로드 코드가 점점 진짜 내 일을 대신하게 됩니다.
기준: Claude Code v2.1.154 (2026.05)
Comments
댓글 0
로그인 상태 확인 중…
댓글 불러오는 중…