일반 MCP 설정 가이드

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/data"]
    }
  }
}

{
  "mcpServers": {
    "서버별칭": {                           // Claude에서 표시될 이름
      "command": "npx",                    // 실행할 명령어 (npx, python, uv 등)
      "args": ["-y", "패키지명", "추가인자"], // 명령어 인자
      "env": {                             // 환경변수 (API 키 등)
        "API_KEY": "값"
      }
    }
  }
}

# stdio 기반 로컬 서버 추가
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 환경변수와 함께 추가
claude mcp add slack -e SLACK_BOT_TOKEN=xoxb-xxx -- npx -y @modelcontextprotocol/server-slack

# 등록된 서버 목록 확인
claude mcp list

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost:5432/mydb"]
    }
  }
}

# 프로젝트 스코프 (기본값)
claude mcp add my-db -- npx -y @modelcontextprotocol/server-postgres "postgresql://..."

# 글로벌 스코프
claude mcp add --scope user slack -e SLACK_BOT_TOKEN=xoxb-xxx -- npx -y @modelcontextprotocol/server-slack

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    }
  }
}

{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    }
  }
}

Genie Code 패널 > 설정 아이콘 > MCP Servers > Add Server
→ Managed MCP: Unity Catalog Functions, Vector Search, Genie Space 등 선택
→ External MCP: Unity Catalog Connection 선택
→ Custom MCP: Databricks App URL 입력

# Node.js 설치 확인 및 MCP 서버 테스트
node --version           # v18.0.0 이상 필요
npx --version            # npx 사용 가능 확인

# 간단한 MCP 서버 테스트 (Filesystem)
npx -y @modelcontextprotocol/server-filesystem /tmp
# 정상이면 JSON-RPC 메시지가 stdout에 출력됨

# uv 사용 (권장)
uv init my-mcp-server && cd my-mcp-server
uv venv && source .venv/bin/activate
uv add "mcp[cli]"

# 또는 pip 사용
pip install "mcp[cli]"

# server.py
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-tools")

@mcp.tool()
async def search_products(query: str) -> str:
    """제품 카탈로그에서 검색합니다.

    Args:
        query: 검색할 제품명 또는 키워드
    """
    # 실제 비즈니스 로직 (DB 조회, API 호출 등)
    results = [
        {"name": "노트북 Pro", "price": 1200000},
        {"name": "노트북 Air", "price": 900000},
    ]
    return str([r for r in results if query.lower() in r["name"].lower()])

@mcp.tool()
async def get_order_status(order_id: str) -> str:
    """주문 상태를 조회합니다.

    Args:
        order_id: 주문 번호
    """
    return f"주문 {order_id}: 배송 중 (예상 도착일: 2026-04-02)"

if __name__ == "__main__":
    mcp.run(transport="stdio")

# MCP Inspector로 대화형 테스트
mcp dev server.py

# Claude Desktop에 등록
# claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "my-tools": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/my-mcp-server", "server.py"]
    }
  }
}

프로젝트 리포지토리에 포함 (git 커밋):
├── .mcp.json                  ← MCP 서버 구성 (토큰 없이)
├── .env.example               ← 환경변수 템플릿 (실제 값 없이)
└── README.md                  ← MCP 설정 가이드 링크

각 팀원의 로컬 환경:
└── .env                       ← 실제 토큰 값 (.gitignore에 추가)