MCP & CLI integrations
Technical documentation for accessing NovelShaft from an external AI, terminal, or script.
Choose a connection method
MCP
Use NovelShaft tools through an external AI. Initial setup is for Codex; the AI selects operations from your instructions.
In preparation — connections are not open yet.
MCP connection settingsNovelShaft CLI
Choose commands yourself from a terminal, script, or AI shell tool. Read and write JSON without registering an MCP client or using an AI.
Distribution in preparation — no public download yet.
CLI command referenceThe following shared specifications describe behavior once access is available. Changing your plan does not enable a connection that is still in preparation.
Shared operations and limits
Both clients use the same MCP server and authorize access through your NovelShaft account in the browser.
| Access scope | All works owned by the authorized account, including future works. Per-work authorization is not supported. |
|---|---|
| Supported | Read, create, and edit works, manuscripts, and reference materials. Supported account settings, usage information, and product catalog operations stay within the account's existing permissions. |
| Browser confirmation | Deleting or publishing works, creating purchase links, and submitting inquiries return a confirmation URL. The user reviews and executes the action in NovelShaft within 10 minutes. Neither client can approve it for you. |
| Excluded | NovelShaft AI generation, transcription, audio generation, report generation, and embedding regeneration. These integrations do not consume NovelShaft AI credits. External AI fees apply when you use an external AI. |
| File limits | Input files: 16 MiB. Response body: 24 MiB. Files use base64, which increases their size; client limits also apply. Retrieve larger outputs from the Web app. |
| Conflicts and retries | Edits require the current work history version. On a conflict, fetch the latest state before deciding how to edit. Reuse the same operation ID and input for a retry; do not repeat an unknown result as a new operation. |
Revoke access
In Account settings → External AI connections, revoke access for the selected app. New requests and token refreshes are rejected. Completed edits and content already sent to an external AI are not removed.