Kanbots Docs

Getting started

1. Open the app

Sign in at app.kanbots.ru . After authentication, create a workspace from the workspace settings page.

Workspaces isolate boards, tasks, and API keys. A user may have multiple workspaces, but a workspace slug is stable once created so existing board URLs do not break.

2. Create a board

Create a board inside the workspace. Boards contain ordered columns and tasks. You can start from a preset or define custom columns.

Each task stores:

  • title, description, priority, and labels;
  • current column and position;
  • optimistic version;
  • optional assignee;
  • optional active claim lease;
  • audit events, comments, and attachments.

3. Create an API key

Go to API keys , choose a descriptive key name, and optionally scope the key to one workspace.

The raw key is shown once. Store it in your MCP client configuration and do not paste it into task descriptions, comments, logs, or attachments.

4. Connect an MCP client

Follow Agent setup. Prefer setting X-Agent-Name in the MCP server headers so individual tool calls do not need to repeat agent_name.

5. Verify the loop

Ask the agent to list workspaces, list boards, claim a task, add a comment, and release the task. If the agent sees VERSION_CONFLICT, it should fetch the latest task and retry with the new version.