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トークンを提供するには3つの方法があります（以下の順序で確認されます）：

コマンドでの --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