Slima MCP

Claude / ChatGPT / Cursor / Geminiから自分のSlimaの作品を読み書きする

MCPの初回設定

• 01 Slima MCPとは MCP（Model Context Protocol）は、AIツールが外部のシステムを読み書きするための業界標準です。Slima MCPを使うと、Claude・ChatGPT・Cursor・GeminiからSlimaの作品を直接読み書きできます。
• 02 Slima MCPとファイルMCPと内蔵のAI コーチ AIが原稿にたどり着く道は三つあります。Slima MCP（作品へのAPI接続）、ファイルMCP（手元のフォルダーを指すだけ）、そしてエディター内蔵のAI コーチです。
• 03 接続方法を選ぶ：WebとローカルSlima MCP 接続の道は二つです。Web（OAuth。claude.aiやChatGPTが使います）と、ローカルのstdio（npmパッケージ。Claude Desktop・Cursor・Gemini CLIが使います）。

Web接続（OAuth）

• 01 Claude.aiから接続する（おすすめ） claude.aiにSlima MCPをカスタムコネクターとして追加します。OAuthでつなぐだけで、インストールは要りません。必要なClaude.aiのプランも説明します。
• 02 ChatGPTから接続する ChatGPTではDeveloper Mode（2025.10以降）を有効にし、Custom MCP ServerとOAuthで接続します。PlusまたはProのプランが必要です。

ローカル接続（stdio）

• 01 Claude Desktopに接続する Claude Desktopはローカル接続です。claude_desktop_config.jsonを編集し、npx slima-mcp@0を指定します。macOSとWindowsの設定ファイルの場所も載せています。
• 02 Cursorに接続する Cursorの設定 → MCPからサーバーを追加し、npx slima-mcp@0を指定します。Claude Desktopとほぼ同じ手順で、画面の見た目だけが違います。
• 03 Gemini CLIに接続する Gemini CLIなら`gemini mcp add slima --command "npx -y slima-mcp@0"`の一行で追加できます。Gemini CLI 0.4以降が必要です。
• 04 VS Codeに接続する VS CodeはMCPの拡張機能を通じて接続します。よく使われるのはMCP ToolsとContinueです。

トークンの管理

• 01 SLIMA_API_TOKENを取得する 取得の道は二つです。`npx slima-mcp@0 auth`を実行してブラウザでログインする方法（~/.slima/credentials.jsonに保存されます）と、画面のないサーバーやCIでSLIMA_API_TOKENを手で設定する方法。
• 02 slima-mcpのCLIコマンド一覧 `slima-mcp`のCLIコマンドをすべて説明します。auth / status / logout / --help / --version。使い方と例を載せています。
• 03 連携アプリを管理する アカウント → 連携アプリでは、いま接続しているアプリと最終利用日時を確認し、一つずつでもまとめても取り消せます。

バージョンとアップデート

• 01 `slima-mcp@0`と書く理由：バージョンの固定 どの例も`slima-mcp`ではなく`slima-mcp@0`と書いています。`@0`はメジャーバージョンの固定です。0系の修正と機能追加は自動で入り、1.0の破壊的変更は自分で選んで入れられます。
• 02 グローバルインストールから`npx`へ移行する 以前は`npm install -g slima-mcp`を使っていました。いまは`npx -y slima-mcp@0`が推奨です。移行する理由と手順を説明します。
• 03 slima-mcpのバージョンの仕組み 0.3.0（2026-09-09）。サーバーは古いクライアントを締め出さず、古い版は呼べるツールが少ないだけ。確認のしかたとアップグレードの手順。

ツール一覧

• 01 作品を扱うツール Slima MCPには作品の単位で動くツールがあります。create_book / list_books / get_book / get_book_structure / get_chapter / get_writing_stats。入力と出力を例つきで説明します。
• 02 ファイル操作ツール read_file / edit_file / write_file / create_file / delete_file / append_to_file / search_contentの引数とふるまい、そしてこの一群が触れないファイルの型。
• 03 Beta Readerのツール（2種類） Beta ReaderをMCPから使うツールが2つあります。list_personasとanalyze_chapter。入力と出力、Slimaの中の読書依頼との対応を説明します。
• 04 構造化編集ツール（update_*） update_*ツールでビートボード・年表・脚本・関係マップ・世界地図を編集する方法。1回1操作、op_refでのつなぎ、バッチは全部通るか何も残らないか。
• 05 メモとコメントのツール 外部のAIにメモを読み書きさせ、コメントのやり取りに参加させる。list_notes / create_note / list_comments / create_comment / resolve_comment / reopen_comment。
• 06 意味で探す検索と全文検索 semantic_searchは意味で、search_contentは文字で照合します。どの問いをどちらに投げるか、そして索引はどう作られるか。

ファイル種別と権限

• 01 MCPがファイル種別ごとにできること 完全な対応表。散文は丸ごと書ける、5つの構造化の型はフィールド単位のツール、どちらも受け付けない型もある。古い脚本スタジオの作品のパスの決まりも。
• 02 構造化ファイルの保護：拒否メッセージの読み方 AI_READONLY_FILE_TYPE、SUBSCRIPTION_REQUIRED、INVALID_PATH、FOLDER_NOT_EMPTYがそれぞれ何を意味し、次に何をすればいいのか。
• 03 ファイルによって挙動が変わるツール read_file、search_content、semantic_search、analyze_chapter、get_writing_stats、create_file、delete_fileの例外的なふるまいと、その対処。

応用：スキーマとセルフホスト

• 01 スキーマのリソースを問い合わせる MCPのリソース`slima://books/{book_token}/schema`は、読み取り専用のパスと書き込めるパスを正確に返します。AIはこれを見て、書けるかどうかを事前に判断します。
• 02 Cloudflare Workerを自分で立てる（上級） Slima MCPのサーバーはCloudflare Workerとして動いていて、ソースが公開されています。フォークして自分で動かし、OAuthを差し替えたり中継処理を足したりできます。
• 03 ガイドとライティングスキル get_capabilities、Slima自身の操作ガイド、そしてライティングスキル。Slimaが自分のルールをあなたのAIツールに渡す仕組み。
• 04 AIに関係マップを見せる view_relationship_mapは図と読める要約を返します。.mapの生のJSONを読むより速く、出会う4つの返答も載せます。

トラブルシューティング

• 01 つながらないとき：401とAuthorizationヘッダー MCPでいちばん多い接続失敗は401です。原因はトークンの期限切れ、設定の誤り、WWW-Authenticateの流れが進まないこと。切り分け方を説明します。
• 02 トークンの期限が切れた、認証をやり直したい MCPのトークンはSlimaのOAuthログインで発行され、一定期間で切れます。切れると401が返り、認証をやり直せば戻ります。気づき方と直し方を説明します。
• 03 書き込みが拒否されたとき AI_READONLY_FILE_TYPE、SUBSCRIPTION_REQUIRED、INVALID_PATH、FOLDER_NOT_EMPTYがそれぞれ何を意味するか。そして、成功したのに中身が空になるcreate_fileの一件。
• 04 上級：OAuthの流れを追う OAuthは9段階で進みます。DCR → authorize → callback → token → mcp。どこで止まっているかを`wrangler tail`やcurlで突き止める方法を説明します。