MCP 통합 — Server, Transport, Scope

~18 min · mcp, model-context-protocol, integrations

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

Claude 를 나머지 stack 에 꽂아

MCP (Model Context Protocol) 은 에이전트한테 built-in 도구 너머의 capability 주는 open standard. MCP server 가 함수 세트 노출하고, Claude 가 그 함수들을 다른 도구처럼 호출. 결과: Claude 가 Sentry 의 라이브 에러 쿼리, Slack 메시지 게시, Notion 페이지 read, Postgres 쿼리, 또는 public ecosystem 의 1,800+ 서버 어떤 거든 통신 가능.

Transport: stdio 가 로컬 프로세스 spawn (filesystem 필요한 도구에 베스트), HTTP / Streamable HTTP 가 원격 URL 통신 (SaaS 추천 경로 — 2025-06-18 spec), SSE 는 legacy 원격 transport (deprecated 인데 옛 config 에 보일 거).

Scope: local (기본, 이 project, ~/.claude.json 에 저장), project (.mcp.json 에 커밋, 팀 공유), user (모든 project). 다른 누가 connector 필요한지로 scope 골라.

Code

Add three useful servers·bash

# Sentry (read your live errors during a debugging session)
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# GitHub (PR reviews, issue creation, code search)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Local Postgres (read-only analytics)
claude mcp add --transport stdio analytics-db -- \
  npx -y @bytebase/dbhub --dsn "postgresql://readonly:pw@localhost:5432/analytics"

# After adding, authenticate OAuth ones from inside Claude Code:
/mcp

Project-scoped .mcp.json (commit this)·json

{
  "mcpServers": {
    "sentry":  { "type": "http", "url": "https://mcp.sentry.dev/mcp" },
    "github":  { "type": "http", "url": "https://api.githubcopilot.com/mcp/" },
    "linear":  { "type": "http", "url": "https://mcp.linear.app/mcp" },
    "local-db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {}
    }
  }
}

External links

Exercise

실제 project 에 MCP server 최소 2개 추가: 외부 (Sentry, GitHub, Linear) + 로컬 stdio server (DB 또는 filesystem). .mcp.json 커밋. Claude 세션에서 두 connector 한 작업에 다 쓰라고 시켜.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousHooks — Deterministic 라이프사이클 제어 Next →모델 선택 — Haiku, Sonnet, Opus

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.