Next-BlockChain

MCP 클라이언트 완벽 이해 — 서버와 LLM 사이를 잇는 다리, 그 작동 흐름지난 강의에서 우리는 MCP가 무엇이고 왜 필요한지를 정리했습니다. 큰 그림은 잡혔지만 실제로 코드 단에서 누가 누구와 어떻게 통신하는지는 아직 흐릿하죠.오늘은 그 안개를 걷어내는 시간입니다. MCP 클라이언트(MCP Client) — 여러분의 서버와 외부 MCP 서버를 잇는 다리 — 가 정확히 어떻게 동작하는지 살펴봅니다. 이 흐름을 머릿속에 한 번 그려두면, 다음 강의에서 직접 구현할 때 훨씬 수월해져요. 🌉🔌 MCP 클라이언트란?한 줄 정의:MCP 서버가 제공하는 도구·프롬프트·리소스에 접근하기 위한 "출입구(gateway)".무엇을 대신 처리해주나?여러분이 직접 신경 쓰면 골치 아픈 것들을 클라이언트가 다 알아서 처..

AI 2026. 5. 31. 23:12

MCP (Model Context Protocol) 입문 — Claude를 어떤 외부 서비스에든 즉시 연결하는 표준 프로토콜Claude로 챗봇을 만들다 보면 어느 순간 마주치는 한계가 있습니다."GitHub 데이터를 다루게 하려면 GitHub API용 도구를 다 만들어야 하고, Slack을 쓰려면 또 만들어야 하고, AWS를 쓰려면 또…"도구(tool)를 새 서비스마다 처음부터 정의·구현·유지보수하는 일은 개발자에게 가장 지루하고 반복적인 작업 중 하나죠. 게다가 같은 일을 전 세계의 수많은 개발자가 각자 따로 하고 있습니다. 🤦이 문제를 정면으로 해결하는 게 바로 오늘부터 다룰 MCP (Model Context Protocol) 입니다. 새로운 챕터의 시작이에요. 🚀🤔 MCP란 무엇인가?한 줄 정..

AI 2026. 5. 31. 22:57

Claude Web Search Tool: 구현 0줄로 인터넷 검색 능력 부여하기 (도메인 제한·인용까지)지금까지 우리가 만든 도구들은 모두 우리 서버에서 직접 실행 했어요. get_current_datetime 도, set_reminder 도, 우리가 Python 함수를 짜고 우리가 호출했죠.오늘 다룰 Web Search Tool 은 다릅니다. Anthropic 이 자기 서버에서 검색까지 직접 처리해주는 빌트인 도구 예요. 우리는 함수도 안 짜요. 스키마 4줄만 던져주면 Claude 가 알아서 검색 쿼리 만들고, 인터넷에서 결과 가져오고, 인용까지 붙여서 답변해줍니다.오늘은 활성화 절차, schema 구성, 응답에 들어 있는 5가지 블록 타입, allowed_domains 로 도메인 제한, 그리고 인용..

AI 2026. 5. 19. 00:21

Claude의 내장 텍스트 편집기 도구(Text Editor Tool) 완벽 가이드 — 파일 시스템을 다루는 AI 만들기지금까지 우리는 사용자가 직접 만든 도구(custom tools)를 Claude에게 연결해왔습니다. JSON 스키마와 실제 함수 구현을 모두 직접 작성했죠. 그런데, Claude에게는 처음부터 내장된 도구가 몇 가지 있다는 사실, 알고 계셨나요?그중 하나가 바로 텍스트 편집기 도구(Text Editor Tool) 입니다. 이 도구를 쓰면 Claude가 마치 사람이 VS Code를 쓰듯 파일과 디렉토리를 자유롭게 다룰 수 있게 됩니다. 한마디로 Claude를 소프트웨어 엔지니어 역할로 즉시 투입할 수 있는 강력한 무기예요. 🛠️오늘은 이 텍스트 편집기 도구가 정확히 무엇이고, 어떻게 동..

AI 2026. 5. 18. 23:39

Fine-Grained Tool Calling: 도구 인자 스트리밍의 검증을 끄고 진짜 실시간성을 얻는 법지난 글까지 우리는 도구 호출의 결과 를 받는 데 집중했어요. 그런데 도구를 호출할 때 인자(arguments) 자체가 점진적으로 만들어지는 과정 도 스트리밍할 수 있다는 사실, 알고 계셨나요?기본 설정에서는 Anthropic API가 JSON 검증 을 위해 인자 청크를 잠깐 버퍼링한 뒤 한꺼번에 보냅니다. UX 적으로는 "스트리밍이 켜졌는데 왜 텀이 있지?" 처럼 보이기도 해요. 이걸 끄고 진짜 토큰 단위로 즉시 받는 옵션이 바로 Fine-Grained Tool Calling 입니다.오늘은 InputJsonEvent 의 두 필드(partial_json / snapshot), API의 기본 버퍼링 메..

AI 2026. 5. 17. 21:20

Using Multiple Tools: Claude에게 여러 도구를 한 번에 쥐어주기 (4단계 모듈식 확장 패턴)지난 글에서 다중턴 루프 패턴 을 완성했어요. 그런데 거기까지는 도구가 하나 뿐이었죠 (get_current_datetime). 실제 서비스는 보통 수십 개의 도구 를 동시에 운영합니다. Claude Code 만 봐도 read_file, write_file, bash, grep, glob 등 도구가 즐비해요.오늘은 여러 도구를 함께 등록하고, Claude 가 알아서 골라 쓰게 하는 패턴 을 정리합니다. 핵심 메시지는 단순해요. "한 번 인프라를 만들어두면, 새 도구 추가는 4줄짜리 작업이 된다."실전 시나리오로는 강의가 제시한 "의사 진료 예약 알림" 을 활용해서 Claude 가 여러 도구를 ..

AI 2026. 5. 17. 21:18

Implementing Multiple Turns: Claude Tool Use 의 진짜 핵심 — 무한 루프 패턴 완성지난 글까지 우리는 딱 1턴짜리 Tool Use 사이클을 구현했어요. 사용자 → Claude → 도구 호출 → 결과 → 최종 응답. 그런데 실전에서는 이게 한 번으로 끝나지 않습니다.예를 들어 "내일 오후 3시에 회의 잡고 알림도 같이 설정해줘" 라는 요청을 보세요. Claude 가:add_duration_to_datetime 으로 "내일 오후 3시" 계산결과를 받고 → set_reminder 로 알림 설정또 결과를 받고 → 최종 답변 생성3단계의 도구 호출이 연쇄적으로 일어나야 해요. 이게 바로 Multi-turn Tool Use 입니다.오늘은 Claude 가 만족할 때까지 계속 도구 ..

AI 2026. 5. 17. 19:49

Sending Tool Results: Claude에게 결과 돌려주는 마지막 한 걸음 (tool_result 블록 완전 정복)지난 글에서 멀티블록 응답 의 구조를 봤어요. Claude 가 tool_use 블록으로 "이 함수를 이 인자로 호출해줘" 라고 부탁한 상태였죠. 오늘은 그 부탁을 실제로 수행하고, 결과를 다시 Claude 에게 돌려주는 마지막 한 걸음을 구현합니다.이 단계가 끝나면 Tool Use 의 완전한 1턴 사이클 이 완성돼요. 사용자 → Claude → 도구 호출 → 결과 → 최종 답변 까지 한 줄로 연결됩니다.오늘은 `언팩킹 트릭,tool_result블록의 3가지 필드, 병렬 호출 시 id 매칭 규칙, 그리고 follow-up 호출에서도tools` 를 빠뜨리면 안 되는 이유** 까지 정리..

AI 2026. 5. 17. 10:54