AI 도구 연동과 MCP
Model Context Protocol(MCP)처럼 AI 모델과 외부 도구·데이터를 연결하는 표준과 실제 도입 사례를 정리합니다. 개념 설명에 그치지 않고, 실무 프로젝트에서 어떤 상황에 적용했는지, 도입 과정에서 어떤 점을 고려해야 하는지를 함께 다룹니다. AI 에이전트와 개발 환경을 연동하려는 실무자에게 실질적인 참고가 되는 것을 목표로 합니다.
글 21편 최근 업데이트순
MCP로 프론트엔드 워크플로우 연결하기: GitHub·Figma·Playwright·Chrome DevTools 조합
GitHub, Figma, Playwright, Chrome DevTools MCP 서버를 디자인 확인부터 브라우저 검증, PR까지 한 루프로 묶는 구성을 정리했다. 2026-07-28 스펙 변화, .mcp.json 예시, 아카이브된 참조 서버 구분법도 다룬다.
원격 MCP 서버 배포와 운영: Streamable HTTP와 인증, 모니터링
로컬 stdio 환경에서만 실행하던 MCP 서버를 팀 공용 원격 서버로 배포할 때 필요한 Streamable HTTP 전송 설정, OAuth 2.0 최소 권한 인증, 프록시 버퍼링 해제, OpenTelemetry 관측 구성을 정리했다.
MCP 프롬프트와 리소스: 도구 호출 외 기능 활용법
MCP에서 도구(tools) 외에 프롬프트와 리소스를 언제 쓰는지 실무 기준으로 정리했다. 반복 작업을 프롬프트로 템플릿화하는 방법과 읽기 전용 자료를 리소스로 안전하게 노출하는 원칙, 각 기능을 잘못 쓸 때 생기는 문제를 함께 다룬다.
REA를 Claude Code에 연결해 내 JavaScript·Electron 앱 빌드 결과물 분석하기: 설치 범위, 정적 분석, 결과 줄이는 법
리버스 엔지니어링 MCP인 REA를 Claude Code에 프로젝트 한정으로 등록하고, 내 JavaScript·Electron 앱 빌드 결과물을 정적 분석하는 절차를 정리했다. 결과를 필요한 필드만 남겨 읽는 법과 IPC 보안 점검에 쓰는 프롬프트까지 다룬다.
MCP 서버 테스트 자동화: Python SDK 인메모리 Client와 pytest로 도구 호출 검증하고 CI에 붙이기
Python MCP SDK의 인메모리 Client로 서버 객체에 직접 연결해 도구 목록, 입력 스키마, 정상 결과와 오류 응답을 pytest로 검증하는 방법을 정리했다. 스키마 스냅숏으로 의도하지 않은 변경을 잡고 GitHub Actions에서 실행하는 구성까지 다룬다.
Claude Code에 MCP 서버 연결하기: local·project·user 범위와 .mcp.json 관리
Claude Code에서 claude mcp add로 MCP 서버를 등록할 때 local·project·user 범위가 어디에 저장되고 어떤 순서로 적용되는지 정리했다. 팀이 공유하는 .mcp.json의 환경 변수 확장, 프로젝트 서버 승인, 타임아웃과 출력 한도 설정도 다룬다.
Python MCP SDK로 MCP 서버 만들기: MCPServer 도구 정의부터 Claude Code 연결까지
공식 Python MCP SDK v2의 MCPServer로 도구·리소스·프롬프트를 정의하고 MCP Inspector로 확인한 뒤 Claude Code에 stdio로 연결하는 절차를 정리했다. v1 FastMCP 코드에서 바뀐 import·Context·run 사용법도 다룬다.
Agent Plugins 1.0으로 스킬과 MCP 서버 묶기: plugin.json·mcp.json 작성과 스키마 검사
Agent Plugins 1.0 형식으로 Agent Skills와 MCP 서버를 하나의 플러그인으로 묶는 방법을 정리했다. plugin.json·mcp.json 필드 규칙과 디렉터리 구조, 공식 스키마 기준 점검 스크립트와 올바른·잘못된 예시의 실행 결과를 다룬다.
GitHub MCP 서버로 이슈·PR·코드 검색을 AI 에이전트에 연결하기
GitHub 공식 MCP 서버로 이슈, PR, 저장소 검색을 AI 에이전트에 연결하는 방법을 정리했다. 원격 서버와 Docker 로컬 실행 설정, 필요한 기능만 켜는 toolsets, 읽기 전용 모드, 개인 액세스 토큰 범위와 활용 예시를 다룬다.
파일시스템·브라우저 자동화 MCP를 안전하게 쓰는 설정: 허용 경로와 격리
로컬 파일과 브라우저를 다루는 MCP 서버를 안전하게 설정하는 방법을 정리했다. Filesystem 서버의 허용 디렉터리와 Roots, 도구별 쓰기 여부, Docker 읽기 전용 마운트, Playwright MCP의 격리 프로필과 출처 제한 옵션, 문서가 밝힌 한계를 다룬다.
데이터베이스 MCP 서버 보안: 읽기 전용 계정, 쿼리 제한, 쓰기 분리
AI 에이전트에 데이터베이스 조회를 허용하는 MCP 서버를 안전하게 구성하는 방법을 정리했다. PostgreSQL 읽기 전용 역할과 statement_timeout, 자유 SQL 대신 정해진 도구, 쓰기 도구 분리와 승인, 결과 행 수 제한과 감사 로그를 다룬다.
MCP 도구 인터페이스 설계: 작은 입력 스키마, 오류 반환, 멱등성
MCP 도구를 모델이 정확히 고르고 안전하게 재시도할 수 있게 설계하는 기준을 2026-07-28 명세 기준으로 정리했다. 이름·설명 작성, 작은 입력 스키마, 출력 스키마, 오류 구분, 멱등성 키, 상태 핸들, 도구 주석 사용법을 다룬다.
MCP Inspector로 서버 디버깅하기: 연결 실패, 도구 오류, 스키마 문제 찾기
MCP 서버를 클라이언트에 붙이기 전에 MCP Inspector로 문제를 찾는 방법을 정리했다. 웹·CLI·TUI 실행 명령, 로컬·패키지·원격 서버 연결, 연결 실패와 도구 오류, 스키마 문제를 증상별로 좁히는 순서와 CI에서 쓰는 방법을 다룬다.
TypeScript SDK로 최소 MCP 서버 만들기: 도구 하나부터 연결 확인까지
MCP TypeScript SDK v2로 도구 하나를 가진 최소 MCP 서버를 만드는 과정을 정리했다. 패키지 설치, Zod 입력 스키마, structuredContent 반환, stdout 로그 금지, 클라이언트 등록과 Inspector 점검 순서를 다룬다.
MCP의 Tools·Resources·Prompts, 언제 무엇으로 노출할까
MCP 서버가 노출하는 Tools, Resources, Prompts를 2026-07-28 명세 기준으로 비교했다. 모델·애플리케이션·사용자 중 누가 사용을 결정하는지, 메시지 형식, 같은 기능을 어느 쪽으로 노출할지 판단하는 기준과 사내 서버 설계 예시를 다룬다.
Hugging Face MCP 서버 연결과 도구 구성: hf_fs 기본 도구와 추가 도구 고르는 법
Hugging Face MCP 서버를 AI 코딩 도구에 연결하는 절차와 도구 구성을 공식 문서 기준으로 정리했다. 기본 도구 hf_fs가 하는 일, 저장소 쓰기·작업 실행 같은 추가 도구를 켤 때의 판단 기준, Spaces 옵션, 도구 수를 적게 유지하는 이유를 다룬다.
MCP 2026-07-28 스펙 마이그레이션: 무상태 전환으로 바뀐 것과 기존 서버 점검 순서
MCP 2026-07-28 스펙은 세션과 초기화 절차를 없애고 요청마다 버전을 싣는 무상태 구조로 바뀌었다. 공식 변경 이력을 기준으로 주요 변경 사항, 구버전 클라이언트·서버와의 호환 조합, 기존 서버를 옮길 때 코드에서 찾아볼 항목을 순서대로 정리했다.
VS Code Continue에 MCP 서버 연결하기: 설정 파일, 읽기 전용 권한, 문제 해결
VS Code의 Continue 확장에 MCP 서버를 연결하는 방법을 공식 문서 기준으로 정리했다. 에이전트 모드 제약, YAML 설정과 비밀 값 문법, 파일시스템 서버의 허용 디렉터리, 데이터베이스 읽기 전용 계정, 연결 문제를 확인하는 순서를 다룬다.
사내 문서 RAG 접근 제어: 검색 단계에서 권한을 거르는 구현 방법
사내 문서로 RAG를 만들 때 권한 없는 문서가 답변 근거로 섞이지 않게 하는 방법을 정리했다. OWASP LLM08 위험 항목, pgvector에서 권한 필터를 거는 SQL, HNSW 인덱스와 필터를 함께 쓸 때의 결과 누락 문제, 권한 변경 반영 절차를 다룬다.
MCP 서버에 OAuth 붙이기: 2026-07-28 인가 명세의 필수 구현 항목
원격 MCP 서버를 직접 만들 때 필요한 인가 구현을 공식 명세 2026-07-28 기준으로 정리했다. 401 응답과 Protected Resource Metadata, resource 파라미터, 토큰 대상 검증, 권한 부족 시 단계적 상향, 토큰 전달 금지를 순서대로 다룬다.
IT 실무자를 위한 MCP 개념 정리: 호스트·클라이언트·서버와 연결 방식
Model Context Protocol(MCP)을 처음 접하는 실무자를 위해 호스트·클라이언트·서버의 역할, 도구 호출 요청의 모양, stdio와 Streamable HTTP 연결 방식, 인증이 적용되는 범위를 공식 명세 2026-07-28 기준으로 정리했다.