agentblueprint

Agent Blueprint를 위한 CLI 및 MCP 서버 — 코딩 에이전트가 AI 블루프린트, 비즈니스 케이스, 구현 계획 및 사양을 읽을 수 있는 권한을 제공합니다.

CLI 빠른 시작

# Install globally
npm install -g agentblueprint

# Store your API token (one-time)
agentblueprint login

# List blueprints
agentblueprint list

# Get a blueprint summary (JSON to stdout)
agentblueprint get blueprint <id>

# Get other artifacts
agentblueprint get business-case <id>
agentblueprint get use-case <id>
agentblueprint get implementation-plan <id>
agentblueprint get implementation-spec <id>
agentblueprint get business-profile

# Download as Agent Skills directory
agentblueprint download <id>

# Partner cross-org access
agentblueprint list --org <customer-org-id>
agentblueprint get blueprint <id> --org <customer-org-id>

또는 npx를 통해 설치 없이 실행하세요:

npx agentblueprint list --token <your-api-key>
npx agentblueprint get blueprint <id> --token <your-api-key>

MCP 서버 설정

동일한 바이너리가 stdin이 파이프될 때(비대화형) MCP 모드를 자동으로 감지합니다. 별도의 명령어가 필요하지 않습니다.

Claude Code MCP 설정(.claude/settings.json 또는 프로젝트 설정)에 추가하세요:

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": ["@agentblueprint/mcp-server"],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
      }
    }
  }
}

agentblueprint serve를 사용하여 MCP 서버를 명시적으로 시작할 수도 있습니다.

API 키 발급

Agent Blueprint 설정 > API 토큰으로 이동합니다.
"Create Token"을 클릭합니다.
토큰을 복사합니다(한 번만 표시됨).

블루프린트를 Agent Skills로 다운로드

블루프린트를 모든 코딩 에이전트가 파일 시스템에서 읽을 수 있는 로컬 Agent Skills 디렉토리로 다운로드하세요. 이것이 블루프린트를 사용하는 권장 방식입니다.

# Using the CLI (after `agentblueprint login`)
agentblueprint download <id>
agentblueprint download <id> --dir ./my-skills

# Or via npx
npx agentblueprint download --token <key> --blueprint <id>

이 작업은 다음과 같은 Agent Skills 디렉토리 구조를 생성합니다:

.agent-blueprint/<blueprint-slug>/
├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
├── references/
│   ├── business-context.md               # Use case, pain points, transformation story
│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
└── scripts/
    └── validate-spec.sh                  # Structure completeness checker

Agent Skills 표준은 Claude Code, Codex, Cursor, GitHub Copilot, Windsurf 및 18개 이상의 다른 코딩 에이전트에서 지원됩니다. SKILL.md는 활성화 시 자동으로 로드되며(~100 토큰), 참조 파일은 필요할 때 로드됩니다.

사용 가능한 도구

도구	설명
`list_blueprints`	모든 블루프린트 목록(요약)
`get_blueprint`	블루프린트 요약 — 제목, 에이전트, 단계, 패턴
`get_business_case`	비즈니스 케이스 요약 — ROI, 파일럿 경제성, 권장 사항
`get_implementation_plan`	구현 계획 요약 — 에픽, 타임라인, 스토리 수
`get_use_case`	블루프린트에 대한 유스케이스 분석
`get_implementation_spec`	구현 사양 메타데이터
`get_business_profile`	조직 비즈니스 프로필
`download_blueprint`	전체 블루프린트를 Agent Skills 파일 매니페스트로 다운로드

get_blueprint, get_business_case, get_implementation_plan 도구는 에이전트 컨텍스트 윈도우에 최적화된 간결한 요약을 반환합니다. 전체 세부 정보(에이전트 사양, 재무 예측, 사용자 스토리)를 보려면 download_blueprint를 사용하여 전체 Agent Skills 디렉토리를 가져오세요.

사용 가능한 리소스

URI	설명
`agentblueprint://blueprints`	블루프린트 목록 (JSON)
`agentblueprint://blueprints/{id}`	블루프린트 상세 정보 (Markdown)
`agentblueprint://blueprints/{id}/spec`	구현 사양 (Markdown)

인증

API 토큰을 제공하는 세 가지 방법(다음 순서로 확인됨):

모든 명령에서 --token <key> 플래그 사용
AGENT_BLUEPRINT_API_KEY 환경 변수
agentblueprint login (~/.config/agentblueprint/config.json에 저장됨)

환경 변수

변수	필수 여부	기본값	설명
`AGENT_BLUEPRINT_API_KEY`	아니요	—	API 토큰 (`agentblueprint login`의 대안)
`AGENT_BLUEPRINT_API_URL`	아니요	`https://app.agentblueprint.ai`	API 기본 URL

Agent Blueprint

agentblueprint

CLI 빠른 시작

MCP 서버 설정

API 키 발급

블루프린트를 Agent Skills로 다운로드

사용 가능한 도구

사용 가능한 리소스

인증

환경 변수

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API