MCP를 통한 Claude Desktop API 통합

이 프로젝트는 Claude Desktop과 Claude API 간의 원활한 통합을 지원하는 MCP 서버 구현을 제공합니다. 이를 통해 Professional Plan의 제한을 우회하고 사용자 지정 시스템 프롬프트 및 대화 관리와 같은 고급 기능을 이용할 수 있습니다.

특징

MCP를 통한 직접 Claude API 통합
대화 내역 추적 및 관리
시스템 프롬프트 지원
Professional Plan과 API 사용 간의 원활한 전환
Claude Desktop을 이용한 간편한 구성

Related MCP server: Code Analysis MCP Server

언제 사용할 것인가

전문가 플랜 (기본):
- Claude Desktop에서의 정기 대화
- 계획 한도 내 기본 사용량
- 특별한 구성이 필요하지 않습니다
API 토큰 (이 MCP 서버를 통해):
- 더 긴 컨텍스트 창이 필요한 경우
- 사용자 정의 시스템 프롬프트를 사용하려면
- 요금 제한을 우회하려면
- 고급 대화 관리를 위해

설치 지침

저장소 복제
지엑스피1
종속성 설치
pip install -r requirements.txt
환경 구성
# Copy environment template cp .env.example .env # Edit .env and add your API key ANTHROPIC_API_KEY=your_api_key_here
Claude Desktop 구성
- macOS: ~/Library/Application Support/Claude/ 로 이동합니다.
  # Using Finder: # 1. Press Cmd + Shift + G # 2. Enter: ~/Library/Application Support/Claude/
- Windows: %APPDATA%\Claude\ 로 이동합니다.
- claude_desktop_config.json 생성하거나 편집합니다.
- config/claude_desktop_config.json 에서 내용을 복사합니다.
- 경로 및 API 키 업데이트

사용 가이드

기본 사용법

Claude 데스크톱 정기 사용
- 클로드와 평소처럼 채팅하세요
- 전문가용 플랜을 사용합니다
- 특별한 명령이 필요하지 않습니다
API 사용
@claude-api Please answer using the API: What is the capital of France?

고급 기능

시스템 프롬프트 사용
@claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan
대화 관리
# Start a new conversation @claude-api {"conversation_id": "project1"} Let's discuss Python # Continue same conversation @claude-api {"conversation_id": "project1"} Tell me more # View conversation history @claude-api get_conversation_history project1 # Clear conversation @claude-api clear_conversation project1

비용 관리

API 호출에는 Anthropic API 크레딧이 사용되며 요금이 부과될 수 있습니다.
정기적인 문의에는 Professional Plan을 사용하세요
특별히 필요한 경우에만 @claude-api를 사용하세요.
- 더 긴 컨텍스트 창
- 사용자 정의 시스템 프롬프트
- 요금 제한을 우회하려면

사용 가능한 MCP 도구

query_claude
- Claude에게 직접 API 호출을 합니다.
- 시스템 프롬프트 지원
- 대화 추적
clear_conversation
- 대화 기록 재설정
- 여러 대화 스레드 관리
get_conversation_history
- 대화 기록 검색
- 대화 흐름 디버깅

개발

주요 서버 구현은 src/claude_api_server.py 에 있습니다. 기능을 확장하려면 @mcp.tool() 데코레이터를 사용하여 새 도구를 추가할 수 있습니다.

새로운 도구를 추가하는 예:

@mcp.tool() async def custom_tool(param: str) -> str: """ Custom tool description Args: param: Parameter description """ try: # Tool implementation return result except Exception as e: return f"Error: {str(e)}"

문제 해결

API 키 문제
- .env에서 API 키를 확인하세요
- Claude Desktop 구성 경로 확인
- API 키에 올바른 권한이 있는지 확인하세요.
연결 문제
- MCP 서버가 실행 중인지 확인하세요
- Python 환경 확인
- Claude Desktop 로그 확인
사용 문제
- 올바른 @claude-api 구문을 확인하세요
- 대화 ID 확인
- 시스템 프롬프트 형식 확인