Nakama guide
Use this map when the user asks where something is in Nakama. Do not guess from other web apps.
How to answer
- Name the real path, for example Control center → AI Providers, and give the page link. In web chat, write a Markdown link with the path, for example AI Providers. It opens the page in the same tab. To point to one card on AI Providers, add its anchor:
#image-parsing,#transcription,#image-generation,#web-search, or#browser-runtime, for example Image generation model. In Telegram, Discord, or WhatsApp, write the path as plain text. - Say who can change it. If the page needs a platform admin, say that a platform admin must make the change.
- Give one or two steps, not a generic walkthrough.
- If the setting is not on this map, read the docs with
web_fetchonhttps://ahmadrosid.github.io/nakama/llms.txtbefore you answer.
Layout
- Left rail (far left): profile avatars to switch agent. At the bottom: the notifications bell and the account avatar.
- Account avatar menu (bottom left): Profile, Personalisation, Organization, Theme, Log out. It has no Settings item.
- Sidebar: organization switcher at the top, then New chat, Agent, Groups, Connections, Automations, Control center, then Recents.
- Control center (
/customize) is the hub for configuration. It groups pages into Workspace, Agent tools, Integrations, and Installed plugins.
Roles
- Platform admin: runs the Nakama install. Only role that can open AI Providers, Skills, and MCP.
- Org admin: manages one organization.
- Member and viewer: org roles with less access. Viewers cannot use Groups, Google Meet, Organization, or Browse Files.
Pages
| Page | Where | Path | What it controls | Who |
|---|---|---|---|---|
| New chat | Sidebar | /chat | Start a chat; pick agent, model, and effort in the composer | Everyone |
| Agent | Sidebar | /profiles | Agents (profiles): model, instructions, soul, assigned tools, skills, MCP servers, channels (Telegram, Discord, WhatsApp) | Everyone; editing depends on role |
| Groups | Sidebar | /groups | Group chats where agents talk to each other | Org admin, member |
| Connections | Sidebar | /connectors | Composio apps and per-user OAuth connections | Platform admin, org admin, member |
| Automations | Sidebar | /automations | Scheduled automations and their runs | Everyone |
| Control center | Sidebar | /customize | Hub for every page below | Everyone (shows only allowed pages) |
| Notifications | Bell, bottom left | /notifications | Automation runs and org memory proposals | Everyone |
Control center → Workspace
| Page | Path | What it controls | Who |
|---|---|---|---|
| Organization | /organization | Members, invites, teams, org memory, org settings | Platform admin, org admin, member |
| Browse Files | /files | Agent artifacts and workspace files | Platform admin, org admin, member |
| Usage | /customize/usage | Token usage and cost | Platform admin, org admin |
| Workers | /workers | Automation and channel workers, worker logs | Platform admin, org admin |
| Google Meet | /google-meet | Meeting capture and transcripts | Org admin, member |
| Settings | /settings | Appearance, user context, token usage in chat, version, browser sessions, MFA. Org admin: local API token. Platform admin: Web public URL, Composio, data export | Everyone (sections by role) |
Control center → Agent tools
| Page | Path | What it controls | Who |
|---|---|---|---|
| AI Providers | /customize/providers | Provider API keys and models. Cards: Image parsing model, Audio transcription model, Image generation model, web search, browser runtime | Platform admin only |
| Tools | /customize/tools | Built-in and custom tools, tool playground, email mailbox setup | Platform admin, org admin |
| Skills | /customize/skills | Organization skill catalog | Platform admin only |
| MCP | /customize/mcp | MCP servers | Platform admin only |
| Plugins | /customize/plugins | Install and manage plugins | Platform admin, org admin |
Control center → Integrations
| Page | Path | What it controls | Who |
|---|---|---|---|
| Notifications | /customize/connections/notifications | Notification delivery | Platform admin, org admin |
| Composio | /connectors | Composio toolkits | Platform admin, org admin, member |
| Coding agents | /customize/connections/coding-agents | Codex, Claude Code, OpenCode, pi, Cursor Agent setup | Platform admin, org admin |
| Error tracking | /customize/connections/error-tracking | Error tracking | Platform admin only |
Common questions
| User asks | Answer |
|---|---|
| Set the image generation model | Control center → AI Providers (/customize/providers), card Image generation model. Platform admin only. The agent also needs the generate_image tool (Agent → Tools) |
| Set voice message transcription | Control center → AI Providers, card Audio transcription model. Platform admin only |
| Let a text-only model read images | Control center → AI Providers, card Image parsing model. Platform admin only |
| Add or fix an API key, reconnect ChatGPT or Grok | Control center → AI Providers. Platform admin only |
| Change an agent's model, tools, or skills | Agent (/profiles), pick the agent |
| Connect Telegram, Discord, or WhatsApp | Agent (/profiles), pick the agent, open its channels |
| Invite a teammate | Control center → Organization (/organization) |
| Change the theme | Account avatar menu → Theme, or Settings (/settings) |


