FXMELO MCP 0.1.0 · 공개 베타
서버: https://fxmelo.com/api/mcp
연결 화면: https://fxmelo.com/integrations

1. 빠르게 검색 연결
Codex CLI:
  codex mcp add fxmelo --url https://fxmelo.com/api/mcp
Claude Code:
  claude mcp add --transport http fxmelo https://fxmelo.com/api/mcp
Codex 원본 다운로드 인증:
  codex mcp login fxmelo
Claude Code에서는 /mcp를 입력하고 fxmelo 인증 안내를 따릅니다.

Claude 웹·데스크톱:
  1) Customize(맞춤 설정) > Connectors(커넥터)에서 사용자 지정 커넥터를 추가합니다.
  2) 이름: FXMELO / 서버 주소: https://fxmelo.com/api/mcp
  3) 인증 설정이 보이면 Sign in now / Register automatically를 선택합니다.
  4) 열린 FXMELO 창에서 Google 로그인 후 요청 권한을 확인하고 연결을 허용합니다.
  5) 대화의 + > 커넥터에서 FXMELO를 켭니다.
요청의 openid는 계정 확인, offline_access는 로그인 유지를 위한 권한입니다.
승인창 오류가 남으면 창을 닫고 Claude에서 다시 연결하기로 새 요청을 만드세요.
별도 API 키·서비스 관리자 키를 입력할 필요가 없습니다.
Claude에서 공개 검색 연결만으로 계정 인증이 완료되지는 않습니다. 다운로드·get_usage 요청 시 로그인 안내가 뜨면 FXMELO 계정으로 인증하고 연결에 동의하세요.
기존 커넥터가 “인증 없음”으로 등록되어 로그인 안내가 표시되지 않으면 Claude의 Customize > Connectors > FXMELO에서 재연결하세요. 추가 설정에서 인증은 Sign in now, OAuth client는 Register automatically를 사용합니다.
로그인한 웹 계정과 Claude의 FXMELO 연결 계정은 각각 확인해야 합니다. 웹 로그인 쿠키가 Claude 서버에 자동 전달되지 않습니다.
클라이언트·플랜·관리자 정책에 따라 직접 연결 기능이 제공되지 않을 수 있습니다.
기존 대화에서 새 서버가 표시되지 않으면 새 대화/클라이언트를 다시 시작합니다.

2. 프로젝트에 실제 원본 파일 저장
다운로드: https://fxmelo.com/downloads/FXMELO-MCP-Companion-0.1.0.zip
압축을 풀고 Node.js 22 이상에서 실행합니다. npm 설치는 필요 없습니다.
웹사이트/Windows 프로그램 일반 이용에는 Node.js가 필요하지 않습니다.
압축을 푼 폴더를 터미널에서 열고 실행합니다.
macOS·Linux:
  node ./fxmelo-mcp.cjs login
Windows PowerShell:
  node .\fxmelo-mcp.cjs login
표시되는 FXMELO 인증 주소에서 Google 로그인과 연결 동의를 완료합니다.
계정 연결만으로 원본 다운로드 이용권이 생기지 않습니다. 별도 MCP 이용권이 없으면 원본 발급·저장이 거절되고 검색은 가능합니다.

쉬운 등록: 위와 같은 폴더에서 실행합니다. 사용할 Codex CLI 또는 Claude Code가 먼저 설치되어 있어야 합니다.
macOS·Linux / Codex:
  codex mcp add fxmelo-files -- node "$PWD/fxmelo-mcp.cjs"
macOS·Linux / Claude Code:
  claude mcp add --transport stdio fxmelo-files -- node "$PWD/fxmelo-mcp.cjs"
Windows PowerShell / Codex:
  codex mcp add fxmelo-files -- node "$($PWD.Path)\fxmelo-mcp.cjs"
Windows PowerShell / Claude Code:
  claude mcp add --transport stdio fxmelo-files -- node "$($PWD.Path)\fxmelo-mcp.cjs"
설정 후 AI 도구를 다시 시작하거나 새 대화를 엽니다.
파일은 AI 도구의 작업 폴더 아래 assets/fxmelo/에 저장됩니다.
압축을 푼 Companion 폴더는 등록 후 다른 위치로 이동하지 마세요.

고급: 특정 저장 폴더를 지정할 경우 (아래 예시 경로를 본인의 실제 절대 경로로 바꿉니다)
Codex 로컬 저장 도구 등록:
  codex mcp add fxmelo-files --env FXMELO_DOWNLOAD_DIR=/실제/프로젝트/assets/audio -- node /실제/경로/fxmelo-mcp.cjs
Claude Code 로컬 저장 도구 등록:
  claude mcp add --env "FXMELO_DOWNLOAD_DIR=/실제/프로젝트/assets/audio" --transport stdio fxmelo-files -- node "/실제/경로/fxmelo-mcp.cjs"
Windows 예시: 파일 경로를 "C:\Users\사용자\FXMELO-MCP\fxmelo-mcp.cjs"처럼 따옴표로 감쌉니다.
폴더를 지정하지 않으면 AI 도구의 작업 폴더 아래 assets/fxmelo에 저장합니다.

앱에서 직접 수동 등록하는 경우:
Codex 앱 설정의 MCP 서버에서 로컬 stdio 서버를 추가합니다.
이름: fxmelo-files
실행 명령: Node.js 실행 파일의 실제 절대 경로
인수: 압축을 푼 fxmelo-mcp.cjs 파일의 실제 절대 경로 한 개
저장 폴더를 정하려면 환경 변수 FXMELO_DOWNLOAD_DIR에 실제 절대 경로를 입력합니다.
Node 위치는 macOS·Linux에서 command -v node, PowerShell에서 (Get-Command node).Source로 확인할 수 있습니다.
CLI가 없다면 앱 설정을 사용하세요. 앱 버전·조직 정책에 따라 MCP 설정 위치와 지원 여부가 다릅니다.

Claude Desktop 수동 등록:
설정 > 개발자 > 설정 편집에서 claude_desktop_config.json을 엽니다.
macOS 기본 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows 기본 파일 위치: %APPDATA%\Claude\claude_desktop_config.json
기존 mcpServers 항목을 보존하면서 fxmelo-files 항목을 추가합니다.
아래 경로는 실행 가능한 값이 아닌 예시입니다. 세 경로를 본인 컴퓨터의 실제 절대 경로로 바꾸세요.
{
  "mcpServers": {
    "fxmelo-files": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/fxmelo-mcp.cjs"],
      "env": { "FXMELO_DOWNLOAD_DIR": "/absolute/path/to/project/assets/fxmelo" }
    }
  }
}
Windows JSON 경로의 역슬래시는 두 번 씁니다. 예: "C:\\Users\\사용자\\FXMELO-MCP\\fxmelo-mcp.cjs"
설정 후 Claude Desktop을 완전히 종료하고 다시 엽니다. 관리되는 PC는 로컬 MCP가 제한될 수 있습니다.

3. AI에게 이렇게 요청하세요
“FXMELO에서 게임 버튼 클릭에 맞는 1초 이하 효과음 3개를 찾아줘.”
“FXMELO BGM에서 잔잔한 음악 후보를 보여주고 사용 조건을 확인해줘.”
“이 후보의 원본을 save_sound로 프로젝트에 저장하고 실제 파일 경로를 알려줘.”
search_sounds → get_sound/get_license → 사용자 선택 → save_sound 순서입니다.
save_sound는 링크 문자열이 아닌 실제 WAV 파일·크기·SHA-256·저장 경로를 반환합니다.
원격 download_sound는 임시 링크 발급 기능입니다. 로컬 파일 저장은 companion이 담당합니다.

4. 계정·이용권·안전
Starter 월 $3.90 / 300회, Creator 월 $9.90 / 1,000회, Studio 월 $19.90 / 3,000회입니다. USD 기준이며 세금 등 최종 청구액은 결제 화면에서 확인합니다. 현재 판매 준비 중이며 홈페이지에서 구매할 수 없습니다. 이용권이 부여된 계정만 원본을 받을 수 있습니다. 이용 문의: help@fxmelo.com
MCP 원본 다운로드는 별도 이용권·한도로 제공됩니다. 웹 FREE/PRO 한도를 사용하지 않으며 웹 PRO에 MCP 무제한 다운로드가 포함되지 않습니다. MCP 도구에 결제·구독 변경 기능은 없습니다. 웹사이트 결제는 별도 연결이 완료된 후 제공합니다. 원본 발급 성공 1건만 차감하고 검색·발급 실패·동일 요청 재시도는 차감하지 않습니다. 한도 초과 자동 청구는 없습니다.
기존 파일을 덮어쓰지 않습니다. 같은 음원을 다시 저장하려면 사용자가 기존 파일을 정리해야 합니다.
저장 실패 후 이미 발급된 이용권은 소비됐을 수 있으므로 무작정 재시도하지 마세요.
다운로드한 파일은 개별 라이선스 조건을 확인하여 본인 제작물에 사용합니다.
대량 수집·원본 재배포·AI 학습 데이터 구축은 허용하지 않습니다.
이메일·카드 정보·서비스 관리자 키를 AI 도구에 입력하지 마세요.
연결 자격 증명은 사용자의 ~/.fxmelo-mcp 안에 보관됩니다. 공유·커밋하지 마세요.
연결 해제: https://fxmelo.com/integrations/connections
동의 철회 후 이미 발급된 접근 토큰은 만료까지 유효할 수 있습니다.
완전한 기기 연결 정리는 companion 종료 후 ~/.fxmelo-mcp의 해당 FXMELO 파일도 직접 삭제합니다.
원본 링크와 AI 대화·기기 파일은 별도로 보호·정리해야 합니다.

5. 배포와 심사 상태
검색 MCP 공개 베타입니다. OpenAI 공식 디렉터리 등록·제휴 승인을 받은 상태는 아닙니다.
계정 연결은 활성화되어 있으며 전용 OAuth 인증과 별도 MCP 한도를 사용합니다. 공개 검색은 로그인 없이 사용할 수 있습니다.
Windows/macOS/Linux companion은 Node 호환 설계이며 실기기 검증 범위는 릴리스 보고서를 확인합니다.
문의: help@fxmelo.com · 계정/권리 지원: support@fxmelo.com
