🚀 [Project] AI 내 직원 만들기: MCP 서버의 완성, 보안과 인증의 실무 전략

🛡️ 보안 전략: "이미 있는 것을 활용하라" (DRF Token의 재발견)

API를 대중에게 공개하거나 특정 기능을 인가된 사용자에게만 노출하는 것은 데이터 보안의 핵심입니다. 저는 FastAPI의 자체 인증(OAuth2.0, JWT 등)을 새로 구축하는 대신, 메인 프로젝트인 Django REST Framework(DRF)의 AuthToken을 활용하기로 했습니다.

• 이유 1: 의존성 최소화: fastapi[all]을 설치하여 불필요한 라이브러리 비대화를 초래하기보다, 현재 시스템에서 가장 가벼운 경로를 선택했습니다.

• 이유 2: 통합 관리: 사용자의 인증키는 이미 Django DB에 존재합니다. 이를 활용하면 API 서버와 메인 서버 간의 인증 체계를 이중으로 관리할 필요가 없어 효율적입니다.

💡 인사이트: 좋은 질문자가 AI를 이긴다

개발 과정에서 제가 느낀 점은, 클로드(Claude)나 제미나이(Gemini) 같은 AI가 코드를 짜주더라도 '유기적 결합'은 여전히 인간의 몫이라는 것입니다.

특히 "AI가 뱉어주는 오류는 학습의 기회"라는 점을 강조하고 싶습니다. 코드를 너무 완벽하게 짜주는 AI는 오히려 초보 개발자에게 '독'이 될 수 있습니다. 오류를 직접 마주하고, "왜 이 코드가 동작하지 않는지"를 집요하게 묻는 과정에서 우리의 '프로그래밍 상식'이 길러지기 때문입니다. 이 상식이 뒷받침되어야만 AI에게 더 예리하고 창의적인 질문을 던지는 '좋은 질문자'가 될 수 있습니다.

💻 실전 코드: fastapi-mcp 인증 구현 (Authorization)

이제 실제 구현된 코드의 핵심을 짚어보겠습니다. 일반적인 검색으로는 찾기 힘든 fastapi-mcp 공식 문서 기반의 설정입니다.

1. MCP 서버 측: 의존성 주입 (Dependency Injection)

서버는 환경변수에 저장된 AUTH_TOKEN과 클라이언트가 보낸 헤더를 대조합니다. FastApiMCP 객체 생성 시 auth_config 파라미터를 통해 이를 상시 검증하도록 설정했습니다.

# MCP 서버측 설정 예시 from fastapi import Depends, Header, HTTPException from fastapi_mcp import FastApiMCP, AuthConfig  def validate_drf_token(authorization: str = Header(...)):     # "Token <your_token>" 형식에서 토큰값 추출 및 검증 로직     if not authorization == f"Token {MY_AUTH_TOKEN}":         raise HTTPException(status_code=401, detail="Invalid Token")  mcp = FastApiMCP(     app,     auth_config=AuthConfig(         dependencies=[Depends(validate_drf_token)],     ), ) mcp.mount_http(mount_path="/mcp") 

2. MCP 클라이언트 측: 헤더 실어 보내기

클라이언트(TradeNPU_AI)에서는 요청을 보낼 때 StreamableHttpTransport의 headers 파라미터에 인증 정보를 담아 전송합니다.

# MCP 클라이언트측 설정 예시 from mcp import Client from mcp.client.http import StreamableHttpTransport  transport = StreamableHttpTransport(     url=MCP_SERVER_URL,     headers={         "Authorization": f"Token {drf_token}",     } )  mcp_client = Client(transport=transport) 

🧭 결론: 로컬을 넘어 원격으로 가는 징검다리

인증 과정까지 성공적으로 통합하며, 이제 '내 직원'은 허락된 사용자에게만 반응하는 든든한 가드가 되었습니다. 당장은 저만 사용하는 로컬 환경이지만, 이 구조는 언제든 원격 서버로 확장하여 전체 사용자에게 개방할 수 있는 표준 규격이 됩니다.

기술적 난관을 해결하는 과정에서 얻은 프로그래밍 근육은 다음 단계인 '더 복잡한 도구(Tool) 개발'을 위한 소중한 자산이 될 것입니다.

💡 안내: 이 포스팅은 기존 네이버 블로그의 '개발용 MCP 로컬서버 만들기' 3, 4회차를 통합한 기록입니다. FastAPI 기반 MCP 서버에 DRF 인증키를 접목하여 보안을 강화하는 방법과, AI와 협업하는 '현명한 질문자'의 태도에 대해 다룹니다.