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 your first integration with an AI tool. By the end you will ask a question from Claude Code, Claude Desktop or a comparable tool 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 or Cursor integration: Node.js 20 or newer
  • 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 fifteen minutes. 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 100 memories. Pro, Business and Business API 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

    Create an API token (for CLI and MCP)

    These steps apply from the Business API plan onward. On the Private and Pro plans you can keep working in the browser and skip the rest of this guide.

    In the dashboard go to API Tokens, click "Create new token", give it a name, choose scopes "read" and "write" and confirm. The token is displayed in clear text once — copy it immediately.

    text
    kmt_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789-AbCdEfGhIjK

    Outcome: The token is saved and listed by its prefix. The full value is visible only at this moment.

  6. 6

    Install the knowmind CLI

    Install the command line tool from the npm registry. Requires Node.js 20 or newer.

    bash
    npm install -g knowmind

    Sign in. The token is stored in ~/.knowmind/config.json with restricted file permissions.

    bash
    knowmind login --token kmt_…

    Outcome: knowmind health returns a success message with the service version.

  7. 7

    Connect Claude Code

    If you have Claude Code installed, register knowmind with a single command. The CLI starts a local MCP bridge in the background — the token stays in the CLI configuration and is not passed to Claude Code.

    bash
    claude mcp add knowmind knowmind mcp

    Alternatively, without the CLI, using HTTP transport with a bearer token:

    bash
    claude mcp add knowmind \
  --transport http \
  --url https://knowmind.de/api/mcp/v1 \
  --header "Authorization: Bearer kmt_…"

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

  8. 8

    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.

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 to 8, your AI tool answers with reference to the knowmind content — not from its general language-model knowledge.

Troubleshooting

Error messageCauseResolution
Sign-in link does not arriveMail in spam folder, your provider blocks Brevo, 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.
knowmind health: 401Token prefix missing or token revoked.The token must start with kmt_. In the dashboard under API Tokens create a new token and register it with knowmind login --token kmt_….
claude mcp list shows knowmind as Failedknowmind CLI not on PATH, token file not readable, or network blocks knowmind.de.Run knowmind health in your terminal. If that works, restart Claude Code. If not, verify the install path with which knowmind or where knowmind.
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