---
title: FAQ・トラブルシューティング
description: >-
  mcms-cliを使うときに迷いやすい点と、代表的なトラブルの確認方法をまとめます。公式ツールとの関係、実行コマンド名、認証先の確認、プロファイルとAPIキーの役割、書き込み前の検証、bulk操作のpayload検証、再試行、型生成ツールの選び方を質問形式で確認できます。
sidebar:
  order: 7
noindex: false
---
## microCMS公式のCLIですか

いいえ。`mcms-cli`は非公式のコミュニティ製プロジェクトであり、microCMS公式とは無関係です。

## インストールしたのに`mcms-cli`コマンドが見つかりません

実行するコマンド名は`mcms-cli`ではなく`microcms`です。

```bash
microcms --help
microcms --version
```

## 認証先が想定どおりか確認したい

```bash
microcms auth status --json
microcms config doctor --json
```

選択中プロファイル、service domain、APIキーの取得元を確認します。APIキーそのものは表示されません。

## `profile add`だけで認証できますか

できません。`profile add`が保存するのはservice domainです。APIキーは`auth login`でOSキーチェーンへ保存するか、環境変数で渡してください。

## 書き込み前に何を確認すればよいですか

次の順番を基本にします。

1. `auth status`と`config doctor`
2. `schema pull`
3. `validate`
4. 書き込みコマンドの`--dry-run`
5. `.ok == true`と終了コードの確認
6. 本実行
7. `content get`または`content list`で反映確認

## `content bulk --dry-run`だけでpayloadも検証されますか

通常のdry-runは操作定義の構造を検証します。各endpointのスキーマに対してpayloadも検証するには、`--validate-payload`または`--strict-warnings`を指定します。

## APIキーを`--api-key`で指定してよいですか

コマンド引数はシェル履歴やプロセス一覧に露出する可能性があります。CIでは環境変数、ローカルではOSキーチェーン、パイプ処理では`--api-key-stdin`を利用してください。

## ネットワークエラーを再試行できますか

`--retry`は、既定でGETなどのretry-safeなリクエストに適用されます。書き込みを安易に自動再試行せず、結果とremoteの状態を確認してください。

## 型生成だけが目的です

mcms-cliでも型生成できますが、複雑なリレーションやリピーターを含む高度な型生成が主目的の場合は、READMEで案内されている専用CLIも比較してください。

## 関連ページ

- [インストールと認証](/installation)
- [コンテンツを安全に操作する](/content-operations)
- [コマンドリファレンス](/command-reference)