MCP로 도구 연결하기 — Supabase·GitHub·n8n 붙이기

MCP(Model Context Protocol)는 클로드 코드에 외부 서비스를 직접 연결하는 표준 규격으로, settings.json을 손대지 않고 '이 MCP 설치·연결해 줘'라는 프롬프트나 claude mcp add 명령만으로 데이터베이스 조회·GitHub 이슈 생성·자동화 실행을 대화 한 줄로 처리할 수 있습니다.

클로드 코드는 기본적으로 내 컴퓨터의 파일만 다룹니다. 그런데 실제 개발에는 Supabase(데이터베이스), GitHub(코드 저장소), n8n(자동화)처럼 외부 서비스가 항상 얽혀 있습니다. 매번 결과를 복사해서 붙여넣는 방식은 불편합니다. 이 문제를 해결하는 것이 MCP(Model Context Protocol)입니다.

MCP를 '범용 플러그인 규격'이라고 생각하면 쉽습니다. 클로드 코드에 Supabase MCP를 붙이면 클로드가 직접 내 데이터베이스에 접속하고, GitHub MCP를 붙이면 이슈를 읽고 PR을 만들 수 있습니다. '이야기로만 듣는 것'에서 '직접 가서 보는 것'으로 달라지는 셈입니다.

가장 쉬운 방법 — 설치조차 프롬프트로

설정 파일(JSON)을 직접 손댈 필요가 없습니다. 클로드 코드에게 '이 MCP 서버 설치하고 연결해 줘'라고 말로 시키는 것이 가장 쉽습니다. 클로드가 설정 파일을 대신 만들고, 필요한 토큰은 되물어보며, 연결 확인까지 안내해 줍니다. 어떤 서버가 있는지 모를 때도 먼저 추천을 받고 그 자리에서 설치로 이어갈 수 있습니다.

MCP를 프롬프트로 설치·연결하기

Supabase MCP 서버(@supabase/mcp-server-supabase)를 이 프로젝트의 .claude/settings.json에 등록해 줘.
- 액세스 토큰은 코드에 직접 쓰지 말고 환경 변수(SUPABASE_ACCESS_TOKEN)로 참조하게 해 줘.
- 토큰 값이 필요하면 나에게 물어봐 줘.
- 등록이 끝나면 /mcp로 연결 상태를 확인하는 방법도 알려 줘.

뭘 붙일지 모를 때 — 추천부터 받기

지금 이 프로젝트에서 데이터베이스 조회와 GitHub 이슈 관리를 자동화하고 싶어. 어떤 MCP 서버를 붙이면 좋을지 후보를 정리해 주고, 내가 고르면 설치·연결까지 이어서 해 줘. 각 서버가 요구하는 토큰·권한도 미리 알려 줘.

CLI에 익숙하다면 claude mcp add 명령으로 한 줄에 등록할 수도 있습니다. 프롬프트로 시키든, 명령으로 하든 결과(설정 파일 등록)는 같습니다.

CLI로 한 줄에 등록하기 (claude mcp add)

# 형식: claude mcp add <이름> -- <실행 명령>
claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest

# 환경 변수와 함께 등록 (-e KEY=값)
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_TOKEN -- npx -y @modelcontextprotocol/server-github

# 등록된 MCP 목록·상태 확인
claude mcp list

프롬프트로 설치를 시키면 클로드가 settings.json에 어떤 변경을 할지 먼저 보여주고 승인을 받습니다(권한 모드에 따라). 무엇이 등록되는지 눈으로 확인한 뒤 허용하는 습관을 들이세요.

직접 등록하기 — settings.json 구조 이해

MCP 서버는 프로젝트의 .claude/settings.json 또는 전체 적용을 원하면 ~/.claude/settings.json에 등록합니다. mcpServers 항목에 서버 이름과 실행 방법을 적으면 됩니다.

.claude/settings.json — MCP 서버 등록 예시

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest",
               "--access-token", "YOUR_SUPABASE_ACCESS_TOKEN"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN" }
    },
    "n8n": {
      "command": "npx",
      "args": ["-y", "n8n-mcp"],
      "env": { "N8N_API_KEY": "YOUR_N8N_KEY", "N8N_BASE_URL": "http://localhost:5678" }
    }
  }
}

자주 쓰는 MCP 서버

MCP 서버 패키지	연결 서비스	주요 기능
@supabase/mcp-server-supabase	Supabase (PostgreSQL)	테이블 조회, SQL 실행, 마이그레이션 적용
@modelcontextprotocol/server-github	GitHub	이슈·PR 읽기·생성, 브랜치·파일 관리
n8n-mcp	n8n 자동화	워크플로우 조회·생성·실행
@modelcontextprotocol/server-filesystem	로컬 파일시스템 확장	지정 경로에 더 넓은 파일 접근 허용

MCP 연결 후 실전 사용 예시

Supabase의 users 테이블에서 지난 7일간 가입한 사용자 수를 조회해 줘. 그리고 GitHub에서 이번 주에 올라온 이슈 중 bug 라벨이 붙은 것 목록도 함께 보여 줘.

위 프롬프트 한 줄이면 클로드가 Supabase에 SQL을 날리고 GitHub API를 호출하는 것을 알아서 처리합니다. 두 서비스에 각각 로그인해서 확인하는 것보다 훨씬 빠르고, 결과를 이어서 분석·정리하는 것도 바로 가능합니다.

MCP가 제대로 연결됐는지 확인하려면 대화창에서 /mcp를 입력하세요. 현재 연결된 서버 목록과 각 서버의 상태가 표시됩니다. 연결 오류가 있으면 claude --mcp-debug 옵션으로 실행해서 원인 로그를 확인할 수 있습니다.

settings.json에 API 토큰을 직접 적을 때는 이 파일이 Git에 올라가지 않도록 .gitignore에 반드시 추가하세요. 팀 프로젝트라면 토큰 값 대신 환경 변수(예: $SUPABASE_TOKEN)를 참조하거나, 개인 홈 폴더(~/.claude/settings.json)에 따로 보관하는 것이 안전합니다.