yourept-mcp

CRM YOUREPT용 MCP 서버입니다. Claude, Cursor, Codex 및 기타 MCP 클라이언트에 연결하여 에이전트가 관리자 페이지 데이터(신청, 학생, 강사, 수업, 결제, 지급, 재무 보고서)에 접근할 수 있게 해줍니다.

이 서버가 존재하는 이유가 되는 질문들:

"이번 달에 얼마를 벌었고 지급에는 얼마가 나갔나요?" "기한이 지난 신청은 무엇이고 어느 매니저 담당인가요?" "2주 동안 수업이 없었던 학생들을 보여줘" "로켓워크에서 계약을 체결하지 않은 강사는 누구인가요?"

즉, 인터페이스에서 세 개의 섹션을 열고 숫자를 직접 맞춰봐야 했던 작업들입니다.

설치

1. 키 발급받기

관리자 페이지에서: 설정 → API 키 → 키 생성. 키는 한 번만 표시되므로 바로 복사하세요. 분실한 경우 새로 발급하고 기존 키는 폐기하세요.

키는 발급한 직원의 이름과 권한으로 작동합니다. 직원에게 차단된 섹션은 에이전트에게도 차단됩니다. "읽기 전용" 키(기본값)는 물리적으로 CRM에서 아무것도 변경할 수 없습니다.

2. 프로그램에 서버 등록하기

별도로 설치할 필요는 없습니다. npx가 패키지를 자동으로 다운로드합니다.

패키지는 GitHub에서 직접 설치됩니다. npm에 게시된 후에는 github:Skamatoz/yourept-mcp 대신 yourept-mcp라고만 쓰면 됩니다.

Claude Desktop — 설정 → Developer → Edit Config:

{
  "mcpServers": {
    "yourept": {
      "command": "npx",
      "args": ["-y", "github:Skamatoz/yourept-mcp"],
      "env": {
        "YOUREPT_API_URL": "https://api-admin.yourept.ru",
        "YOUREPT_API_KEY": "yrp_live_ваш_ключ"
      }
    }
  }
}

Claude Code:

claude mcp add yourept \
  --env YOUREPT_API_URL=https://api-admin.yourept.ru \
  --env YOUREPT_API_KEY=yrp_live_ваш_ключ \
  -- npx -y github:Skamatoz/yourept-mcp

Cursor — ~/.cursor/mcp.json 파일, 형식은 Claude Desktop과 동일합니다.

Codex — ~/.codex/config.toml 파일:

[mcp_servers.yourept]
command = "npx"
args = ["-y", "github:Skamatoz/yourept-mcp"]

[mcp_servers.yourept.env]
YOUREPT_API_URL = "https://api-admin.yourept.ru"
YOUREPT_API_KEY = "yrp_live_ваш_ключ"

설정 파일을 수정한 후에는 프로그램을 다시 시작해야 합니다.

Related MCP server: mcp-server-salesforce

제공 기능

금액은 루블로, 시간은 모스크바 기준으로 제공됩니다.

문제 해결

"키가 유효하지 않음" — 키가 폐기되었거나, 만료되었거나, 문자가 누락된 채 복사되었습니다. 관리자 페이지에서 확인하고 필요한 경우 새로 발급하세요.

"권한 부족" — 키가 발급된 직원에게 해당 섹션에 대한 접근 권한이 없습니다. 에이전트에게 whoami를 요청하세요. 어떤 섹션이 열려 있는지 표시됩니다.

"키가 읽기 전용으로 발급됨" — 정상입니다. 기본 키는 아무것도 변경하지 않습니다.

"관리자 페이지가 응답하지 않음" — YOUREPT_API_URL을 확인하세요. API가 작동하는 주소(보통 api-로 시작)가 필요하며, 관리자 페이지 사이트 주소가 아닙니다.

서버가 목록에 나타나지 않음 — 거의 항상 설정 파일의 닫히지 않은 괄호나 불필요한 쉼표 때문입니다. 관리자 페이지의 키 발급 화면에 전체를 복사할 수 있는 준비된 스니펫이 있습니다.

보안

• 데이터베이스에는 키의 해시만 저장되므로 키를 복원할 수 없습니다.

• 키는 해당 직원의 권한을 상속하며 이를 초과할 수 없습니다.

• 키로 키를 관리할 수 없습니다. API를 통해 새 접근 권한을 발급받을 수 없습니다.

• 폐기는 즉시 적용됩니다.

• 인터페이스에 없는 개인 데이터(체험 수업 녹취록)는 이 서버를 통해 접근할 수 없습니다.

직원이 퇴사할 때는 계정과 함께 키도 폐기하세요.

개발

pnpm install
pnpm build     # tsc → dist/

클라이언트에 연결하지 않고 서버를 확인하려면:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | YOUREPT_API_URL=http://localhost:4001 YOUREPT_API_KEY=ключ node dist/index.js

진단은 stderr로 출력됩니다. stdout에는 프로토콜만 있어야 하며, 그 외에는 쓸 수 없습니다.