MCP・CLI連携 | NovelShaft

接続方法と提供状況

外部AIへ自然言語で指示し、NovelShaftの操作を任せる場合。初期の対象クライアントはCodexです。

提供準備中 — 現在は接続できません。

MCPの接続手順

ターミナル、自作スクリプト、AIのシェル操作からコマンドを指定する場合。JSONで入出力します。MCP対応アプリへの登録やAIの利用は不要です。

配布準備中 — 一般向けダウンロードは未提供です。

CLIのコマンド仕様

以下は提供開始時の共通仕様です。準備中の接続は、プラン変更では有効になりません。

どちらも同じMCPサーバーを利用します。ブラウザーでNovelShaftアカウントにログインし、接続を許可します。

アクセス対象	本人が所有する全作品。接続後に作成する作品も含みます。作品単位の許可設定はありません。
対応操作	作品・原稿・参考資料の取得、作成、編集。対応するアカウント設定・利用状況・製品カタログも、本人の権限の範囲で利用します。
Web確認が必要な操作	作品の削除・公開、購入導線の作成、問い合わせ送信などは確認URLを返します。10分以内にNovelShaftのWeb画面で本人が内容を確認して実行します。どちらの接続方法でも代理承認はできません。
対象外	NovelShaft側のAI生成、文字起こし、音声生成、レポート生成、埋め込み再生成。連携経由の操作ではNovelShaftのAI利用枠を消費しません。外部AIを併用する場合、その料金は別途適用されます。
ファイル上限	入力ファイルは16 MiB、取得する応答本体は24 MiBまで。base64によるサイズ増加とクライアント側の制限もあります。大きい出力はWebから取得してください。
競合・再送	編集には最新の作品履歴版が必要です。競合時は再取得して判断します。同じ要求の再送では同じ操作ID・入力を使い、結果が未確定の操作を新しいIDで再実行しないでください。

「アカウント設定」→「外部AIとの接続」で対象アプリの許可を解除します。解除後の新規呼び出しと認証情報の更新は拒否されます。完了した編集や外部AIへ送信済みの内容は取り消されません。