Skip to main content
By the end you have a connected agent that can read your brain and write to it.
1

Create your workspace

Sign up at tatara.app. Signing up is free and does not need a card.On first sign-in you name your company. That creates your brain, the container for everything your company knows.
A new brain starts empty. No starter documents, folders, or tags are created for you, so the first thing in your brain will be whatever you or your agent writes. See plans for what each plan includes.
2

Add the MCP server

Tatara exposes an HTTP MCP server. Add it to your agent’s MCP configuration:
mcp-config.json
The first time your client connects, it opens a browser, asks you to sign in to Tatara, and shows a consent screen naming the client. Approving it lets that client read your documents and folders, traverse your brain’s links, and create and edit documents on your behalf.Connected clients are listed under Agent access in settings, where you can disconnect any of them later.
3

Install the agent skills

The skills teach your agent the write workflow, the document formats, and how to recover when a write is rejected. Without them an agent’s first write usually bounces off the format checks.
That installs every skill into each agent detected on your machine. To install one skill, target specific agents, or install as a plugin, see agent skills.
4

Verify, then write the first document

Ask your agent to list what is in the brain. It calls list_documents and reports what it finds. On a brand-new brain the honest answer is “nothing”, which still proves the connection works.Then ask it to write something. A new brain has no folders yet, so the agent creates one first, then files the document into it with a title, description, and tags.
Ask the agent to check the taxonomy before it writes. get_taxonomy returns the folders that actually exist, the document types already in use, and your tag registry, so the agent writes into your structure instead of inventing one.
The document appears in the web app’s sidebar, and your agent can read it back by path.
If the write comes back rejected, that is normal. The rejection says what to fix, and a capable agent will correct itself and retry.

​
Next steps

Core concepts

How documents, folders, links, and tags fit together.

The MCP server

What your agent can do against your brain.

Document formats

Ask for a board, a tracker, a table, or a saved view instead of plain prose.

Working in the app

Writing, organizing, and searching your brain by hand.