Overview & first login
Kroov is a gateway for AI models, knowledge bases, MCP tools, agents, and automations. Most day-to-day work happens in the WebApp; integrations call the HTTP API with an API key or JWT.
Sign in
Open the WebApp (local default: https://localhost:3007). Depending on your deployment you may see:
| Mode | When it appears |
|---|---|
OAuth configured (DefaultLoginMode=Google is common) | |
| Local | Authentication:EnableLocalLogin=true (dev / testing) |
Local seeded admin (when local login is on): username admin, password admin. If email 2FA is enabled for that account, complete the code step after the password.
After a successful API login you can also land in the SPA with
/login?token=<JWT>&refreshToken=<REFRESH>.
Roles at a glance
| Role / access | Typical capabilities |
|---|---|
| Admin | Providers, knowledge bases, MCP servers, many write APIs, security status |
| Project owner / member | Project work: prompts, agents, sessions, automations (as assigned) |
| API key caller | AI query/chat and OpenAI-compatible /v1 routes for the key’s project |
What you see in the sidebar also depends on feature flags (GET /api/features): Agents, Sessions, Automations, Assistant, MCP hosting, and Documentation can be on or off per deployment.
First steps after login
- Confirm you can open Dashboard (or Assistant if Personal assistant is enabled).
- Open Projects and note the project you will use.
- Admins: configure at least one Provider with a working model.
- Try Playground for a quick chat, or call
POST /api/ai/querywith an API key.
Where to go next
- Projects & members
- Providers & API keys
- Prompts & Playground
- API: API integration guide (single-file contract) · Getting started