# Keep an index of your pages

scrap has no bookmarks feature, and doesn't need one. A bookmark list is an ordinary page of
links, tagged so you can find it, and pinned so it is a tap away from Search. Claude can build
and maintain it over MCP. This guide sets one up; the same steps make any page of links
(an index per project, say).

## 1. Make the page

Make a normal note titled *Index* (a Note is the right kind: an index is text you and Claude
both edit, so not a board, doc or todo). Group its links under headings, one `[[slug|title]]`
link per line:

```markdown
## Projects

- [[garden-plan|Garden plan]]
- [[kitchen-rebuild|Kitchen rebuild]]

## Reference

- [[wifi-and-router|Wi-Fi and router]]
```

A slug is the last part of a page's address (`/p/garden-plan` is `garden-plan`), and it never
changes when a page is retitled, so the links survive renames. Only lower-case letters, digits
and hyphens make a link: `[[Garden plan]]` stays as typed. The label after `|` is what shows.
See [](use-the-pwa.md) (Linking pages).

Tag the page `index`: tap **+ Tag** under its title. Tags are lower case, at
most 64 characters. If only this page carries the tag, a search for `tag:index` finds it at once. Use `index/projects`, `index/people` and so on for a page per topic: a search
for `tag:index` finds them all.

## 2. Reach it quickly

There are two ways, and you can use both.

### A pinned search

Run the search `tag:index` and tap the pin in the results header (**Pin search**). Or open the
Index page, tap **Share**, then **Pin to Search**, which pins the page itself and skips the
list. The pin goes on the **Pinned** page, an ordinary page of links, described in
[](make-your-own-lists.md).

**Pins do not show on launch.** The app opens on the capture screen, and pins appear only in
the Search view: tap **Search**, then tap the empty search box, and **Pinned** is listed above
Recent. So from launch, a pinned page is three taps away (**Search**, the box, the pin) and a
pinned search four (the results list the Index, which you then tap). From the Search view it is
two and three.

### A home-screen icon for the page

Open the Index page in your browser (its address is `/p/<slug>`, `/p/index` if you kept the
title) and use the browser's **Add to Home screen**, or just bookmark the address. That gives
you an icon or bookmark that points at the page, with no scrap code involved.

What is checked: the installed scrap app always starts at `/` (its manifest sets `start_url`,
`scope` and `id` to `/`), which is why it opens on capture, so the icon from
[installing scrap](use-the-pwa.md) cannot be pointed at the Index; a shortcut made from the page
is a second, separate icon. Not checked: whether your browser opens that second icon in the app
window or in a browser tab, and whether an installed scrap captures the link and opens it in the
app. Both depend on the browser and the phone; try it once and see.

## 3. Let Claude maintain it

Over [MCP](../reference/mcp.md), ask Claude in plain words: *add this page to the Index under
Projects*. It reads the page, then adds a `[[slug|title]]` line under the right heading (or
makes the heading). Claude can edit the text of a page you ask it to change with `edit_page`,
and each edit is a revision you can undo with `revert`. A server run with
`SCRAP_MCP_CONTENT_EDIT=0` cannot do this: Claude can then only append to a page it wrote
itself, so let it write the Index (*make me an Index page*) and it can append to it afterwards (an append lands at the end of the page, not under a chosen
heading, so you move the lines yourself).

To see what an index links to, and what links back, open the page and look under **Related**:
every page in the index lists the Index among its backlinks.