knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN
knowmindknowmind
DocumentationQuickstartIntegrationsReferenceTroubleshooting
DEEN

Tutorial

From sign-up to your first hit in ten minutes

This guide walks you through signing in, creating your first memory and connecting an AI tool. You connect Claude Code with a single command and a browser sign-in — no API token and no extra install. By the end you ask a question and get an answer drawn from your own Memory Store.

Audience
This guide is written for private users and new business customers setting up knowmind for the first time. No prior command-line or API experience is required.

Prerequisites

  • A valid email address for sign-in
  • A modern browser (current versions of Chrome, Firefox, Safari or Edge)
  • For the Claude Code integration: Claude Code installed and up to date (check: claude --version)
  • A payment method in Stripe only if you choose a paid plan from step 2 onward

Steps

  1. 1

    Create your account

    Open knowmind.de/signin and enter your email address. Within a few seconds you receive an email with a sign-in link. The link is valid for 24 hours. On the first click your account is created.

    Outcome: You land in the onboarding wizard and are asked to name your workspace.

  2. 2

    Set up your workspace

    Enter a name, for example "Personal Knowledge" or "Müller Consulting". knowmind derives a short URL slug from it. Choose your plan: the Private plan is free forever with a cap of 2,500 memories. Pro, Team and Business are billed through Stripe.

    Outcome: You arrive in the dashboard. The header reads "Welcome to your workspace" with the name you chose.

  3. 3

    Create your first memory

    In the Quick Access area click "Create memory". Enter a title and content. Anything you want to recall later is a good fit: a definition, a meeting memo, the list of people responsible for a project.

    knowmind stores the content, generates vector embeddings for semantic search and creates a node in the Knowledge Graph.

    Outcome: The new memory appears in the dashboard under "Memories". The statistics card increments by one.

  4. 4

    Search in the browser

    In the dashboard, type a question about what you just saved into the "Search in your knowledge" field. You do not need to match the words exactly — knowmind finds paraphrased hits too.

    Outcome: knowmind returns hits with score and source reference. With only one memory, that memory is at the top.

  5. 5

    Connect Claude Code

    Register knowmind with a single command. On the first call, Claude Code opens your browser, you sign in to knowmind and confirm access. You do not need to create a token or install anything else.

    bash
    claude mcp add --transport http knowmind https://knowmind.de/api/mcp/v1

    Claude Desktop, Claude.ai, ChatGPT or Cursor: add a connector with this address and sign in through the browser.

    text
    https://knowmind.de/api/mcp/v1

    Outcome: claude mcp list shows knowmind as Connected. The eleven knowmind tools are available in every Claude Code chat.

  6. 6

    Ask your first question from Claude Code

    Ask Claude Code about the content you saved in step 3. You can ask explicitly ("Look up … in knowmind") or implicitly — Claude Code usually recognises on its own when a question matches your knowmind corpus.

    Outcome: Claude Code calls knowmind_recall and answers with reference to your memory.

For automation (optional)

If you call knowmind from your own scripts or workflows, use an API token and the command line instead of the browser sign-in. API tokens are available on every plan, including the free Privat tier; this path is only needed for programmatic access, not for working in Claude, ChatGPT, Cursor and the like. In the dashboard under API Tokens create a token with scopes read and write, install the CLI and sign in:

bash
npm install -g knowmind
knowmind login --token kmt_…

Verify the result

Setup is complete when all three conditions are met:

  • The dashboard "Memories" list contains at least the entry from step 3.
  • The dashboard "Recent activity" list shows "Memory created".
  • If you completed steps 5 and 6, your AI tool answers with reference to the knowmind content, drawing on your Memory Store rather than only its general language-model knowledge.

Troubleshooting

Error messageCauseResolution
Sign-in link does not arriveMail in spam folder, your provider blocks our sender, or a typo in the address.Check your spam folder. If not there, allow mails from info@schuebeler-consulting.de in your recipient settings and try again.
Browser sign-in does not open / mcp list shows FailedOutdated Claude Code version without OAuth, or the address was entered incompletely.Update Claude Code and enter the address exactly as https://knowmind.de/api/mcp/v1. If your setup has no browser (CI/server), use the token route from the automation box above.
Tool calls time outFirst request in a cold-start situation or network latency.Retry the request. If it persists, network access to knowmind.de may be blocked — check your firewall or proxy.
Recall returns no hitsThe corpus is empty or the question is outside the stored topic area.Try keywords from the memory itself. Use knowmind stats to check how many entries the workspace contains.

Related