MCP·Skill 설치와 설정 실습 예시

claude mcp add 뒤에 별칭을 주고, -- 다음에 실제로 실행할 명령과 인자를 적는다. -- 는 "여기부터는 서버 실행 명령"이라는 구분자라서, 서버에 넘기는 플래그가 Claude CLI 옵션과 섞이지 않는다. 마지막 인자로 접근을 허용할 경로를 전달한다.

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ./

등록된 서버 목록과 연결 상태를 본다. 방금 추가한 filesystem 이 보이고, 상세를 보고 싶으면 claude mcp get filesystem 으로 실행 명령·스코프·transport를 확인한다.

claude mcp list
claude mcp get filesystem

Claude Code 세션을 다시 열고, 자연어로 파일 작업을 요청한다. Claude가 filesystem 서버가 노출한 도구를 골라 호출하고, 결과를 답변에 반영한다.

이 폴더의 README.md를 읽고 무슨 프로젝트인지 한 줄로 요약해줘

저장소 루트에 .mcp.json 을 만들고 mcpServers 아래에 서버를 정의한다. 비밀값은 파일에 그대로 적지 말고 ${VAR} 형태로 환경변수를 참조하게 둔다. 이 파일은 project 스코프로 취급돼, 저장소를 받은 팀원이라면 누구나 같은 서버를 쓰게 된다.

{
  "mcpServers": {
    "github": {
      "command": "github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

.claude/skills/pr-writer/SKILL.md 를 만든다. YAML frontmatter의 name 은 64자 이하 소문자·숫자·하이픈, description 에는 "무엇을 + 언제 쓰는지"를 적어 트리거가 잘 잡히게 한다. 본문에는 팀의 PR 작성 절차를 마크다운으로 담는다.

---
name: pr-writer
description: 팀 컨벤션에 맞춰 PR 제목·본문을 작성한다. 사용자가 PR 초안, 풀리퀘스트 설명, 머지 요청 글을 요청할 때 사용한다.
---

# PR 작성 규칙

1. 제목은 `[영역] 요약` 형식으로 쓴다.
2. 본문에 변경 이유 · 테스트 방법 · 영향 범위를 항상 포함한다.
3. 관련 이슈 번호를 `Closes #123` 로 연결한다.

두 설정을 저장소에 올린다. 동료가 git pull 후 Claude Code를 열면, .mcp.json 의 서버는 신뢰 확인 뒤 활성화되고 .claude/skills/ 의 Skill은 자동으로 인식된다.

git add .mcp.json .claude/skills/pr-writer/SKILL.md
git commit -m "chore: share github MCP + pr-writer skill"
git push

--transport http 로 원격 서버를 추가하고 엔드포인트 URL을 준다. stdio와 달리 명령을 실행하는 게 아니라, Streamable HTTP로 원격 서버에 연결한다. 서버가 OAuth를 요구하면 첫 연결에서 인증 흐름이 시작된다.

claude mcp add --transport http team-saas https://mcp.example.com/mcp

Claude Code가 인증 페이지로 안내하면 브라우저에서 로그인·동의한다. 발급된 토큰은 클라이언트가 보관하고 이후 요청의 Authorization 헤더에 자동으로 실린다. 연결 상태는 목록으로 확인한다.

claude mcp list
claude mcp get team-saas

스킬을 묶은 플러그인 저장소를 마켓플레이스로 추가한 뒤, 거기서 스킬 플러그인을 설치한다. 설치된 스킬은 다른 Skill과 동일하게 트리거되어, 조직 표준 절차가 모든 구성원에게 일관되게 적용된다.

/plugin marketplace add our-org/claude-skills
/plugin install reporting-suite@our-org