Skip to main content
Documentation

AI chat

What it is

The panel ships its own AI chat with the same tool catalog an external assistant gets. It's the fastest way to use MoodleMCP: nothing to install, nothing to configure, and it's the easiest place to confirm your connection works.

Open it from Chat in the sidebar.

Which Moodle identity it uses

An owner or admin picks the MCP key that powers the chat, in Organization → Moodle → AI chat identity. That key's token and roles become the chat's Moodle identity, resolved on the server for every message — the key value never reaches the browser.

This means the chat sees exactly what that key's Moodle user sees. Choose it deliberately: a manager key gives the chat site-wide reach, a teacher key keeps it to that teacher's courses.

Approving actions

Read-only discovery tools run automatically. Anything that could modify your Moodle asks for your approval first, showing the tool and its arguments before it runs. You can approve a single call, or grant an always-allow for that tool so it stops asking.

Always-allow grants are yours alone — they apply to you within this organization, so one member's convenience choice never auto-approves actions for teammates. Withdraw them at any time from the same screen.

Guardrails

LimitValue
Tool round-trips per message8
Output tokens per message4096
History sent to the modellast 40 messages
Length of one message8000 characters
Rate limit10 messages per minute, per user

The step cap is what stops a runaway loop from burning credits. Older history is truncated when it's sent to the model, but the full conversation stays in the panel.

What it costs

Chat usage is metered in credits against the model's real token consumption. Credits are held when a message starts and settled against actual usage when it finishes, so an interrupted message doesn't overcharge you.

When the chat isn't available

The chat is off unless AI is enabled for your deployment and an MCP key has been selected as the chat identity. If it's missing from the sidebar or reports it has no Moodle access, check the AI chat identity setting first.