Claude Code를 활용한 보안 강화형 텔레그램 MCP 서버 개발기

커뮤니티 반응

작성자가 직접 개발한 도구의 보안 설계와 Claude Code의 높은 생산성에 대해 긍정적인 반응을 보이고 있습니다.

주요 논점

01찬성다수

AI 에이전트가 개인 메시지에 접근할 때는 반드시 세밀한 권한 제어가 필요하며, 이번 프로젝트가 그 표준을 제시했다.

합의점 vs 논쟁점

합의점

기존 오픈소스 MCP 서버들의 보안 제어 기능이 미흡하다는 점에 동의한다.
Claude Code가 복잡한 보안 로직과 테스트 인프라를 구축하는 데 매우 효율적이라는 점을 확인했다.

실용적 조언

AI 에이전트용 도구를 만들 때는 YAML 설정을 통한 화이트리스트 기반 접근 제어를 구현하여 보안을 강화하라.
개발용 AI와 리뷰용 AI를 분리하여 운영하면 보안 결함을 조기에 발견하고 수정하는 데 유리하다.

섹션별 상세

작성자는 기존 텔레그램 MCP 서버가 모든 채팅에 무제한 접근 권한을 부여하는 보안 결함을 발견하고 새로운 아키텍처를 설계했다. Claude Code는 기본 거부(Default-Deny) 원칙을 바탕으로 한 ACL 구조를 설계하고, Go 언어와 공식 MCP SDK를 사용하여 실제 구현을 담당했다. 이 과정에서 타입별 피어 매처(Peer Matcher)와 권한 병합 로직이 포함된 보안 계층이 구축되었다.

Claude Code는 단순한 코드 작성을 넘어 테스트 스위트 구축과 외부 리뷰 결과 반영까지 수행하며 주도적인 개발자 역할을 했다. 핸들러, 헬퍼, 그리고 tg.Client를 위한 모의 호출기(Mock Invoker)를 포함한 인프라를 직접 작성하여 안정성을 확보했다. 특히 외부 리뷰에서 지적된 심볼릭 링크 우회, 세션 권한, 파일 시스템 경계 문제 등의 보안 이슈를 스스로 찾아 수정했다.

개발된 MCP 서버는 텔레그램의 핵심 기능을 수행하는 8가지 도구를 제공하며 각 도구는 엄격한 보안 정책 하에 작동한다. 날짜 필터링이 포함된 대화 기록 조회, 미디어 다운로드, 전체 텍스트 검색, 파일 전송 등의 기능이 포함되어 있다. 모든 기능은 YAML 설정 파일에 명시된 화이트리스트 기반으로만 작동하며, RPC 레벨에서 속도 제한(Rate Limiting)이 적용된다.

작성자는 Claude Code와 다른 AI를 교차 활용하는 워크플로를 통해 단 하루 만에 프로젝트를 완성하고 배포했다. 사용자가 요구사항을 설명하면 Claude Code가 구현하고, 다른 AI가 코드를 리뷰한 뒤 다시 Claude Code가 수정 사항을 반영하는 반복 과정을 거쳤다. 이 방식을 통해 바이너리 빌드부터 Homebrew 및 npm 패키지 배포까지의 전 과정을 24시간 내에 마무리했다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol): — AI 모델이 외부 도구, 데이터 소스 및 서비스와 안전하고 표준화된 방식으로 상호작용할 수 있도록 Anthropic에서 공개한 개방형 프로토콜이다. 이를 통해 개발자는 다양한 데이터 소스를 LLM에 쉽게 연결할 수 있는 커넥터를 구축할 수 있다.
접근 제어 목록(Access Control List): — 특정 시스템 리소스에 접근할 수 있는 사용자나 프로세스를 정의하고 허용되는 작업 범위를 지정하는 보안 메커니즘이다. 이 프로젝트에서는 텔레그램 채팅방별로 읽기, 쓰기 등의 권한을 세밀하게 제어하는 데 사용되었다.
기본 거부 원칙(Default-Deny): — 명시적으로 허용되지 않은 모든 접근 요청을 기본적으로 차단하는 보안 설계 방식이다. 화이트리스트에 등록된 채팅방이나 기능만 활성화함으로써 신뢰할 수 없는 콘텐츠로부터 시스템을 보호하는 핵심 전략이다.
원격 프로시저 호출(Remote Procedure Call): — 별도의 원격 제어 로직 없이 다른 주소 공간에 있는 함수나 프로시저를 실행할 수 있게 하는 통신 규약이다. 본 프로젝트에서는 RPC 레벨에서 속도 제한을 적용하여 API 오남용과 보안 위협을 방지한다.

언급된 도구

Claude Code추천

아키텍처 설계, Go 구현, 테스트 작성 및 보안 수정 등을 수행하는 주 개발 도구

gotd/td중립

Go 언어용 텔레그램 프로토콜 구현 라이브러리

goreleaser추천

Go 프로젝트의 릴리스 자동화 도구

언급된 리소스

GitHubmcp-telegram GitHub Repository