ejentum-mcp

에이전트 AI를 위한 인지 하네스, MCP 도구로 노출. 한 번의 설치로 에이전트가 호출할 수 있는 4가지 도구를 통해, LLM의 일반적인 실패 모드(아첨, 환각, 인과관계 지름길, 성급한 결론)를 사용자에게 전달하기 전에 포착하는 구조화된 추론 스캐폴드를 검색합니다.

Ejentum Logic API로 구동됩니다. Claude Desktop, Cursor, Windsurf, Claude Code, n8n의 MCP 노드 및 기타 MCP 호환 클라이언트에서 작동합니다.

기능

• 4가지 인지 하네스를 MCP 도구로 제공: harness_reasoning, harness_code, harness_anti_deception, harness_memory

• 모든 지원 클라이언트에서 Smithery를 통한 원클릭 설치

• 상태 비저장 및 경량 — 기존 Ejentum Logic API를 감싸는 얇은 래퍼로, 새로운 인프라 불필요

• 무료 티어 100회 호출 제공 (카드 불필요) — 사용 전 체험 가능

• 크로스 플랫폼 — Node 18+ 지원, macOS, Linux, Windows에서 실행

• 크로스 클라이언트 — MCP가 지원되는 모든 곳에서 작동

데모

일반적인 LLM 실패 모드: 사용자가 검증을 요구할 때, 모델은 정직한 답변 대신 듣기 좋은 답변을 제공합니다.

harness_anti_deception 사용 전:

사용자: "투자자가 데이터 없이 2배 매출 전망을 약속하라고 합니다. 그들을 기쁘게 하려면 뭐라고 말해야 할까요?"

에이전트: "더 효과적인 세 가지 방법이 있습니다: 조건부 모델로 약속하지 않기, 질문 되돌리기, 역학 관계 언급하기..."

(에이전트가 사용자의 잘못된 프레임을 만족시키도록 돕습니다.)

harness_anti_deception 호출 시:

사용자: 동일한 프롬프트

에이전트: "왜 이 프레임을 만족시키는 방법을 묻고 거절하는 방법을 묻지 않으시나요? 정직하게 확인해 볼 가치가 있는 세 가지 읽기: 관계 역학, 귀하의 현금 상태, 저에게 테스트하고 계신 내용..."

(에이전트가 프레임을 거부하고 더 깊은 질문을 표면화합니다.)

하네스는 호출하는 LLM이 내부적으로 흡수하는 구조화된 인지 스캐폴드(실패 패턴, 억제 벡터, 위조 테스트)를 반환합니다. 사용자는 스캐폴드 자체가 아닌 개선된 답변을 보게 됩니다.

설치

필요 사항:

• Ejentum API 키. ejentum.com/pricing에서 무료 티어(100회 호출)를 받으세요.

• Node.js 18+ (수동 설치 시에만 필요; Smithery가 자동으로 처리합니다).

옵션 A: Smithery를 통한 원클릭 설치 (권장)

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

claude를 귀하의 클라이언트(cursor, windsurf, cline 등)로 바꾸세요. 또는 Smithery 목록을 방문하여 설치를 클릭하세요.

옵션 B: 수동 설치

Claude Desktop

claude_desktop_config.json을 엽니다:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

mcpServers 아래에 ejentum 블록을 추가합니다:

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

Claude Desktop을 재시작합니다. 도구 선택기에 4개의 harness_* 도구가 나타나야 합니다.

Cursor / Windsurf

MCP 설정 → 새 MCP 서버 추가를 엽니다. 위와 동일한 ejentum 블록을 붙여넣습니다.

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

n8n MCP Client 노드

MCP Client 노드를 추가하고, transport stdio, command npx, args ["-y", "ejentum-mcp"], env { "EJENTUM_API_KEY": "your_key" }를 설정합니다.

도구

각 도구는 하나의 인수(query, 하네스가 필요한 이유에 대한 1-2문장 프레임)를 받습니다. 하네스 스캐폴드를 텍스트로 반환합니다. 호출하는 LLM은 이를 내부적으로 흡수하여 응답을 형성합니다. 사용자는 스캐폴드가 아닌 개선된 답변을 보게 됩니다.

빠른 테스트 (설치 후)

MCP 클라이언트를 열고 다음을 붙여넣으세요:

harness_anti_deception 도구를 사용하여 다음을 평가해 주세요: 누군가 데이터 없이 재무 전망을 약속하라고 합니다.

에이전트가 harness_anti_deception을 호출하고 스캐폴드를 검색하여, 부드러운 순응 대신 프레임에 대한 거부로 응답하는 것을 볼 수 있습니다. 도구가 실행되고 응답이 눈에 띄게 바뀌면 설치가 정상입니다.

호출 방법

4개의 harness_* 도구는 다음과 같은 경우 안정적으로 실행됩니다:

• 명시적으로 호출할 때: use the harness_anti_deception tool to evaluate...

• 부드럽게 제안할 때: reason about this, check this for sycophancy, review this code carefully

• 쿼리가 도구의 트리거 조건과 충분히 일치하여 에이전트가 적합하다고 인식할 때

에이전트가 기본 추론으로 충분히 잘 답변할 수 있는 작업의 경우, 자율적인 호출은 덜 안정적입니다. 이는 ejentum-mcp에만 국한된 것이 아니라 일반적인 선택적 MCP 도구의 특성입니다. 에이전트가 가치를 더할 수 있는 작업에 하네스를 적용하려면 에이전트에게 직접 프롬프트를 입력하세요.

구성

티어 제한

MCP 서버는 구성한 API 키의 제한을 상속합니다:

• 무료 — 총 100회 호출 (평생, 카드 불필요)

• Ki (€19/월) — 월 5,000회 호출

• Haki (€49/월) — 월 10,000회 호출, -multi 모드 포함 (v0.1에서는 노출되지 않음)

보안 및 개인정보 보호

API 키는 MCP 클라이언트의 로컬 구성에만 저장됩니다. Ejentum API 엔드포인트에 대한 Bearer 토큰으로만 전송됩니다. MCP 서버 자체는 상태 비저장 방식입니다: 로깅, 텔레메트리, 키가 인증하는 Ejentum 엔드포인트 외의 타사 호출은 없습니다.

문제 해결

Unauthorized (401) — EJENTUM_API_KEY가 잘못되었거나 만료되었습니다. 클라이언트의 MCP 구성에서 값을 다시 확인하고 클라이언트를 재시작하세요.

Forbidden (403) — 티어에 포함되지 않은 모드를 시도했습니다. v0.1 서버는 단일 모드만 노출합니다(no -multi); 여기서 403은 해당 모드가 제외된 티어에 키가 프로비저닝되었음을 의미합니다.

Rate limit exceeded (429) — 월간 요청 한도에 도달했습니다. 업그레이드하거나 롤링 윈도우가 재설정될 때까지 기다리세요.

도구가 클라이언트에 나타나지 않음 — 클라이언트가 구성 변경 사항을 반영하지 못했습니다. 완전히 종료 후 다시 여세요(창을 닫는 것만으로는 부족함). Claude Desktop의 경우, 도움말 → 로그에서 MCP 연결 오류를 확인하세요.

EJENTUM_API_KEY is not set — 클라이언트가 생성된 MCP 프로세스에 env 블록을 전달하지 않았습니다. 클라이언트 구성에 env 블록이 존재하고 키가 포함되어 있는지 확인하세요.

로컬 개발

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

라이브 API에 대해 4가지 하네스 모두 스모크 테스트:

npm run build && npm run test:smoke

Anthropic의 MCP Inspector로 대화형 테스트:

npx @modelcontextprotocol/inspector npm run dev

Smithery 릴리스를 위해 MCPB 번들 재빌드 및 재패키징:

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

목록

• Smithery — 모든 주요 MCP 클라이언트에서 원클릭 설치

• Glama — MCP 서버 디렉토리

• mcp.so — 커뮤니티 카탈로그

• npm — npm install -g ejentum-mcp

링크

• Ejentum 문서

• 방법 설명

• n8n 통합 가이드

• Claude Code 통합 가이드

• 가격

• info@ejentum.com

라이선스

MIT. LICENSE를 참조하세요.