MCP 서버: Claude를 스택에 연결하기
MCP 서버를 설치하고 구성하여 Claude가 Slack, Supabase, Notion, GitHub에 실시간으로 액세스할 수 있도록 합니다. 접착 코드(glue code)는 필요하지 않습니다.
스킬은 ~/.claude/skills/에 프론트매터가 있는 마크다운 파일입니다. Claude는 설명 필드를 읽어 스킬을 발견합니다. 요청이 일치하면 런북을 로드하고 따릅니다. 지침을 한 번 작성하면 매번 동일한 단계를 얻을 수 있습니다.
---
name: translate-pi-jargon
description: PI 법률 용어를 평이한 영어로 번역합니다. 사용자가 법률 텍스트를 붙여넣거나 UM/UIM, demand letter, lien과 같은 용어를 참조할 때 사용합니다.
---
# PI 용어 번역
1. 용어를 한 문장으로 평이하게 다시 설명합니다.
2. 언제 중요한지 한 문장 예시를 제공합니다.
3. 시간 압박이 있는 모든 것(법령, 마감일)을 표시합니다.동일한 레시피를 Claude에 세 번째 붙여넣을 때 스킬을 작성하십시오.
설명은 발견 메커니즘입니다. Claude는 설명을 읽고 어떤 스킬이 요청에 적용되는지 결정합니다.
나쁨: "문서 작업용 스킬." Claude는 언제 적용되는지 알 수 없습니다.
좋음: "사용자가 계약서를 붙여넣거나 PDF에서 용어를 요약, 수정 또는 추출하도록 요청할 때 사용합니다."
공식: "[특정 트리거] 발생 시 사용. [특정 콘텐츠 유형]에 적용."
스킬 또는 CLAUDE.md 규칙? 스킬은 반복 가능한 다단계 절차이고, CLAUDE.md 규칙은 항상 켜져 있는 제약 조건입니다. 10단계 배포 런북은 스킬입니다. "백업 없이 프로덕션에 대해 마이그레이션을 실행하지 마십시오"는 규칙입니다. 둘 다 시스템에 속합니다.
MCP(Model Context Protocol) 서버는 외부 도구를 Claude에 노출하는 어댑터입니다. Slack, Supabase, Notion, GitHub: Claude는 MCP를 호출하고, MCP는 API를 호출하며, 당신은 접착 코드를 작성할 필요가 없습니다. 데이터를 프롬프트에 복사하여 붙여넣는 대신, Claude는 실시간 데이터를 읽고 직접 작업을 수행합니다.
데이터베이스 MCP: "지난주에 가입했지만 활성화되지 않은 사용자를 보여주세요"는 실시간 쿼리로 실행됩니다.
Slack MCP: "오늘 #engineering에서 논의된 내용을 요약하세요"는 실시간 메시지를 가져옵니다.
Notion MCP: "오늘의 결정으로 프로젝트 위키를 업데이트하세요"는 직접 작성합니다.
GitHub MCP: "7일보다 오래된 열린 PR을 나열하세요"는 실시간 저장소 상태를 쿼리합니다.
설치 패턴: 서버 설치(npx 또는 uvx), ~/.claude/settings.json에 구성 추가:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}보안 규칙:
실제 토큰을 공개 파일에 절대 붙여넣지 마십시오. 환경 변수 또는 비밀 저장소를 통해 주입하십시오.
데이터베이스 MCP는 Claude가 필요한 테이블로 범위가 지정된 읽기 전용 자격 증명을 얻습니다. 서비스 역할 키는 테이블을 삭제할 수 있습니다.
배포하기 전에 각 MCP가 노출하는 도구를 검토하십시오.
작업을 수행하는 MCP는 승인 게이트를 얻습니다.
첫 MCP를 선택하십시오. 현재 외부 시스템에서 Claude에 무엇을 붙여넣고 있는지 자문하십시오. 데이터베이스 쿼리 결과는 Supabase MCP를 가리키고, PR 목록은 GitHub를 가리키고, 채널 요약은 Slack을 가리키고, 메모는 Obsidian을 가리킵니다. 구성되었지만 무시되는 4개보다 설치되어 활발히 사용되는 1개의 MCP가 낫습니다.
테스트: Claude Code를 닫고 다시 열어 검색을 트리거한 다음, "[MCP 이름]에서 사용할 수 있는 도구는 무엇입니까?"라고 묻습니다. 목록이 비어 있으면 settings.json 구문을 확인하고 npx 또는 uvx가 PATH에 있는지 확인하십시오.
스킬과 MCP는 복합적입니다. 배포 런북 스킬 + GitHub MCP + Slack MCP: Claude는 런북을 따르고, 실시간 PR 상태를 읽고, 진행 상황 업데이트를 게시합니다. 20분 수동 배포가 2분으로 단축됩니다. 설정 비용은 스킬당 약 30분, MCP당 10분입니다. 처음 5회 사용으로 비용을 회수할 수 있습니다.
도구에 대한 게시된 MCP가 없습니까? 공식 Python SDK를 사용하는 최소한의 사용자 지정 서버는 약 30-40줄로 하나의 도구를 노출합니다. 도구의 이름, 설명 및 입력 스키마를 정의한 다음 호출을 처리합니다. 도구 설명에 스킬 설명과 동일한 구체성을 부여하십시오. 실시간으로 자주 쿼리되는 데이터에 대한 사용자 지정 MCP를 구축하십시오. 정적 참조 데이터의 경우 붙여넣기를 요청하는 스킬로 충분합니다.
팀 설정을 위한 자격 증명 관리. 공유 settings.json에 하드코딩된 토큰은 사고를 기다리는 것입니다. 두 가지 더 안전한 패턴: 환경 변수 전달("SLACK_TOKEN": "$SLACK_TOKEN", 실제 값은 셸 프로필에 있음) 또는 MCP 서버가 시작 시 쿼리하는 비밀 관리자(Vault, 1Password CLI)를 사용하여 민감한 정보가 디스크에 남아 있지 않도록 합니다.
최소한으로 범위 지정: Supabase를 위한 읽기 전용 Postgres 역할, 특정 저장소로 제한된 세분화된 GitHub 토큰, Claude가 볼 수 있는 채널로 제한된 Slack 봇 토큰.
감사: 쓰기 작업을 수행할 수 있는 MCP의 경우 타임스탬프, 도구 이름, 인수 및 결과 상태를 로깅하는 PostToolUse 훅을 추가하십시오.
스킬은 Claude가 설명으로 발견하는 마크다운 런북입니다. 동일한 지침을 세 번째 붙여넣을 때 스킬을 작성하십시오. MCP는 접착 코드 없이 Claude를 외부 API에 연결합니다. 읽기 전용, 최소 권한 자격 증명을 사용하십시오. 가장 좋은 첫 번째 스킬: 이번 주에 두 번 설명한 절차. 가장 좋은 첫 번째 MCP: 가장 많이 복사하여 붙여넣는 시스템.