위키북스

MCP 서버, 정할 건 세 가지뿐입니다 - 이름은 여섯 개가 넘어도, 나머지는 REST API를 만드는 감각과 같

위키북스 — Tue, 06 Oct 2026 22:00:05 GMT

스프링으로 MCP 서버를 만들어 보려고 스타터를 찾다가, 세 개가 나란히 뜨는 화면 앞에서 잠시 멈추신 적 있으신가요? STDIO, SSE, Streamable HTTP, Stateless에 웹MVC, 웹플럭스, 그리고 SYNC와 ASYNC까지. 이름은 여섯 개가 넘지만, 실제로 정해야 하는 것은 세 가지뿐입니다. 그래서 이번 글에서는 《스프링 AI 2.

API 키 없이, 스프링 AI를 처음 켜보다 - 올라마와 로컬 모델로 완성하는 스프링 AI 2.0 첫 프로젝트

위키북스 — Tue, 29 Sep 2026 22:00:11 GMT

스프링 AI를 처음 시작하려고 튜토리얼을 검색하면, 첫 단계에서 이런 문장을 자주 만나게 됩니다. "먼저 오픈AI API 키를 발급받으세요." 그런데 아직 만들어 본 것도 없는데 카드부터 등록해야 한다면, 시작 전부터 마음이 무거워지기 마련입니다. 그래서 이번 글에서는 《스프링 AI 2.0으로 배우는 AI 에이전트 개발 완벽 가이드》 2장의 실습 순서를

스프링 AI 2.0, 1.x와 뭐가 달라졌나 - 기능 추가가 아니라 세대 교체, 바뀐 8가지

위키북스 — Wed, 23 Sep 2026 22:00:18 GMT

스프링 AI 2.0이 나왔다는 소식을 들으셨나요? 그렇다면 자연스럽게 이런 질문이 따라옵니다. 1.x로 만들어 둔 서비스를 그대로 두어도 될까요? 결론부터 말씀드리면, 이번 버전은 기능 몇 개를 더한 마이너 업데이트가 아닙니다. 기반을 스프링 부트 4 위로 옮긴 세대 교체입니다. 이 글에서는 여덟 개 영역에서 무엇이 달라졌는지 표 하나로 정리하고, 옮길

MS와 삼성전자, 같은 잣대로 채점하면 누가 이길까? - 잣대를 살짝 바꾸자 순위가 뒤집혔습니다

위키북스 — Tue, 22 Sep 2026 22:00:13 GMT

"그래서 MS(마이크로소프트)예요, 삼성전자예요?" 서학개미와 동학개미 사이의 해묵은 논쟁입니다. 문제는 비교의 잣대가 늘 제각각이라는 점입니다. 누구는 수익률을, 누구는 기술력을, 누구는 애국심을 말합니다. 그래서 AI에게 같은 데이터, 같은 방법으로 두 종목을 채점시켜 봤습니다. 그런데 점수보다 흥미로운 것은, 잣대를 살짝 바꾸자 벌어진 일이었습니다.

"프롬프트를 잘 써라"는 말, 대체 무슨 뜻일까요? - 1차가 틀린 게 아니라, 1차에서 멈추는 게 문제입니다

위키북스 — Sun, 20 Sep 2026 22:00:21 GMT

"프롬프트를 잘 써라." 다들 이렇게 말하는데, 무엇이 잘 쓴 것인지는 아무도 알려 주지 않습니다. 그래서 대부분 이런 식으로 시작합니다. "고객 검색 기능 만들어 줘." 돌아온 결과는 대충 맞습니다. 그런데 쓸 수는 없습니다. 여기서 갈립니다. 코드를 손으로 고치기 시작하는 사람과, 요청을 다시 쓰는 사람으로. 이 글은 후자의 방법입니다. 실제 사례 네

3년 된 프로젝트 인수받고 첫 주에 만든 문서 7개 - 코드는 한 줄도 안 고쳤습니다

위키북스 — Wed, 16 Sep 2026 22:00:20 GMT

리포지터리 주소 하나를 받아 보신 적 있으신가요? 3년 동안 여러 사람 손을 거친 프로젝트인데 README는 두 줄이고, 전임자는 이미 퇴사했습니다. 코드를 며칠 붙잡고 읽어야 할 것 같은데, 그러는 동안에도 이슈는 계속 들어옵니다. 인수인계의 현실은 대개 이렇게 시작됩니다. 문서는 부족하고 코드의 의도도 알 수 없습니다. 그런데 이럴 때 가장 먼저 해야

삼성전자 적정 주가는 얼마일까요? - 명령 한 줄로 구해 봤습니다

위키북스 — Tue, 15 Sep 2026 22:00:08 GMT

"이 주식, 지금 가격이 적당한가?" 투자에서 가장 중요한 질문이지만, 답하기가 가장 어렵습니다. 그래서 증권사 리포트의 목표 주가를 참고하게 되는데, 목표가는 리포트마다 제각각인 데다 낙관적으로 기우는 경우도 있어 그대로 믿기는 어렵습니다. 그래서 오늘은 그 계산을 직접 해 보겠습니다. 클로드에 재무 분석 플러그인을 설치하고, 명령 한 줄로 삼성전자의

팀 위키의 ERD, 마지막으로 열어본 게 언제인가요? - ERD 말고 개념도, 그리고 격벽으로 팀의 의존성을 관리하는 법

위키북스 — Mon, 14 Sep 2026 22:00:36 GMT

팀 위키에 있는 ERD, 마지막으로 열어본 게 언제인가요? 테이블이 60개를 넘어가는 순간 그 그림은 아무것도 설명하지 못합니다. 신규 입사자에게 띄워 놓고 30분을 설명해도 "그래서 이 서비스가 뭘 하는 건데요?"가 남습니다. 기획자에게는 아예 보여줄 수도 없고요. ERD도 클래스 다이어그램도 아닌 세 번째 그림이 있습니다. 개념도입니다. 그리고 무엇을

프롬프트는 한 글자도 안 바꿨습니다. - 바꾼 건 AGENTS.md 파일 하나였습니다

위키북스 — Wed, 09 Sep 2026 22:00:10 GMT

코덱스를 쓰기 시작하면 대개 비슷한 벽에 부딪힙니다. 결과가 들쭉날쭉하다는 것입니다. 어제는 잘 되던 요청이 오늘은 프로젝트에 없는 프레임워크로 코드를 만들어 오기도 합니다. 그래서 프롬프트가 점점 길어집니다. "FastAPI로, 기존 라우터 스타일 따라서, 페이지네이션 넣고, 테스트도 같이, 주석은 한국어로..." 매번 이걸 붙여 쓰다 보면 이게 맞나 싶

골든크로스가 뜨면 정말 사야 할까요? - 이동평균선·RSI·MACD, 계산과 해석을 AI에게 맡겨 봤습니다

위키북스 — Tue, 08 Sep 2026 22:00:11 GMT

"골든크로스 발생!" 주식 뉴스에서 흔히 보는 문구지만, 정작 그래서 사라는 건지 말라는 건지는 아무도 말해 주지 않습니다. 이동평균선, RSI, MACD. 이름만 들어도 머리가 아픈 세 지표를 매번 직접 계산하고 해석하는 일은 더 부담스럽습니다. 오늘은 그 계산과 1차 해석을 통째로 AI에게 맡겨 보겠습니다. 재료는 엔비디아(NVDA)의 2025년 1년

"카테고리를 클릭하면 상품이 보여요" - 이 한 줄에 개발자가 던져야 할 질문 12개

위키북스 — Mon, 07 Sep 2026 22:00:10 GMT

기획서에 이 한 줄만 적혀 있다면, 어떻게 하시겠습니까? 카테고리를 클릭하면 해당 상품이 보여요. 과장처럼 들리시겠지만, 실무에서는 이런 기획서를 실제로 받습니다. 여러 회사에서 이 정도 수준의 기획서가 드물지 않게 나옵니다. 여기서 곧바로 IDE를 열면 어떻게 될까요? 대개 2주 뒤에 "이게 아닌데요"라는 말을 듣고, 만든 것을 전부 다시 만들게 됩니다

주가를 복사·붙여넣기 하고 계신가요? - 함수 한 줄이면 1년 시세가 자동으로 쌓입니다

위키북스 — Thu, 03 Sep 2026 22:00:21 GMT

어젯밤에도 포털에서 종가를 복사해 엑셀에 붙여 넣으셨나요? 날짜를 맞추고, 열을 정리하고, 수익률 수식을 만들다 보면 30분이 훌쩍 지나갑니다. 정작 중요한 '살까, 팔까' 하는 판단은 시작도 못 했는데 말이죠. 오늘은 그 30분을 3초로 줄이는 방법을 안내해 드리겠습니다. 엑셀 365의 STOCKHISTORY 함수 하나면, 애플이든 삼성전자든 1년 치

"카테고리를 클릭하면 상품이 보여요" - 바로 IDE를 열면 2주 뒤 전부 다시 만듭니다

위키북스 — Wed, 02 Sep 2026 23:36:26 GMT

클로드 코드와 코덱스, 무엇을 고르시겠습니까? - 그 선택이 생각보다 중요하지 않은 이유

위키북스 — Wed, 02 Sep 2026 22:00:27 GMT

AI 코딩 도구를 하나 정해서 제대로 써 보기로 마음먹으면, 이내 후보 셋 앞에서 멈추게 됩니다. 깃허브 코파일럿, 클로드 코드, 그리고 OpenAI 코덱스입니다. 벤치마크 점수를 찾아보면 답이 나올 것 같지만, 순위는 매달 바뀝니다. 지난달 1위가 이번 달에는 3위가 되어 있곤 하죠. 그래서 이 글은 점수로 답하지 않겠습니다. 대신 네 가지 기준으로 잘

찜 버튼을 '따닥' 눌렀더니 찜이 풀렸다 - 토글 API가 숨긴 경합, 락 없이 푸는 법《제미니의 백엔드 개발 실무》

위키북스 — Mon, 31 Aug 2026 22:00:35 GMT

이번 글에서는 가장 단순한 상태 전이 유형인 찜에 관해 다뤘습니다. 찜은 켜지거나 꺼지거나 둘 중 하나고, 틀려도 사용자가 다시 누르면 됩니다. 쇼핑 앱에서 하트를 빠르게 두 번 눌러보신 적 있으신가요? 두 번 눌렀으니 당연히 찜이 되어 있을 것 같은데, 화면을 새로고침해 보면 오히려 찜이 풀려 있는 경우가 있습니다. 많은 분들이 이걸 버그라고 생각하십니

위키북스 — Fri, 07 Aug 2026 02:54:41 GMT

공개 법률 데이터(legalize-kr)로 copyright-qa 스킬을 만들고, 챗GPT 코덱스와 교차 검토까지 해 본 이야기 1. 클로드의 "스킬"이 뭐길래? 클로드에게 매번 긴 설명을 반복하지 않고, 특정 작업의 업무 매뉴얼을 미리 만들어 두는 기능이 있습니다. 바로 스킬(Skill)입니다. 스킬의 실체는 생각보다 단순합니다. 폴더 하나에 지침서

의존성 방향만 뒤집었을 뿐인데 - 헥사고날 아키텍처가 계층형의 5가지 함정을 해결하는 법 (포트와 어댑터)

위키북스 — Thu, 23 Jul 2026 22:00:27 GMT

이전 편에서 계층형 아키텍처의 5가지 함정 — 데이터베이스 주도 설계, 지름길 허용, 테스트 어려움, 유스케이스 은닉, 병렬 작업 불가 — 을 살펴봤습니다. (→ "깔끔했던 코드는 왜 항상 엉망이 될까") 이번에는 이 문제들을 구조적으로 해결하는 방법을 알아봅니다. 핵심은 하나입니다. 의존성의 방향을 뒤집는 것. 이해할 원칙은 딱 둘입니다. SOLID의

깔끔했던 코드는 왜 항상 엉망이 될까 - 스프링 개발자라면 겪는 계층형 아키텍처의 5가지 함정

위키북스 — Wed, 22 Jul 2026 22:00:18 GMT

"이 코드, 왜 이렇게 되어 있지?" 스프링으로 프로젝트를 맡아본 개발자라면 한 번쯤 이런 생각을 했을 것입니다. 처음에는 깔끔했던 코드가 어느 순간 얽히고설켜 새 기능 하나 추가하기가 무섭고, 테스트 코드는 점점 늘리기 어려워지고, 버그 하나 고치면 다른 곳에서 터집니다. 대부분의 스프링 프로젝트는 계층형(레이어드) 아키텍처로 출발합니다. 웹 계층,

하이드레이션은 줄이는 게 아니라 제거하는 것이다 - FCP는 빠른데 TTI가 느린 이유, 하이드레이션 문제해결 가이드

위키북스 — Sun, 19 Jul 2026 22:00:23 GMT

Next.js로 서버 사이드 렌더링을 적용했는데 TTI가 생각보다 좋지 않나요? 화면에 콘텐츠는 보이는데 버튼이 한동안 클릭이 안 되는 경험을 하셨나요? 그렇다면 범인은 SSR이 아니라 '하이드레이션'입니다. SSR은 FCP를 빠르게 만들어주지만, TTI는 하이드레이션이 완료되어야만 개선됩니다. 하이드레이션 동안 사용자는 화면은 보이지만 인터랙션이 안 되는

브라우저 캐시를 믿지 말고 설계하라 - no-cache는 '캐시하지 마라'가 아니다

위키북스 — Thu, 16 Jul 2026 22:00:24 GMT

"배포했는데 왜 아직 이전 버전이 보여요?" 이 질문, 한 번쯤 받거나 해본 적 있으신가요? 대부분의 경우 원인은 코드가 아니라 브라우저 캐시 설정에 있습니다. 그리고 더 정확히 말하면, 캐시를 '믿었기' 때문에 생긴 문제입니다. 브라우저 캐시는 자동으로 알아서 잘 관리해줄 것 같지만, 사실 Cache-Control 헤더를 명시적으로 설정하지 않으면 브라우