SETUP.md•2.21 kB
# OpenAI MCP Server 설정 가이드
## ✅ 구현 완료 확인
✅ **키 파일에서 자동 읽기**: `/Users/a019051/.keys/openai_gpt.key`
✅ **GPT-5 완전 지원**: `max_completion_tokens`, temperature=1
✅ **stdio MCP 서버**: 포트 없이 작동
✅ **NPX 실행**: 즉시 사용 가능
## 🔧 설정 및 사용법
### 1. 현재 상태
키 파일(`/Users/a019051/.keys/openai_gpt.key`)에서 설정이 자동으로 로드됩니다:
```
OPENAI_API_KEY="sk-proj-..."
OPENAI_MODEL="gpt-5"
OPENAI_BASE_URL=
DEBUG="true"
```
### 2. Claude Code에 MCP 서버 등록
```bash
claude mcp add --transport stdio openai-gpt5 "npx openai-mcp-server"
```
### 3. 환경변수 우선순위
1. **시스템 환경변수** (`export OPENAI_API_KEY=...`)
2. **키 파일** (`/Users/a019051/.keys/openai_gpt.key`)
3. **프로젝트 .env 파일**
### 4. 사용 예시
```bash
# MCP 서버 상태 확인
claude mcp list
# GPT-5 호출 예시
claude mcp call openai-gpt5 call_gpt5 '{
"prompt": "안녕하세요",
"taskType": "generation"
}'
```
## 📋 지원 기능
### `call_gpt5` 도구 매개변수
- `prompt` (필수): 사용자 질문/요청
- `taskType` (필수): `analysis`, `generation`, `reasoning`, `coding`
- `domain` (선택): `security`, `performance`, `architecture` 등
- `context` (선택): Claude 세션 컨텍스트
- `customSystemPrompt` (선택): 사용자 정의 시스템 프롬프트
- `optimizationLevel` (선택): `balanced`, `creative`, `precise`
- `temperature` (선택): 창의성 수준 (GPT-5는 1만 지원)
- `maxTokens` (선택): 최대 응답 토큰
### GPT-5 특별 지원
- `max_completion_tokens` 매개변수 사용
- `temperature=1` (기본값) 고정
- 추론 토큰(`reasoning_tokens`) 지원
## 🔍 디버깅
### 디버그 모드 활성화
```bash
DEBUG=true npx openai-mcp-server
```
### 로그 확인 사항
- ✅ Config source: 'file' (키 파일에서 읽기)
- ✅ API 키 존재 확인
- ✅ GPT-5 모델 설정
- ✅ 연결 테스트 성공
## 🚀 배포 준비
프로젝트가 완전히 구현되어 NPM 배포 준비가 완료되었습니다:
```bash
# 로컬 테스트
npm run build
npm run start
# NPM 배포 (준비 완료)
npm publish
```