도움말 - AppMake Mcp Server MCP Server

1. Claude.ai 웹사이트에서 커스텀 커넥터 설정

Claude.ai 접속 및 로그인

https://claude.ai에 접속하여 로그인합니다.

커넥터 설정

설정 → 커넥터 탭으로 이동합니다.

커스텀 커넥터 추가

"커스텀 커넥터 추가" 버튼을 클릭하고 다음 정보를 입력합니다:

이름: AppMake MCP
원격 MCP 서버 URL:
```
https://mcp.appmake.co.kr/mcp?apiKey=YOUR_API_KEY_HERE
```
※ YOUR_API_KEY_HERE 부분을 실제 API 키로 교체하세요

"추가" 버튼을 클릭하여 완료합니다.

연결 테스트 및 저장

"Test Connection" 클릭 후 성공하면 "Save"를 클릭합니다.

⚠️

커스텀 커넥터 기능은 Claude.ai 유료 요금제(Pro/Team)에서만 사용 가능합니다.

2. Claude Desktop에서 설정

방법 1: NPM 패키지를 통한 자동 설정 (권장)

npx appmake-mcp-client@latest setup YOUR_API_KEY

이 명령은 자동으로 AppMake MCP 클라이언트를 설치하고 설정합니다.

방법 2: 수동 설정

1단계: AppMake MCP 클라이언트 글로벌 설치

npm install -g appmake-mcp-client@latest

Windows 명령 프롬프트 또는 macOS/Linux 터미널에서 실행합니다.

2단계: 설정 파일 수정

설정 파일 위치:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

설정 파일에 다음 내용을 추가:

{
  "mcpServers": {
    "appmake": {
      "command": "appmake-mcp-client",
      "env": {
        "APPMAKE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

ℹ️

권장 설정 방식 (v1.0.13+):

글로벌 설치 방식 권장: npm install -g appmake-mcp-client@latest
설정 간소화: "command": "appmake-mcp-client" (npx 제거)
통계 추적 개선: Claude Desktop 사용 통계 정확한 기록
환경 변수: APPMAKE_API_KEY

⚠️ 기존 npx 방식도 동작하지만, 글로벌 설치 방식이 더 안정적이고 빠릅니다.

⚠️

설정 후 Claude Desktop을 완전히 종료하고 다시 시작해야 합니다.

3. ChatGPT에서 설정

ChatGPT 접속 및 로그인

https://chatgpt.com에 접속하여 로그인합니다.

MCP 서버 설정

ChatGPT 설정 → MCP 서버 또는 사용자 지정 커넥터 설정으로 이동합니다.

※ ChatGPT Plus 또는 Pro 구독이 필요할 수 있습니다.

MCP 서버 URL 추가

다음 정보를 입력합니다:

서버 이름: AppMake MCP
MCP 서버 URL:
```
https://mcp.appmake.co.kr/mcp?apiKey=YOUR_API_KEY_HERE&client=chatgpt
```
※ YOUR_API_KEY_HERE 부분을 실제 API 키로 교체하세요
※ &client=chatgpt 파라미터는 통계 추적을 위해 필수입니다
인증 지원: 없음
사용한 인증: 없음

"저장" 버튼을 클릭하여 완료합니다.

연결 테스트

ChatGPT 채팅창에서 다음과 같이 테스트해보세요:

"내 앱 목록을 보여줘"

정상적으로 연결되면 AppMake MCP 도구를 사용하여 앱 목록이 표시됩니다.

ℹ️

ChatGPT MCP 설정 주의사항:

URL에 &client=chatgpt 파라미터를 반드시 포함해야 통계에 정확히 기록됩니다
ChatGPT Plus 또는 Pro 구독이 필요할 수 있습니다 (무료 플랜에서는 MCP 기능이 제한될 수 있음)
API Key는 마이페이지에서 복사하여 사용하세요

사용 예시

📱 앱 생성

"https://example.com을 앱으로 만들어줘"

📋 앱 목록

"내가 만든 앱 목록을 보여줘"

🔄 재빌드

"MyApp을 Android용으로 다시 빌드해줘"

📨 푸시 알림

"MyApp 사용자들에게 푸시를 보내줘"

문제 해결

"API Key가 필요합니다" 오류

API Key가 올바르게 입력되었는지 확인하세요
설정 파일의 JSON 형식이 올바른지 확인하세요
API Key 앞뒤의 공백이나 따옴표를 확인하세요

MCP Server가 표시되지 않음

Claude Desktop을 완전히 종료했다가 다시 시작하세요
설정 파일 경로가 올바른지 확인하세요
JSON 형식 오류가 없는지 확인하세요

NPM 명령이 작동하지 않음

Node.js가 설치되어 있는지 확인: node --version
NPM이 설치되어 있는지 확인: npm --version
Node.js 다운로드에서 설치하세요

시작하기