Connecting an AI Assistant (MCP)
MCP — the Model Context Protocol — lets an AI assistant like Claude use Mikipage directly as a tool. Once connected, you can say "save this to Mikipage" or "refresh all my pages" in the middle of a conversation, and it happens.
This is the recommended way to use Mikipage's AI if you already pay for an assistant, because your assistant does the thinking with your existing subscription and no Mikipage AI credits are consumed. See [1] for how that compares to running AI on the website.
Setting it up
The connection URL is:
https://mikipage.com/mcp
That's all most clients need. Sign-in happens through your browser the first time the assistant connects — you'll be sent to Mikipage, asked to approve, and returned. There's no API key to generate and no token to paste or rotate.
Claude (web or desktop)
- Open Settings → Connectors.
- Choose Add custom connector.
- Name it
mikipage.com. - Remote URL:
https://mikipage.com/mcp. - Save, then click Connect and approve the sign-in when your browser opens.
Claude Code
claude mcp add --transport http mikipage https://mikipage.com/mcp
Anything else
Mikipage speaks MCP over streamable HTTP with OAuth, including dynamic client registration — so any compliant client should connect with nothing but the URL above.
What your assistant can do
Once connected, the assistant has tools for:
Notes — create, read, update, and delete notes; share a note into a group or remove it; and search notes semantically, with filters for group, date range, starred, and tags.
Pages — create, read, update, and delete pages, and search them. Crucially, it can write a page's result, which is what makes AI-side page generation possible.
Associations — reconcile which notes belong to which pages, from either direction, and mark things as matched so they stop showing up as out of date.
Everything else it needs to orient — list your groups, and read your profile, timezone, usage totals, and the page-generation guidance that keeps its output consistent with the website's.
What it deliberately can't do
- Change your account settings. It can read your profile, timezone and usage totals, but editing them is a website job.
- Manage groups or members. Creating groups and inviting people happens on the website.
- Read or write file contents. It sees attachment metadata only. File bytes would flood the conversation's context for very little benefit — describe attachments in the note text instead (see [2]).
- Post comments. Commenting is a small, in-the-moment social act that belongs on the site.
What to actually ask for
"Refresh all my pages"
The headline use. Your assistant asks Mikipage what's out of date, gets back the work to be done, and works through it: for each changed note, find the pages it now belongs to; for each page whose notes moved, find the notes; then regenerate the pages that need rewriting, with citations back to sources. It repeats until nothing is stale.
Two things worth knowing about this loop:
- It only ever adds associations, never removes them. A refresh through MCP cannot quietly drop a link between a note and a page. If you want links removed, that's a full refresh on the website (see [3]).
- It's iterative. Adding notes to a page marks that page for regeneration, so new work appears as the assistant goes. It keeps going until everything is settled — you may see it loop several times.
Add "including my groups" and it will run the same pass for each group after your personal space.
"Update this page"
Narrower and often more useful: the assistant reads one page with its linked notes, synthesizes a fresh version following that page's instructions, and writes it back with citations. Good when you've just added a few notes and want one page current.
"Save this to Mikipage"
Capture, mid-conversation. Worth knowing that creating a note this way doesn't kick off any matching — the note is saved, and it'll be picked up the next time you refresh.
"What do my notes say about…"
Your assistant can search across your whole corpus and reason over what it finds, using your notes as grounded context for whatever you're working on in that conversation.
Cost
Nothing, from Mikipage. Your assistant's own subscription pays for the model calls. This is also why MCP-driven refreshes keep working when your AI credit balance is zero.