클로드코드 /mcp: Gmail·구글시트 외부 앱 연결하는 법

클로드 코드(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로 그 연결을 관리해요. 연결 추가와 로그인 인증은 별개 단계라는 것만 기억하세요. 필요한 도구를 하나씩 붙여가면, 클로드 코드가 점점 진짜 내 일을 대신하게 됩니다.

FAQ · 자주 묻는 질문

MCP로 연결하면 클로드가 제 메일을 전부 마음대로 보는 건가요?

아니요. 클로드는 내가 OAuth로 접근을 허용한 앱의, 허용한 범위만 볼 수 있습니다. 비밀번호를 넘기는 방식이 아니고, 연결은 언제든 /mcp에서 해제할 수 있어요. 작업이 끝나면 안 쓰는 연결을 정리해 권한을 최소로 유지하는 게 안전합니다.

코딩을 몰라도 /mcp로 앱을 연결할 수 있나요?

네, 가능합니다. 대화창에 /mcp를 입력해 목록에서 앱을 고르고, 브라우저에 뜨는 "접근 허용" 버튼을 누르면 끝입니다. 코드를 작성할 일은 없습니다.

MCP 연결에 따로 돈이 드나요?

MCP 연결 자체는 무료입니다. 연결하려는 서비스(Gmail, GitHub 등)의 계정만 있으면 돼요. 다만 일부 외부 서비스는 자체 유료 플랜이 있을 수 있으니, 그 서비스의 요금 정책은 따로 확인하세요.

연결했는데 "접근 권한이 없다"고 나옵니다. 왜 그런가요?

연결 추가와 로그인 인증이 별개 단계라서 그렇습니다. 앱을 목록에 추가했어도 OAuth 인증을 안 끝냈으면 접근이 안 돼요. /mcp 화면에서 해당 앱이 '인증 필요' 상태인지 확인하고 로그인을 마치면 해결됩니다.

기준: Claude Code v2.1.154 (2026.05)