Praxicraft Assess MCP

Praxicraft Assess 공개 API용 공식 Model Context Protocol 서버입니다.

Cursor, Claude Code, Claude Desktop, Codex 또는 모든 MCP 클라이언트를 연결하여 에이전트가 후보자를 초대하고, 평가 및 파이프라인을 관리하고, 웹훅을 등록하고, 결과를 가져올 수 있습니다 — 사용자의 허가를 받아서 말이죠.

npx -y @praxicraft/assess-mcp

Node.js 18+ 필요. 제품 문서: docs.praxicraft.com/assess-mcp · Build with agents

API MCP + 문서 검색 + 스킬을 하나로 통합 설치를 원하시나요? Assess Agent Plugin을 사용하세요.

목차

• 연결하는 두 가지 방법

• 인증

• 빠른 시작

  • 호스팅 HTTP (Cursor / Claude Code)

  • Stdio (API 키)

• 에이전트가 할 수 있는 작업

• 라이브 모드 vs 테스트 모드

• 오류

• 요구 사항 및 지원

• 라이선스

Related MCP server: Oktopost MCP Server

연결하는 두 가지 방법

호스팅 OAuth는 Cursor와 Claude에서 가장 쉬운 방법입니다. ct_test_ 키가 필요하거나 비대화형 환경에서는 stdio를 사용하세요.

인증

호스팅 (OAuth)

구성에 API 키가 필요 없습니다. 첫 번째 도구 호출 시 브라우저 동의 화면이 열립니다. 소유자, 관리자 및 개발자가 승인할 수 있습니다.

호스팅 세션은 항상 라이브 모드입니다.

Stdio (API 키)

조직 API 키를 생성하세요:

Assess → Developer → API Keys → 키 생성 → ct_live_… 또는 ct_test_… 복사 (한 번만 표시됨).

export PRAXICRAFT_API_KEY="ct_test_xxxxxxxxxxxxxxxx"
# optional
export PRAXICRAFT_API_BASE_URL="https://assess.praxicraft.com"

API 키를 커밋하지 마세요. 환경 변수 또는 비밀 관리자를 사용하는 것이 좋습니다.

API 키의 IP 허용 목록은 Public API / stdio MCP 요청에 적용됩니다. 호스팅 OAuth에는 적용되지 않습니다. 다른 키가 CIDR로 제한된 경우 stdio에는 빈 허용 목록의 전용 키를 사용하세요.

범위 및 회전: Authentication

권장 범위

빠른 시작

호스팅 HTTP (Cursor / Claude Code)

MCP 설정에 추가하세요:

{
  "mcpServers": {
    "praxicraft-assess": {
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

Claude Code 예시:

{
  "mcpServers": {
    "praxicraft-assess": {
      "type": "http",
      "url": "https://assess.praxicraft.com/mcp"
    }
  }
}

클라이언트를 다시 시작한 후 다음을 시도해 보세요: "내 Assess 평가 목록을 표시하고 첫 번째 활성 평가에 나를 초대해 줘."

Stdio (API 키)

{
  "mcpServers": {
    "praxicraft-assess": {
      "command": "npx",
      "args": ["-y", "@praxicraft/assess-mcp"],
      "env": {
        "PRAXICRAFT_API_KEY": "ct_test_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

소스에서 (기여자):

git clone https://github.com/praxicraft-platform/praxicraft-assess-mcp.git
cd praxicraft-assess-mcp
npm ci
npm test
npm run smoke

에이전트가 할 수 있는 작업

도구는 Assess Public API(/api/v1/public/…)에 매핑됩니다. 포함 범위:

응답은 플랫 JSON입니다 (Public API와 동일한 형태 — { "data": … } 래퍼 없음).

에이전트에게 플랜 제한을 준수하고 error.code로 분기하도록 안내하세요.

라이브 모드 vs 테스트 모드

테스트 candidate.passed는 라이브 Slack 또는 HTTPS 대상에 도달하지 않습니다. Live and Test mode를 참조하세요.

오류

Public API 오류는 다음과 같습니다:

{ "error": { "code": "SOME_CODE", "message": "…", "details": {} } }

항상 error.code로 분기하세요. 참조: Errors

요구 사항 및 지원

• Node.js 18+ (stdio 패키지)

• API 키를 포함하는 Assess 플랜 (플랜 제한 참조)

• 제품 문서: docs.praxicraft.com

• Agent Plugin (API + 문서 Knowledge MCP + 스킬): praxicraft-assess-agent-plugin

• 이슈: GitHub Issues

• 이메일: support@praxicraft.com

호스팅 /mcp 서비스를 배포하는 관리자: DEPLOYMENT.md를 참조하세요.

라이선스

MIT