SDK 바깥의 지도: MCP·서버 도구·Cookbook

첫날부터 알아 둘 세 이웃

Claude SDK 주변에는 외부 능력을 연결하는 Model Context Protocol(MCP), web_search·code_execution·computer_use 같은 서버 제공 도구, RAG부터 평가까지 실행 예제를 모은 Anthropic Cookbook이 있어. SDK 호출법만 익히고 이 셋을 놓치면 이미 마련된 통합 규칙과 예제를 다시 만들게 돼.

MCP는 능력을 연결하는 공용 소켓이야

MCP를 쓰면 Claude 클라이언트가 파일시스템·GitHub·데이터베이스 같은 능력 서버와 같은 규약으로 대화해. Agent SDK와 Claude Code CLI가 모두 기본 지원하므로 브레인 코드에 통합마다 전용 접착제를 넣을 필요가 줄어들지. cwkPippa도 vault, 네트워크 운영, 이미지 생성 능력을 MCP로 내보내 같은 Claude가 한 방식으로 사용하게 해.

Cookbook은 실행 가능한 참고 서가야

Anthropic Cookbook에는 도구 사용, RAG, 평가, 비전, 프롬프트 캐싱을 실제로 돌려 볼 수 있는 노트북이 모여 있어. 공식 문서가 개념적으로만 느껴질 때 구현의 출발점으로 삼기 좋아. 다만 프로젝트에 가져올 때는 상류 변경에 흔들리지 않도록 특정 커밋을 기록해 둬.

원칙: MCP는 오래 쓸 통합 경계로, Cookbook은 검증된 예제 서가로 써. 둘 다 모델의 학습 기억보다 빨리 바뀌어.

Code

로컬에 MCP 서버 뭐가 있는지 발견·bash

# Claude Code CLI 안 (인터랙티브):
#   /mcp list
#
# 셸에서 프로젝트 로컬 config 들여다보기:
cat .mcp.json 2>/dev/null || echo 'no project-level MCP config yet'

# 또는 user-level config:
cat ~/.claude/mcp.json 2>/dev/null || echo 'no user-level MCP config yet'

stdio MCP 서버를 손으로 띄우기 (가장 단순한 케이스)·json

{
  "mcpServers": {
    "pippa-vault": {
      "command": "node",
      "args": ["/Users/you_username/Obsidian/pippa/mcp/vault-server.js"]
    }
  }
}

첫날부터 알아 둘 세 이웃

MCP는 능력을 연결하는 공용 소켓이야

Cookbook은 실행 가능한 참고 서가야

Code

External links

Exercise

Progress

댓글 0