Quick Start

Start by saving one useful piece of knowledge and retrieving it with your AI. You will have a real file in your vault, a working connection, and a simple way to continue the same work from another device or agent.

You do not need to design a folder system before starting. Pick a current project, a useful answer, or a note you want to remember.

1. Connect an agent or open MindWiki

If you are starting from an AI platform, use its supported connector or MCP installation flow. The connection method differs between browser apps, desktop apps, and coding tools, so begin with your platform's guide in Agents Overview.

The remote MCP endpoint is:

text
https://api.mindwiki.io/mcp

A supported client opens MindWiki's authorization page, where you review the requesting client and permissions.

  • New to MindWiki: choose the name for your MindWiki capture email, create your account, and save the generated access key before continuing.
  • Already have an account: choose the existing-account option and sign in using your supported method. Authorizing another platform keeps your existing vault and capture address.
  • Already signed in: check that the selected account is the one you want, then review and approve the request.

The generated access key is your reusable sign-in credential. Save it privately. Do not put it into an AI conversation. Read Access Keys for sign-in and recovery guidance.

You can also start in MindWiki Cloud, create or open your account there, and connect an agent afterward.

2. Save something worth keeping

Choose one method:

  • From a connected agent: ask it to capture a concise summary of the work you want to keep.
  • On the web: use Quick Capture on your account dashboard.
  • On Mac: create a page with Cmd+N and write directly in the editor.
  • By email: send a note or forward a message to your personal MindWiki capture address, shown in your account.

For an agent, try:

text
Save a note to my MindWiki capture inbox titled “Website Launch Brief.” Include our goal, the audience, the decisions made so far, and the next three steps. Tell me where you saved it.

Use your actual project and details. An agent needs capture or write permission to save content.

3. Open the saved page yourself

Open your vault in MindWiki and look in capture/. Confirm that the note contains the information you intended to keep.

This is your first useful checkpoint: the result exists as a page you can inspect and edit outside the chat.

If you wrote the note yourself, wait for it to save before trying to retrieve it from another client. On the web, auto-save runs after three seconds of inactivity; Cmd+S requests an immediate save.

4. Ask your agent to retrieve it

Try a request that requires a real vault read:

text
Search my MindWiki for “Website Launch Brief.” Read the page and summarize the next steps. Include the page title or path you used.

Check the named source against the page you opened. If you authorized read-only access, this retrieval test is sufficient to verify that capability; a read-only connection is not expected to save new notes.

5. Continue from another surface

Open the same account in the Mac app, iPhone app, or web app. On Mac, follow the app's vault setup to choose the local folder for your synced files.

To add another agent, follow that platform's connection guide and use your existing MindWiki account on the authorization page. Ask the second agent to retrieve the same brief. You are reusing shared project knowledge without copying it into another chat yourself.

6. Add one useful connection

Create a project page and link to your brief:

markdown
# Website Launch

## Starting point
[[Website Launch Brief]]

## Next steps
- [ ] Confirm the audience
- [ ] Draft the homepage
- [ ] Review the launch checklist

Type [[ in the editor to select an existing page with autocomplete. Add folders or metadata when they help your next task.

If something does not work

What you seeWhat to check
No MindWiki tools in the agentFinish installation and authorization in the host's connector controls.
Search cannot find your new noteConfirm the page saved, check the account, and search its exact title or read its known path.
Reading works but saving failsReview the granted scope and vault permissions.
A page is missing on another deviceConfirm the same account, connectivity, and save/sync status.
A write times outCheck whether the page already exists before asking for another write.

Make this a repeatable habit

At the start of a session, ask your agent to retrieve the current brief. At the end, save the decision, supporting evidence, unresolved questions, and next action. The next session starts from a maintained project record rather than your memory of the last chat. See Shared Agent Memory for a reusable handoff template.

Next: Capture Methods, The Editor, and Context Packs.