GETTING STARTED

Agent access (MCP)

Teserra can serve your library to Claude Code, Raycast, Cursor or any MCP client, on your Mac only. Off by default. Read first, write on request, every change undoable.

Turn it on

  1. Settings → Add-ons → Agent access. Switch it on. The server listens on 127.0.0.1:8788/mcp and nowhere else.
  2. Copy the ready-made snippet for your client. For Claude Code it looks like this:
claude mcp add --transport http teserra http://127.0.0.1:8788/mcp --header "Authorization: Bearer <your token>"

The token is the same one the Chrome extension uses. Raycast and generic configurations are on the same options page.

What agents can read

Library overview, collections, tags, the items of a scope, one item's full record, its image, a contact sheet of a collection (up to 30 numbered thumbnails), search by meaning, similar items. Enough to ask “what holds my Sculpture collection together?” and get an answer with the pictures in front of the model.

What agents can change, if you let them

Behind Allow changes: add, remove, rename and merge tags; add to and remove from collections; create collections; set titles, descriptions and ratings; import a URL. Never the trash, never a deletion. Every agent action enters your undo stack: ⌘Z in Teserra takes it back.

The journal

The options page keeps the last two hundred calls: which tool, with what, when. Nothing an agent does is invisible.

Ideas. Pull a contact sheet into a design brief. Ask Cursor for the three references that fit the screen it is building. Have Claude merge duplicate tags across a thousand screenshots, then check the result in the grid.
← Finding thingsLicense and Macs →