ClOr
백엔드 실무 트러블슈팅과 AI 에이전트 구조 분석을 기록합니다.
최신 글
Claude Code의 도구, 에이전트 루프, 컨텍스트 관리를 그대로 가져다 쓸 수 있는 SDK가 있다. pip install claude-agent-sdk 한 줄이면 된다.Claude Agent SDK(구 Claude Code SDK)는 Claude Code를 CLI가 아닌 라이브러리로 쓸 수 있게 해주는 공식 SDK다. 파일 읽기, 명령어 실행, 코드 편집, 웹 검색까지 — Claude Code가 할 수 있는 모든 것을 Python이나 TypeScript 코드에서 프로그래밍 가능하다.핵심은 query() 함수 하나다. 프롬프트를 넣으면 Claude가 알아서 도구를 호출하고, 파일을 읽고, 코드를 수정한다. 도구 실행 루프를 직접 구현할 필요가 없다.목차설치와 첫 실행최소 동작 코드Client SDK와..
목차먼저 핵심만MCP 이전: 에이전트의 한계MCP의 구조: 서버-클라이언트-도구Host (호스트)Client (클라이언트)Server (서버)통신 흐름연결 레이어가 생기면 바뀌는 것들도구 목록이 동적으로 바뀝니다도구 통합의 책임이 분리됩니다에이전트의 능력 범위가 설정으로 결정됩니다에이전트 간 도구 생태계가 공유됩니다설계가 달라지는 지점도구 등록이 "발견"으로 바뀝니다권한의 경계가 달라집니다에러 처리의 범위가 넓어집니다도구 설명이 곧 인터페이스입니다MCP의 현실적 한계레이턴시가 추가됩니다보안 표면이 넓어집니다버전 관리가 복잡해집니다상태 관리의 어려움실무에 가져갈 수 있는 원칙요약먼저 핵심만코딩 에이전트에 MCP(Model Context Protocol)를 붙이면, 에이전트가 쓸 수 있는 도구가 "빌드 타임..
시리즈 이전 편: [Part 10] 권한 시스템 분석 — rm -rf를 못 치게 막는 법결론부터 말하면, 클로드 코드(Claude Code)의 MCP 구현은 6가지 전송 방식을 지원하는 플러그 앤 플레이 도구 연결 시스템입니다. 소스코드를 분석해보니 client.ts 하나가 117KB — 이 파일 하나에 서버 연결, 도구 등록, OAuth 인증, 세션 관리가 전부 들어있었습니다. MCP(Model Context Protocol)는 AI가 외부 도구를 쓸 수 있게 해주는 표준 프로토콜인데, Claude Code가 이걸 어떻게 구현했는지 직접 까봤습니다.목차MCP가 뭔가요? USB 비유로 설명하면Claude Code는 MCP 서버를 어떻게 찾나?6가지 전송 방식 — 왜 이렇게 많을까?도구 이름은 어떻게 충돌..