문서 / MCP

DOCS / MCP

에이전트 런타임에서 Seizn 메모리 사용

@seizn/mcp는 NPC 메모리, Canon Lock, deterministic replay, Chaos Monkey, Story Health를 MCP 도구로 노출합니다. 서버는 stdio로 실행되고 프로세스 환경변수의 SEIZN_API_KEY만 읽습니다.

01

설치

MCP 서버 시작 전에 SEIZN_API_KEY를 설정하세요. 키를 command args나 tool arguments로 넘기지 않습니다. SEIZN_API_URL은 선택값이며 기본값은 https://www.seizn.com 입니다.

export SEIZN_API_KEY=szn_live_xxx
npx -y @seizn/mcp

02

도구

seizn.memory.search(query, npc_id?)seizn.memory.create(npc_id, content, metadata?)seizn.canon.list(npc_id?)seizn.canon.check(npc_id?, proposed_content)seizn.replay.fetch(session_id)seizn.chaos.run(npc_id, suite)seizn.story_health.current(act?)

03

클라이언트 설정

Claude Desktop

{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "@seizn/mcp"],
      "env": {
        "SEIZN_API_KEY": "szn_live_xxx"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "@seizn/mcp"],
      "env": {
        "SEIZN_API_KEY": "szn_live_xxx"
      }
    }
  }
}

Claude Code

export SEIZN_API_KEY=szn_live_xxx
claude mcp add seizn -- npx -y @seizn/mcp

Codex CLI

[mcp_servers.seizn]
command = "npx"
args = ["-y", "@seizn/mcp"]

[mcp_servers.seizn.env]
SEIZN_API_KEY = "szn_live_xxx"

04

Canon check payload

{
  "tool": "seizn.canon.check",
  "arguments": {
    "npc_id": "archivist_vale",
    "proposed_content": "Vale reveals the sealed city password."
  }
}