클로드코드(Claude Code)를 쓰다 보면 자꾸 비슷해 보이는데 미묘하게 다른 용어들이 우리를 괴롭힙니다. MCP, CLI, 플러그인, 커넥터. 이 넷은 서로 겹치는 것 같으면서도 사실은 각자 맡은 일이 다릅니다. 마치 김밥, 삼각김밥, 참치마요 김밥, 그리고 편의점 김밥 같은 느낌이랄까요. 재료는 겹치는데 용도가 조금씩 다르죠.
이 글에서는 네 가지를 각각 정확하게 정의하고, 실전 예시로 비교해본 뒤, "이럴 땐 뭘 써야 한다"를 명확하게 정리해드리겠습니다.
한 줄 요약부터 보고 시작합시다
| 구분 | 한 줄 정의 | 주 사용처 |
|---|---|---|
| CLI | 클로드코드 그 자체. 터미널에서 치는 claude 명령어 전체 |
세션 시작, 권한 설정, 모든 기반 인터페이스 |
| MCP | 외부 도구/데이터에 클로드를 연결하는 개방형 프로토콜 | GitHub, DB, Sentry, Figma 등 외부 시스템 연동 |
| 플러그인 | 슬래시 명령, 에이전트, 훅, MCP 서버 등을 한 덩어리로 묶은 배포 패키지 | 팀 표준화, 재사용, 마켓플레이스 배포 |
| 커넥터 | Claude.ai 계정에 등록한 원격 MCP 서버를 클로드코드에서도 쓰는 방식 | claude.ai와 클로드코드를 동시에 쓰는 사람 |
이 넷은 경쟁 관계가 아니라 층위가 다른 개념입니다. CLI는 바닥이고, MCP는 외부로 뻗어나가는 길이고, 플러그인은 그 길을 포장해서 배포하는 상자이고, 커넥터는 Claude.ai에서 이미 깔아둔 길을 클로드코드가 빌려 쓰는 방식입니다.
1. CLI: 모든 것의 출발점이자 엔진
CLI가 뭐냐면요
CLI는 Command Line Interface의 줄임말이고, 클로드코드의 본체입니다. 터미널에서 claude라고 치는 순간부터 여러분은 CLI를 쓰고 있는 겁니다. 다른 셋(MCP, 플러그인, 커넥터)은 모두 CLI 위에서 동작합니다. CLI가 없으면 아무것도 없어요.
클로드코드는 npm 패키지로 설치합니다.
# 설치
npm install -g @anthropic-ai/claude-code
# 기본 실행 (대화형 REPL 모드)
claude
# 원샷 모드 (결과 받고 바로 종료)
claude -p "이 저장소 구조를 설명해줘"
# 파이프로 입력 전달
git diff | claude -p "이 변경사항을 리뷰해줘"
# 특정 세션 이어서 하기
claude -c
# MCP 관리 진입점
claude mcpCLI에서 기억해야 할 두 가지 명령 종류
클로드코드 공식 문서에서는 명령을 두 가지로 구분합니다.
첫째, CLI 플래그는 세션 시작 전에 붙이는 옵션입니다. claude --model opus처럼 대시를 붙여서 쓰고, 세션이 시작되기 전에 동작을 결정합니다.
둘째, 슬래시 명령은 세션 안에서 /로 시작하는 명령입니다. /help, /compact, /model, /plugin 같은 것들이 여기에 속합니다. 실행 중인 세션의 상태를 조정할 때 씁니다.
언제 CLI "만" 쓰면 충분한가
- 그냥 코드 짜고, 디버깅하고, 리팩토링 같은 기본 작업만 할 때
- 외부 시스템 연동이 전혀 필요 없는 순수 로컬 작업
- 파이프라인에서
claude -p로 자동화 스크립트 돌릴 때
클로드코드는 기본 상태에서도 파일 읽기, 편집, Bash 실행, Grep, Glob 같은 내장 도구를 다 갖고 있습니다. 그러니까 "난 그냥 코딩 도우미만 필요해"라면 CLI 기본기만으로도 충분합니다.
2. MCP: 외부 세계로 통하는 표준 프로토콜
MCP가 뭐냐면요
MCP는 Model Context Protocol의 약자로, 앤트로픽이 만든 개방형 표준입니다. 클로드가 외부 도구, 데이터베이스, API에 일관된 방식으로 접근할 수 있게 해주는 규격이죠. 사람들이 흔히 "AI의 USB-C"라고 비유하는 그거 맞습니다.
클로드코드는 MCP 클라이언트 역할을 합니다. 그리고 GitHub, Sentry, PostgreSQL, Figma, Stripe 같은 외부 서비스들이 각자 MCP 서버를 제공합니다. 클라이언트(클로드코드)가 서버(GitHub MCP 서버)에 붙어서 도구를 쓰는 구조입니다.
MCP 서버 추가하는 방법
클로드코드는 claude mcp add 명령으로 MCP 서버를 등록합니다. transport에는 stdio, http, sse 세 가지가 있습니다.
# HTTP 방식으로 GitHub MCP 서버 추가 (user 스코프)
claude mcp add --scope user --transport http github https://api.githubcopilot.com/mcp/
# 로컬 stdio 방식
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=your-token \
-- npx -y @modelcontextprotocol/server-github
# JSON으로 복잡한 설정 한 번에 추가
claude mcp add-json weather-api \
'{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'
# 현재 등록된 서버 목록 확인
claude mcp listMCP 스코프와 우선순위
MCP 설정은 네 가지 스코프에 저장할 수 있고, 같은 이름의 서버가 여러 스코프에 있으면 우선순위가 높은 쪽이 이깁니다. 공식 문서 기준 우선순위는 다음과 같습니다.
- local (현재 프로젝트의
.claude/settings.local.json, 기본값) - project (
.mcp.json, 팀 공유용으로 git에 커밋) - user (
~/.claude.json, 전역) - 플러그인 제공 MCP
- Claude.ai 커넥터 (가장 낮음)
팀에서 같이 쓰는 서버는 --scope project로 추가해서 .mcp.json을 저장소에 커밋하면, 팀원들이 클론하자마자 같은 도구를 공유하게 됩니다.
MCP를 언제 쓰냐면요
- "이거 매번 대화창에 복붙하기 귀찮네"라는 생각이 드는 외부 시스템이 있을 때
- 지라 이슈를 읽어서 바로 코드 짜고 싶을 때
- Sentry에서 에러 로그 가져와서 디버깅하고 싶을 때
- Postgres에 직접 쿼리 날려서 데이터 확인하고 싶을 때
- Figma 디자인을 보면서 컴포넌트 코드를 생성하고 싶을 때
MCP의 현실적인 단점 하나
MCP 서버를 많이 붙이면 컨텍스트 윈도우가 빠르게 잠식됩니다. 도구 5개짜리 서버 다섯 개만 붙여도 툴 정의가 5만 토큰을 넘기는 경우가 흔합니다. 이래서 앤트로픽이 Tool Search 기능을 기본 활성화해뒀습니다. 모든 도구 정의를 미리 올리지 않고, 필요할 때 검색해서 쓰는 방식이죠. 그래도 습관적으로 서버 2~3개만 유지하는 게 건강에 좋습니다.
3. 플러그인: 모든 걸 상자에 담아 배포하기
플러그인이 뭐냐면요
플러그인은 클로드코드의 커스텀 기능을 한 덩어리로 묶어서 설치/배포할 수 있게 만든 패키지입니다. 공식 문서에서는 플러그인 구성 요소로 다음을 나열합니다.
- Skills (스킬, 자동 실행 가능한 절차적 지식)
- Agents (서브 에이전트)
- Hooks (이벤트 훅)
- MCP servers (MCP 서버 설정)
- LSP servers (Language Server Protocol)
- Monitors (백그라운드 모니터)
- Themes (색상 테마)
즉, MCP 서버는 플러그인의 한 구성 요소일 수 있습니다. 플러그인이 더 큰 개념인 거죠.
플러그인 디렉터리 구조
my-plugin/
├── .claude-plugin/
│ └── plugin.json # 플러그인 메타데이터 (필수적이진 않음)
├── skills/
│ └── code-reviewer/
│ └── SKILL.md
├── commands/ # 슬래시 명령용 간단한 마크다운
│ └── status.md
├── agents/
│ └── security-reviewer.md
├── hooks/
│ └── hooks.json
├── .mcp.json # 이 플러그인이 제공하는 MCP 서버
├── scripts/
│ └── format-code.sh
└── README.md플러그인 관리 명령
# 마켓플레이스에서 설치
claude plugin install formatter@my-marketplace
# 프로젝트 스코프로 설치 (팀 공유)
claude plugin install formatter@my-marketplace --scope project
# 비활성화 (삭제는 아니고 끄기만)
claude plugin disable formatter
# 설치된 플러그인 목록
claude plugin list
# 업데이트
claude plugin update formatter플러그인은 언제 쓰냐면요
- 여러 저장소에서 같은 슬래시 명령, 같은 훅, 같은 MCP 설정을 쓰고 싶을 때
- 팀 전체에 "코드 리뷰 PR 자동화" 같은 워크플로를 한 방에 배포하고 싶을 때
- 오픈소스 컨트리뷰션으로 클로드코드 확장 기능을 공유하고 싶을 때
- MCP 서버 + 관련 슬래시 명령 + 자동화 훅을 한 세트로 묶어서 전달하고 싶을 때
혼자 작은 스크립트 하나 만들려고 플러그인까지 만들 필요는 없습니다. .claude/commands/ 아래에 마크다운 하나 놓는 것만으로도 슬래시 명령을 추가할 수 있거든요. 플러그인은 "이걸 남한테 줘야 한다" 혹은 "여러 프로젝트에서 재사용해야 한다"는 지점이 왔을 때부터 가치가 있습니다.
4. 커넥터: Claude.ai가 놓은 다리
커넥터가 뭐냐면요
용어가 문맥마다 조금씩 다르게 쓰이는데, 가장 흔하게 말하는 "커넥터"는 Claude.ai 웹 UI의 Settings → Customize → Connectors에서 등록하는 원격 MCP 서버입니다. 본질적으로 MCP 서버 맞는데, Claude.ai 계정에 묶여 있고 웹 UI로 쉽게 관리된다는 점이 다릅니다.
클로드코드 입장에서 커넥터의 핵심 특징은 이것입니다. Claude.ai 계정으로 클로드코드에 로그인하면, Claude.ai에서 추가한 커넥터가 클로드코드 MCP 서버 목록에 자동으로 나타납니다. 원격으로 OAuth까지 처리된 채로요.
# 클로드코드에서 MCP 목록을 보면 claude.ai 커넥터도 보입니다
claude mcp list
# ...
# claude.ai Figma
# claude.ai Google Drive
# claude.ai Gmail
# ...커넥터 비활성화
Claude.ai 커넥터가 너무 많아서 컨텍스트가 부담스럽다면 환경 변수로 끌 수 있습니다.
export ENABLE_CLAUDEAI_MCP_SERVERS=false커넥터는 언제 쓰냐면요
- Claude.ai 웹 채팅과 클로드코드를 동시에 쓰는 사람
- 로컬에 MCP 서버 설치하기 귀찮고 OAuth만 눌러서 바로 쓰고 싶은 서비스 (Gmail, Google Drive, Figma 등)
- 팀/엔터프라이즈 플랜에서 관리자가 중앙에서 커넥터를 관리하고 구성원들에게 공통 제공하고 싶을 때
커넥터가 적합하지 않은 경우
- 프로젝트 저장소에 MCP 설정을 커밋해서 팀원과 공유하고 싶을 때는
.mcp.json기반 project 스코프가 더 낫습니다 - 로컬 Docker로 돌리는 DB나 내부망 서비스처럼 원격 MCP 서버가 없는 경우
개념 관계도
┌─────────────────────────────────────────────────────┐
│ CLI │
│ (claude 명령어 — 이 바닥 위에서 나머지가 다 돌아감) │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │
│ │ 플러그인 │ │ MCP │ │ 커넥터 │ │
│ │ (묶음 패키지) │ │ (외부 연결 규격) │ │(Claude.ai 쪽) │ │
│ │ │ │ │ │ │ │
│ │ 안에 MCP │→ │ GitHub │ │ Figma │ │
│ │ 서버 포함 가능 │ │ Sentry │ │ Gmail │ │
│ │ skills 포함 │ │ Postgres │ │ Drive │ │
│ │ hooks 포함 │ │ Figma │ │ │ │
│ └──────────────┘ └──────────────┘ └────────────┘ │
└─────────────────────────────────────────────────────┘시나리오별 의사결정 가이드
시나리오 1: "혼자 쓰는 개발자다. 리액트 프로젝트 코드만 잘 짜면 된다"
CLI만 쓰세요. claude로 실행하고 그냥 코딩하시면 됩니다. 필요하면 .claude/commands/pr.md 정도로 슬래시 명령 몇 개 만들면 충분합니다.
시나리오 2: "지라 이슈를 읽어서 바로 코드를 짜고 PR을 올리고 싶다"
MCP 서버를 추가하세요. 아틀라시안 공식 MCP 서버와 GitHub MCP 서버 두 개를 user 스코프로 붙이면 됩니다.
claude mcp add --scope user --transport http github https://api.githubcopilot.com/mcp/
claude mcp add --scope user --transport http atlassian https://mcp.atlassian.com/v1/mcp시나리오 3: "팀원 5명이 똑같은 설정으로 쓰고 싶다"
프로젝트 루트의 .mcp.json에 project 스코프로 MCP 서버를 추가하고 git에 커밋하세요. 클론만 하면 팀원 모두 같은 도구를 씁니다.
claude mcp add --scope project --transport http stripe https://mcp.stripe.com시나리오 4: "팀 표준 코드 리뷰 프로세스 + 자동 포맷팅 훅 + 전용 슬래시 명령을 한 방에 배포하고 싶다"
플러그인을 만드세요. 슬래시 명령, 훅, MCP 설정을 한 폴더에 묶고 마켓플레이스(내부 깃허브 저장소여도 됩니다)에 올리면 팀원들은 한 줄로 설치합니다.
claude plugin install company-review-toolkit@internal-marketplace --scope project시나리오 5: "Claude.ai 웹에서도 쓰고 클로드코드에서도 Gmail이랑 구글 드라이브 좀 쓰고 싶다"
Claude.ai 웹 UI에서 커넥터로 추가하세요. 클로드코드에 동일 계정으로 로그인만 해두면 자동으로 따라옵니다. MCP 서버를 로컬에서 수동 설치할 필요가 없습니다.
자주 헷갈리는 포인트 정리
Q1. MCP랑 커넥터는 결국 같은 거 아닌가요?
커넥터는 MCP의 한 부분집합입니다. 정확히 말하면 Claude.ai 계정을 통해 원격으로 제공되는 MCP 서버를 특정 제품 맥락에서 "커넥터"라고 부르는 겁니다. 개념은 MCP, 제품 UI 용어는 커넥터. 이렇게 기억하시면 편합니다.
Q2. 플러그인이 MCP 서버를 담고 있으면, 그 플러그인을 설치하는 게 MCP 추가인가요?
네, 맞습니다. 플러그인에 .mcp.json이 들어 있으면 플러그인을 활성화하는 순간 그 MCP 서버들도 자동으로 켜집니다. 별도로 claude mcp add 할 필요가 없습니다.
Q3. 동일한 MCP 서버가 커넥터에도 있고 .mcp.json에도 있으면요?
local > project > user > 플러그인 제공 > Claude.ai 커넥터 순서로 우선순위가 정해지고, 가장 높은 쪽 정의가 실제로 연결됩니다. 프로젝트 .mcp.json에 명시적으로 적어뒀다면 그게 이깁니다.
Q4. CLI 없이 MCP나 플러그인만 쓸 수 있나요?
불가능합니다. MCP도 플러그인도 결국 클로드코드 CLI 프로세스 안에서 로딩됩니다. CLI가 최소 조건이에요.
마치며
네 가지를 구분해놓고 보니 겹치는 영역이 있긴 해도 각자 맡은 자리가 뚜렷합니다. CLI는 토대, MCP는 외부로 뻗어나가는 표준 연결선, 플러그인은 여러 구성 요소를 묶은 배포 단위, 커넥터는 Claude.ai가 관리하는 원격 MCP 서버를 편하게 빌려 쓰는 경로입니다.
처음 클로드코드를 쓸 땐 CLI만으로 시작하시고, 반복적으로 외부 시스템을 건드리게 되면 MCP를 하나씩 붙이고, 팀에 전파할 만한 워크플로가 생기면 플러그인으로 포장하고, Claude.ai랑 병행한다면 커넥터를 활용하는 흐름이 가장 자연스럽습니다. 필요할 때 필요한 만큼만 늘려가는 게 컨텍스트 토큰도 아끼고 설정 지옥도 피하는 길입니다.
이제 누가 "MCP랑 커넥터 차이가 뭐예요?" 하고 물어보면 자신 있게 한 문단 설명하실 수 있을 겁니다. 마음 같아서는 그분께 이 글을 보내드리시면 가장 빠르겠지만요.
참고 자료
- Claude Code 공식 문서 — MCP: https://code.claude.com/docs/en/mcp
- Claude Code 공식 문서 — 플러그인 레퍼런스: https://code.claude.com/docs/en/plugins-reference
- Claude Code 공식 문서 — CLI 레퍼런스: https://code.claude.com/docs/en/cli-reference
- Claude Code 공식 문서 — 명령 개요: https://code.claude.com/docs/en/commands
- Claude.ai 도움말 — 원격 MCP 기반 커스텀 커넥터: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
- Claude Developer Platform — MCP 커넥터: https://platform.claude.com/docs/en/agents-and-tools/mcp-connector
- Claude Code npm 패키지: https://www.npmjs.com/package/@anthropic-ai/claude-code
'IT > AI' 카테고리의 다른 글
| 메타 Muse Spark 등장과 154조 원 베팅, 오픈소스의 왕은 왜 닫힌 문을 선택했나 (0) | 2026.05.12 |
|---|---|
| 클로드 미토스(Claude Mythos) 무단 접근 사건 정리: '보안 핵폭탄' AI는 어떻게 새어 나갔나 (2) | 2026.04.27 |
| ChatGPT 5.5 vs Claude Opus 4.7 최신 AI 모델 비교 (1) | 2026.04.24 |
| Claude Opus 4.7 출시 총정리: 4.6, Sonnet 4.6, GPT-5.4와 무엇이 다른가? (6) | 2026.04.17 |
| Claude Code에서 Codex 플러그인으로 코드 리뷰 맡기기: codex-plugin-cc 완벽 가이드 (3) | 2026.04.13 |