# mcms-cli Docs

> microCMSで管理するmcms-cliのドキュメントを、Blumeで人とAIへ配信する検証サイト。

## Docs

- [mcms-cli](https://microcms-blume-lab.vercel.app/): mcms-cliは、microCMSのコンテンツ取得・更新、APIスキーマの保存、TypeScript型やJSON Schemaの生成をコマンドラインから行うコミュニティ製ツールです。導入方法から、安全な書き込み手順、AIやCIで機械的に結果を判定する方法までを、実行例とともに案内します。
- [インストールと認証](https://microcms-blume-lab.vercel.app/installation): mcms-cliのインストールからmicroCMSへの認証までを説明します。環境変数と名前付きプロファイルの使い分け、APIキーをOSのキーチェーンへ保存する方法、接続先と認証情報の取得元を作業前に確認するコマンドを、ローカル開発とCIの両方を想定して紹介します。
- [コンテンツを安全に操作する](https://microcms-blume-lab.vercel.app/content-operations): mcms-cliでmicroCMSのコンテンツを取得・作成・更新・削除する手順を説明します。接続先の確認、APIスキーマの取得、payload検証、dry-run、本実行、反映確認を順に進め、単件操作・一括操作・インポートを安全に扱うためのコマンド例と判定方法をまとめます。
- [スキーマと型を管理する](https://microcms-blume-lab.vercel.app/schema-and-types): microCMSのAPIスキーマをmcms-cliで取得してファイルに保存し、前回との差分を確認する方法を説明します。取得した定義からTypeScript型やdraft-07のJSON Schemaを生成し、アプリケーションの型付け、payload検証、フォーム生成、AIへ渡す構造定義に利用する流れを紹介します。
- [AI・CIから利用する](https://microcms-blume-lab.vercel.app/ai-and-ci): mcms-cliをAIエージェントやCIから安定して実行するための入出力契約を説明します。`--json`のレスポンス、終了コード、`.ok`による成否判定、コマンド仕様の検索、タスクガイドの参照方法を確認し、書き込み処理で検証とdry-runを組み込む実装例を紹介します。
- [コマンドリファレンス](https://microcms-blume-lab.vercel.app/command-reference): mcms-cliで利用できる主要コマンドを、認証、設定、コンテンツ、メディア、APIスキーマ、型生成、ドキュメント参照の目的別に一覧化します。各コマンドの役割と代表的な実行例に加え、JSON出力、プロファイル選択、タイムアウト、再試行など、共通オプションも確認できます。
- [FAQ・トラブルシューティング](https://microcms-blume-lab.vercel.app/faq): mcms-cliを使うときに迷いやすい点と、代表的なトラブルの確認方法をまとめます。公式ツールとの関係、実行コマンド名、認証先の確認、プロファイルとAPIキーの役割、書き込み前の検証、bulk操作のpayload検証、再試行、型生成ツールの選び方を質問形式で確認できます。

## Changelog

- [v0.8.0 - API作成コマンドを追加](https://microcms-blume-lab.vercel.app/changelog/v0-8-0): microCMS Management APIを利用してAPIを作成する microcms api create を追加しました。 JSONファイルからAPIを作成--name、--endpoint、--type…
- [v0.7.4](https://microcms-blume-lab.vercel.app/changelog/v0-7-4): This release makes direct content write dry-runs a better predictor of the actual write request. Previously, content create/update --dry-run could return .ok…

## English

### Docs

- [mcms-cli](https://microcms-blume-lab.vercel.app/en): Learn how to use mcms-cli to read and update microCMS content, inspect API schemas, generate types, and automate safe workflows from AI agents and CI.
- [Installation and authentication](https://microcms-blume-lab.vercel.app/en/installation): Install mcms-cli and connect it to microCMS with environment variables or named profiles, then verify the active service before running commands.
- [Safe content operations](https://microcms-blume-lab.vercel.app/en/content-operations): Use mcms-cli to inspect, validate, preview, and write microCMS content safely, with machine-readable checks before and after every change.
- [Managing schemas and types](https://microcms-blume-lab.vercel.app/en/schema-and-types): Pull and compare microCMS API schemas, then generate TypeScript declarations or JSON Schema for applications, validation, forms, and AI tools.
- [Using mcms-cli from AI and CI](https://microcms-blume-lab.vercel.app/en/ai-and-ci): Use mcms-cli from AI agents and CI with stable JSON envelopes, exit codes, searchable specifications, task guides, validation, and dry-runs.
- [Command reference](https://microcms-blume-lab.vercel.app/en/command-reference): Find the main mcms-cli commands for content, media, schemas, types, authentication, and documentation, plus common automation options.
- [FAQ and troubleshooting](https://microcms-blume-lab.vercel.app/en/faq): Resolve common mcms-cli questions about its unofficial status, command name, profiles, credentials, dry-runs, payload validation, retries, and types.
- [v0.7.4](https://microcms-blume-lab.vercel.app/en/changelog/v0-7-4): Version 0.7.4 aligns direct content write dry-runs with execution through schema validation, normalized payloads, select fixes, and clearer API errors.
- [v0.8.0](https://microcms-blume-lab.vercel.app/en/changelog/v0-8-0): Create microCMS APIs from JSON with schema and custom-field validation, dry-run review, and explicit approval for potentially chargeable API creation.

## RSS Feeds

- [mcms-cli Docs — Changelog](https://microcms-blume-lab.vercel.app/changelog/rss.xml)

## Agent skills

- [mcms-cli-docs](https://microcms-blume-lab.vercel.app/.well-known/agent-skills/mcms-cli-docs/SKILL.md): Read the mcms-cli Docs instead of answering from memory. microCMSで管理するmcms-cliのドキュメントを、Blumeで人とAIへ配信する検証サイト。 Use when a task involves mcms-cli Docs: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://microcms-blume-lab.vercel.app/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://microcms-blume-lab.vercel.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://microcms-blume-lab.vercel.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://microcms-blume-lab.vercel.app/openapi.json.
- [MCP server](https://microcms-blume-lab.vercel.app/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://microcms-blume-lab.vercel.app/.well-known/mcp.json
- [Agent skills](https://microcms-blume-lab.vercel.app/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://microcms-blume-lab.vercel.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://microcms-blume-lab.vercel.app/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://microcms-blume-lab.vercel.app/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://microcms-blume-lab.vercel.app/sitemap.xml): Every indexable page URL with its last-modified date.