MCP를 통한 Claude Desktop API 통합

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

특징

• MCP를 통한 직접 Claude API 통합

• 대화 내역 추적 및 관리

• 시스템 프롬프트 지원

• Professional Plan과 API 사용 간의 원활한 전환

• Claude Desktop을 이용한 간편한 구성

언제 사용할 것인가

• 전문가 플랜 (기본):

  • Claude Desktop에서의 정기 대화

  • 계획 한도 내 기본 사용량

  • 특별한 구성이 필요하지 않습니다

• API 토큰 (이 MCP 서버를 통해):

  • 더 긴 컨텍스트 창이 필요한 경우

  • 사용자 정의 시스템 프롬프트를 사용하려면

  • 요금 제한을 우회하려면

  • 고급 대화 관리를 위해

설치 지침

1. 저장소 복제

   지엑스피1

2. 종속성 설치

   pip install -r requirements.txt

3. 환경 구성

   # Copy environment template cp .env.example .env # Edit .env and add your API key ANTHROPIC_API_KEY=your_api_key_here

4. 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 키 업데이트

사용 가이드

기본 사용법

1. Claude 데스크톱 정기 사용

   • 클로드와 평소처럼 채팅하세요

   • 전문가용 플랜을 사용합니다

   • 특별한 명령이 필요하지 않습니다

2. API 사용

   @claude-api Please answer using the API: What is the capital of France?

고급 기능

1. 시스템 프롬프트 사용

   @claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan

2. 대화 관리

   # 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 도구

1. query_claude

   • Claude에게 직접 API 호출을 합니다.

   • 시스템 프롬프트 지원

   • 대화 추적

2. clear_conversation

   • 대화 기록 재설정

   • 여러 대화 스레드 관리

3. get_conversation_history

   • 대화 기록 검색

   • 대화 흐름 디버깅

개발

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

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

문제 해결

1. API 키 문제

   • .env에서 API 키를 확인하세요

   • Claude Desktop 구성 경로 확인

   • API 키에 올바른 권한이 있는지 확인하세요.

2. 연결 문제

   • MCP 서버가 실행 중인지 확인하세요

   • Python 환경 확인

   • Claude Desktop 로그 확인

3. 사용 문제

   • 올바른 @claude-api 구문을 확인하세요

   • 대화 ID 확인

   • 시스템 프롬프트 형식 확인

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 만드세요

4. 풀 리퀘스트 제출

특허

MIT

지원하다

문제 및 문의사항:

1. 저장소에서 이슈를 엽니다

2. 기존 토론 확인

3. 문제 해결 가이드를 검토하세요