Use your Cairni wikis in any AI client
Cairni exposes an MCP server, so clients like Claude, Cursor, and Codex can search, read, ask, and even compile into your wikis — your own and the ones shared with you. Connect once with OAuth, no copy-pasting tokens.
- Endpoint
- https://mcp.cairni.com/
- Transport
- Streamable HTTP
- Auth
- OAuth 2.1 · dynamic client registration · or PAT
Connect with OAuth (recommended)
The fastest way — your browser opens a consent screen and you click Allow.
Add the server
claude mcp add --transport http cairni https://mcp.cairni.com/Authorize in the browser
Done
Claude Desktop and claude.ai (Team / Enterprise): add Cairni under Settings → Connectors with the same URL — you'll get the same Allow screen.
Connect with a token
For scripts, CI, or clients without OAuth — use a personal access token (PAT).
Create a token
Add it as a header
claude mcp add --transport http cairni https://mcp.cairni.com/ \
--header "Authorization: Bearer cairni_pat_…"{
"mcpServers": {
"cairni": {
"type": "http",
"url": "https://mcp.cairni.com/",
"headers": { "Authorization": "Bearer cairni_pat_…" }
}
}
}Other clients
Cairni speaks the standard remote-MCP protocol, so any MCP-capable client connects to the same endpoint. Clients that only support local (stdio) servers can use the mcp-remote bridge, which runs the OAuth flow for you.
{
"mcpServers": {
"cairni": { "url": "https://mcp.cairni.com/" }
}
}Or open Settings → MCP → Add new server. Authorize with OAuth on first use.
codex mcp add cairni --url https://mcp.cairni.com/First-time rmcp setup: add experimental_use_rmcp_client = true under [features] in ~/.codex/config.toml, then run codex mcp login cairni.
npx -y mcp-remote https://mcp.cairni.com/For any client that only supports local (stdio) servers, register this as the command (command: npx, args: -y mcp-remote <url>). The bridge opens the OAuth consent in your browser, then relays the tools.
Tools
Every tool runs with your permissions — you only ever see your own and shared wikis.
| Tool | What it does | Scope | Cost |
|---|---|---|---|
| list_wikis | List wikis you can access | wiki:read | free |
| read_page | Read a page's Markdown | wiki:read | free |
| search | Search across your wikis | wiki:read | free |
| ask | Grounded Q&A with citations | wiki:ask | credits |
| put_page | Write a page directly (raw) | wiki:write | free |
| create_wiki | Create a new wiki | wiki:write | free |
| ingest | Hand sources to Cairni to compile | wiki:write | credits |
put_page writes Markdown your client composed — no Cairni AI runs, so it's free. ask and ingest use Cairni's LLM and draw from the wiki's workspace credits.
Scopes & security
- wiki:readRead wikis, pages, and search.
- wiki:askAsk grounded questions (uses credits).
- wiki:writeCreate wikis and edit pages.
Ready to connect?
Create a token or open Cairni to get started.