Before you start
You need a JotDoc account (free) and an AI client that speaks MCP. A document does not have to exist yet — the AI can create one.
1. Copy the endpoint
In the editor, open Hand off → Connect an AI app. Copy the endpoint shown there. It is the same for every account:
For one document only, use the link in that document’s Hand off menu instead. It carries its own token, so the AI can see one file and nothing else.
2. Add it to your AI app
Claude (web and desktop)
Settings → Connectors → Add custom connector, paste the endpoint as an HTTP MCP server, and save. Claude will ask you to authorize.
ChatGPT
Settings → Connectors → Advanced → add a custom connector with the endpoint, then authorize in the browser tab that opens.
Claude Code
Cursor
Add an entry to your MCP settings:
{
"mcpServers": {
"jotdoc": {
"url": "https://mcp.jotdoc.net/mcp"
}
}
} 3. Authorize once
The client opens a browser tab on JotDoc. Sign in, read what is being granted, and approve. The grant is per app, not per document, and you can revoke it later from Authorizations in the editor. Revoking removes the app’s ability to read anything; it does not touch your documents.
4. Ask for the change
One sentence is enough, as long as it names the document and the change:
The AI calls list_documents if it does not know the id, reads the latest text
with get_document, and returns a proposal. It cannot write into the body of a
document you have opened — the server refuses, whatever the client asks for.
5. Accept or reject
The proposal appears in the editor beside the paragraph it touches. Accepting applies it; rejecting leaves the text alone. The AI can read which ones you kept, so the next round does not repeat a change you already turned down.
Troubleshooting
| Symptom | What to do |
|---|---|
| The app shows no tools after connecting | Authorization did not complete. Remove the connector, add it again, and finish the browser step. |
| 401 on every call | The grant expired or was revoked. Re-authorize the app; your document is untouched. |
| 403, “document limit” | The free cloud tier holds 2 shared documents. Stop sharing an older one, or subscribe to Cloud. |
| The AI reports an old version | It is using a document link that was reset. Create a new link, or connect the account instead. |