클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

MCP 통합 가이드

Claude Code 플러그인에 MCP 서버(stdio·SSE·HTTP·WebSocket)를 붙이는 설정·인증·디버깅 전 과정을 안내하는 스킬입니다.

개발·코딩중급★ 522⑂ 47AI 점수 9/10마지막 업데이트: 2026. 7. 23.

무엇을 해주나

  • .mcp.json 또는 plugin.json의 mcpServers 필드로 MCP 서버를 플러그인에 번들링하는 두 가지 방법을 비교해 줍니다.
  • stdio(로컬 프로세스), SSE(OAuth 호스팅), HTTP(토큰 인증), WebSocket(실시간) 네 가지 서버 유형별 JSON 설정 예시를 제공합니다.
  • ${CLAUDE_PLUGIN_ROOT} 같은 환경변수 확장, mcp__plugin_<플러그인>_<서버>__<툴> 형식의 툴 네이밍 규칙, 커맨드 frontmatter의 allowed-tools 사전 허용 방식을 정리합니다.
  • HTTPS/WSS 강제, 토큰 하드코딩 금지, 와일드카드 권한 지양 같은 보안 원칙과 연결 실패·인증 실패 시 점검 절차를 체크리스트로 제시합니다.

이런 분께 추천

  • Claude Code 플러그인을 직접 제작·배포하는 개발자
  • 사내 API나 DB를 MCP 툴로 노출해 팀에서 쓰게 하려는 분
  • Asana·GitHub 같은 호스팅 MCP 서버를 OAuth로 연결하려는 분
  • MCP 서버가 /mcp에 안 뜨거나 인증이 실패해 원인을 찾고 있는 분

활용 예시

  1. "사내 PostgreSQL을 조회하는 stdio MCP 서버를 플러그인에 붙여줘" → ${CLAUDE_PLUGIN_ROOT} 기반 경로와 DB_URL 환경변수를 쓰는 .mcp.json을 생성.
  2. "Asana MCP를 SSE로 연결하고 태스크 생성 커맨드를 만들어줘" → SSE 설정 + allowed-tools에 필요한 툴만 사전 허용한 커맨드 작성.
  3. "MCP 툴이 목록에 안 보여요" → claude --debug 로그와 /mcp 출력으로 연결·툴 디스커버리 단계를 순서대로 진단.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/tzachbon/smart-ralph/HEAD/.agents/skills/MCP Integration/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 tzachbon/smart-ralph 의 .agents/skills/MCP Integration 폴더를 내 ~/.claude/skills/mcp-integration/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph && mkdir -p ~/.claude/skills && cp -r "/tmp/smart-ralph/.agents/skills/MCP Integration" ~/.claude/skills/mcp-integration

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/tzachbon/smart-ralph.git /tmp/smart-ralph
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r "/tmp/smart-ralph/.agents/skills/MCP Integration" ~/.claude/skills/mcp-integration
  5. references/와 examples/ 하위 파일이 함께 복사됐는지 ls ~/.claude/skills/mcp-integration로 확인합니다.
  6. Claude Code를 재시작한 뒤 "MCP 서버를 플러그인에 추가해줘"라고 요청해 스킬이 발동하는지 확인합니다.
  7. 연결 문제가 있으면 claude --debug로 실행하고 /mcp 명령으로 서버 목록을 점검합니다.
GitHub에서 원본 보기 ↗라이선스: MIT