Connect an AI assistant
Let Claude, ChatGPT or another assistant that speaks the Model Context Protocol (MCP) search and read what you saved in Denison. It takes a few minutes, and the assistant can only read.
The address
Every assistant needs this one address:
You need an account here first: create one or sign in. Most assistants sign you in here themselves; a few tools want a token instead, which is covered further down.
Claude
- In Claude’s connector settings, add a custom connector and paste the address above.
- Claude opens a page here asking Connect this application? Sign in if it asks, check the name and address it shows, and press Allow. To let it add notes and save links as well, tick Also let it add notes and save links first.
- Ask Claude about something you saved.
Claude Code takes a token. Make a Library read only token on
Settings → API tokens, then run this with your token in place of YOUR_TOKEN:
claude mcp add --transport http denison https://denison.app/mcp --header "Authorization: Bearer YOUR_TOKEN"
ChatGPT
- In ChatGPT’s connector settings, add a custom connector with the address above. If it asks how to sign in, choose OAuth. Whether your ChatGPT plan lets you add one is up to OpenAI.
- Approve it on the page here that opens, with Allow.
Any other assistant
An assistant or tool that speaks MCP connects one of two ways.
- It signs you in. Give it the address. It finds the sign-in by itself and registers itself, then sends you to a page here to press Allow. Nothing else to set up.
-
It takes a token. Make a Library read only token on
Settings → API tokens. Give the tool the address,
with the transport set to Streamable HTTP (or just HTTP) if it asks, and the header
Authorization: Bearer YOUR_TOKEN.
The addresses a client author needs are on the standards page.
What it can read
It sees what you see here — every item including private ones, their notes, summaries, highlights and stored text, but never screenshots or pictures. It works through these tools:
- Search the library (
search_items) - Search the library by meaning (
search_by_meaning) - Recently saved (
recent_items) - Read an item (
get_item) - Read an item’s highlights and notes (
get_highlights) - Related items (
related_items) - List tags (
list_tags) - Saved searches (
saved_search) - Add a note (
add_note) — only if you let it add - Save a link (
save_url) — only if you let it add
What it reads goes to that assistant’s company under its own terms, so connect only one you trust. When it searches with a question, Denison ranks the results by meaning the same way it does for your own searches; the privacy policy says what that sends and where.
It reads, and adds only if you let it
None of the read tools can save, change or delete anything. Their permission,
library:read, lets an assistant read your library and nothing else.
Two tools need a second permission, library:write. An assistant gets it only if
you tick Also let it add notes and save links when you connect it, or give it a
Library read and add token. With it, an assistant can add a note or save a link, at
most thirty an hour, and everything it adds is private. It still cannot change or delete
anything already there. Text on a page it reads can try to steer an assistant into saving
things, so allow this only if you want it to save for you.
Stopping it
- Open Settings → API tokens. Each assistant you connected has its own row, named after it and the address it signed in from, such as “Claude (claude.ai)”, of the kind Library read only, or Library read and add if you let it add.
- Press Revoke… on its row, then Revoke token. Its next request is refused.
- Remove the connector in the assistant as well, so it stops asking.
Connecting the same assistant again replaces its old token rather than adding a second one. To stop it adding but let it go on reading, connect it again without ticking the box.
If it doesn’t connect
- The address must end in
/mcp. - An account that is still waiting to open, or is suspended, is refused.
- A token must be Library read only or Library read and add. A Full or Save only token is refused here.
- A token you revoked stops working at once. Make a new one, or connect again.