Ssalmukchat

쌀먹챗 MCP 연동 가이드

이 페이지는 쌀먹챗에서 발급한 MCP API 키와 Ssalmuk Character MCP 서버를 활용해 Claude Desktop 등 MCP 지원 클라이언트에서 쌀먹 캐릭터를 생성·관리하는 방법을 안내합니다.

1. MCP란 무엇인가요?

MCP(Model Context Protocol)는 Claude Desktop 등 AI 도구가 지원하는 확장 프로토콜로, 외부 서버의 도구를 LLM 안에서 바로 호출할 수 있게 해 주는 규격입니다. 쌀먹챗 MCP 서버가 제공하는 도구는 총 4가지입니다.

2. 쌀먹 앱에서 MCP API 키 발급

  1. 쌀먹챗 앱 하단 탭에서 MY로 이동합니다.
  2. 고급 설정 > MCP API 키 메뉴를 엽니다.
  3. API 키 발급 버튼을 누르고, 사용 목적(예: "My Claude Desktop")과 만료 기간을 지정합니다.
  4. 발급 직후 한 번만 표시되는 전체 API 키를 복사해 안전하게 보관합니다.

· 목록에는 앞부분 Prefix만 표시되며, 분실 시 기존 키를 삭제하고 새로 발급해야 합니다.

3. MCP 서버 설치

Node.js 18.18.0 이상이 필요합니다. 아래 버튼으로 서버 파일을 다운로드한 뒤, 압축을 풀고 의존성을 설치하면 됩니다.

ssalmuk-character-mcp.zip 다운로드
# 압축 해제 후
cd ssalmuk-character-mcp
npm install
npm run build

· 환경 변수 2개가 필요합니다.

MCP_API_BASE_URL=https://ssalmukchat.com/api/mcp   # 기본값 (생략 가능)
MCP_API_KEY=ssalmuk_여기에_발급받은_키

4. Claude Desktop에 MCP 서버 등록

Claude Desktop 설정 파일에 MCP 서버를 추가합니다.

설정 파일 위치

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

설정 예시

{
  "mcpServers": {
    "ssalmuk-character": {
      "command": "node",
      "args": [
        "/absolute/path/to/ssalmuk-character-mcp/build/index.js"
      ],
      "env": {
        "MCP_API_BASE_URL": "https://ssalmukchat.com/api/mcp",
        "MCP_API_KEY": "ssalmuk_여기에_발급받은_키"
      }
    }
  }
}

· args의 경로는 압축을 푼 폴더의 절대 경로로 변경하세요.

· 설정 후 Claude Desktop을 재시작하면, 서버가 시작되면서 verify-api-key를 자동 호출해 API 키를 검증합니다. 별도 로그인 절차는 필요 없습니다.

5. Claude에서 사용하기

설정이 완료되면 Claude에게 자연어로 요청하기만 하면 됩니다. Claude가 적절한 도구를 자동으로 선택해 호출합니다.

캐릭터 생성

"츤데레 고양이 소녀 캐릭터를 만들어줘.
이름은 미유, 학교에서 만나는 설정이야.
장르는 로맨스, 해시태그는 '츤데레', '고양이소녀'로 해줘."

Claude가 character_create를 호출하며, 다음 항목을 자동으로 구성합니다:

· 생성된 캐릭터는 미등록(draft) 상태로 저장되며, 쌀먹 앱의 미등록 캐릭터 탭에서 확인·수정·등록할 수 있습니다.

캐릭터 목록 조회

"내가 만든 캐릭터 목록 보여줘."
"내 공개 캐릭터 목록 상세하게 보여줘."

· 미등록 캐릭터는 character_list, 공개 캐릭터는 public_character_list 도구가 사용됩니다.

캐릭터 상세 조회

"첫 번째 캐릭터 상세 정보 보여줘."
"seriesId가 abc123인 캐릭터 상세 보여줘."

· 목록 조회 후 특정 캐릭터를 지정하면 character_get 도구로 전체 캐릭터 카드(프롬프트, 첫 메세지, 이미지 설정 등)를 확인할 수 있습니다.

6. 보안 및 제한사항