BSplus 라이믹스 AI Toolkit — 사용자 연결 가이드

발급받은 API 키로 Claude(AI)에 라이믹스 개발 전문 도구 13종을 연결하는 방법입니다. 키가 없으시면 BSplus(https://bsplus.net) 으로 문의해 주세요.

---

이게 뭔가요?

Claude에게 라이믹스 개발 능력을 꽂아주는 MCP 서버입니다. 연결하면 Claude가:

• 모듈/애드온/위젯 골격을 라이믹스 규칙에 맞게 생성 (스키마, 쿼리 XML, admin 클래스 분리, 트리거까지)
• 스키마/쿼리 XML을 작성 전에 검증 — 설치 실패의 흔한 원인(MySQL 타입 직접 사용, xe_ prefix, size 누락, pipe 누락 등)을 사전 차단
• PHP 7.4 ↔ 8.x 양방향 호환성 검사 — str_starts_with(7.4 불가), &getModel()/new Object()/중괄호 배열(8 불가) 등 15종 자동 검출
• 실전 검증된 라이믹스 개발 규칙 DB 참조 — 템플릿 엔진 함정, executeQuery 규칙, Windows/XAMPP 특이사항 등 실제 상용 모듈 개발에서 축적된 노하우
• 라이믹스 코어 소스 검색/함수 정의 조회 — Claude가 코어 API를 추측하지 않고 실제 시그니처를 확인하고 코딩

---

연결 방법

A. Claude Code (터미널) — 권장

claude mcp add --scope user --transport http rhymix-bsplus 서버주소/mcp --header "Authorization: Bearer 발급받은키"

• 서버주소와 발급받은키는 안내받은 값으로 교체
• 확인: claude mcp list 에서 rhymix-bsplus ... ✓ Connected 표시되면 성공

B. Claude Desktop (앱)

설정 파일 %APPDATA%\Claude\claude_desktop_config.json (Windows) 에 추가:

json

{
  "mcpServers": {
    "rhymix-bsplus": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "서버주소/mcp",
        "--header", "Authorization: Bearer 발급받은키"
      ]
    }
  }
}

저장 후 Claude Desktop을 완전히 종료 후 재실행 (트레이에서 종료). Node.js 18+ 필요.

---

사용 예시

연결 후 Claude에게 자연어로 말하면 됩니다:

• "라이믹스 출석체크 모듈 골격 만들어줘. 포인트 지급 기능 포함해서" → scaffold_module
• "이 스키마 XML 설치 가능한지 검증해줘" (XML 붙여넣기) → validate_schema_xml
• "이 PHP 코드 7.4랑 8 양쪽에서 도는지 검사해줘" (코드 붙여넣기) → check_php_compat
• "게시판 목록 페이징 쿼리 XML 만들어줘. 테이블은 myboard_item" → generate_query_xml
• "라이믹스에서 insertTrigger 함수 시그니처 보여줘" → find_definition
• "코어 board 모듈의 쿼리 XML 실제 예제 보여줘" → find_core_examples
• "모듈 개발 전에 알아야 할 DB 규칙 알려줘" → rhymix_rules

팁: 모듈 개발을 시작할 때 "먼저 rhymix_rules로 module이랑 db 카테고리 규칙 확인하고 시작해줘"라고 하면 Claude가 함정을 피해서 코딩합니다.

---

제공 도구 13종

도구	기능
rhymix_rules	실전 개발 규칙 조회 (8개 카테고리)
list_rule_categories	규칙 카테고리 목록
scaffold_module	모듈 풀 골격 생성 (18개 파일)
scaffold_addon	애드온 골격 생성
scaffold_widget	위젯 골격 생성
validate_schema_xml	스키마 XML 검증
validate_query_xml	쿼리 XML 검증
generate_query_xml	executeQuery용 쿼리 XML 생성 + 자가검증
check_php_compat	PHP 7.4↔8 호환성 검사
core_info	서버 측 라이믹스 코어 정보
search_core	코어 소스 전체 검색
find_definition	코어 클래스/함수 정의 조회
find_core_examples	코어 실예제 추출 (스키마/쿼리/module.xml 등)

---

이용 안내 / 제한

• 요청 한도: 키당 분당 60회 (초과 시 429 응답, 1분 후 자동 해제)
• API 키는 본인 전용입니다. 공유/유출 시 사전 통보 없이 차단될 수 있습니다.
• 보안을 위해 서버 파일 경로를 읽는 기능(file_path 등)은 비활성화되어 있습니다. 코드/XML은 내용을 직접 붙여넣어 주세요.
• 생성된 파일은 텍스트로 반환됩니다. Claude Code 환경이라면 Claude가 알아서 로컬에 파일로 저장해 줍니다.

문제 해결

증상	해결
401 Unauthorized	키 오타 확인. 헤더가 Authorization: Bearer rxmcp_... 형식인지 (Bearer 뒤 공백 1칸)
403	키가 비활성화됨 — 관리자에게 문의
429	1분 후 재시도
연결 자체가 안 됨	Claude Desktop 완전 재시작 / claude mcp list로 상태 확인 / 그래도 안 되면 문의

문의: https://bsplus.net — 불패의초인 (BSplus)