Skip to main content

Troubleshooting AI and MCP

The AI or MCP settings are missing​

Complete these checks:

  • Make sure that XP+ is installed and active.
  • Make sure that your XP+ plan includes MCP access.
  • Make sure that the Level Up XP and XP+ versions are compatible.
  • Make sure that you are signed in as a site administrator.

For the version and plan requirements, see the administrator guide.

The assistant cannot reach the MCP server​

Confirm that the MCP URL is correct:

https://moodle.example.com/blocks/xp/mcp.php

The AI service must have access to the Moodle site over HTTPS. If the site is available only on a private network, through a VPN, or from selected IP addresses, use network configuration that the AI provider supports.

MCP access is disabled​

Ask a site administrator to set Enable MCP access to Yes in the Level Up XP AI settings. For the full procedure, see Review and configure MCP.

The authorisation request is invalid​

Ask an administrator to open Manage OAuth clients and complete these checks:

  • Make sure that the client is in the list and is enabled.
  • For ChatGPT, make sure that Allow ChatGPT connections is set to Yes.
  • For Claude, make sure that Allow Claude connections is set to Yes.
  • Make sure that a manually registered client has the exact redirect URL that the AI client requires.
  • Make sure that the client ID and client secret are correct when you use manual registration.

Automatic registration needs access to chatgpt.com or claude.ai. If the site's HTTP security settings block access, an administrator must allow the domain and delete any invalid client in Manage OAuth clients before you retry.

An OAuth route returns a not found error​

OAuth uses .well-known and other paths under blocks/xp/oauth.php/. For example:

https://moodle.example.com/blocks/xp/oauth.php/.well-known/

Web servers often block files and directories with names that start with a period. These rules can also block .well-known. Make sure that your web server allows this path and supports slash arguments. For configuration instructions, see Slash arguments.

A tool reports a permission error​

Complete these permission checks for the connected Moodle user:

  • Make sure that the user has local/xp:usemcp at the system level.
  • Make sure that the user has local/xp:usemcp in the requested context.
  • Make sure that the user has the Level Up XP permissions that the operation requires.

Most tools require block/xp:manage. Accessing reports or logs also requires the applicable report or log permission. For more information, see the permissions guide.

The assistant cannot find a course​

Complete these checks:

  • Make sure that the course name in the request is correct.
  • Make sure that the connected user can access the course.
  • Make sure that the user can manage Level Up XP in the course.
  • Make sure that local/xp:usemcp is not prohibited in the course context.

If several courses have similar names, include the course short name in the request.

Learner details, logs, or leaderboard entries are unavailable​

Ask a site administrator to select Read information and Access personal data in MCP tool permissions. The connected user must also have the Moodle permissions to view the learner, report, log, or leaderboard information.

A site administrator can intentionally block access to personal information. The administrator must confirm that the use case and AI provider are approved before granting this access.

The assistant cannot award points​

Complete these checks before you award points:

  • In MCP tool permissions, select Read information, Access personal data, and Make changes or trigger actions.
  • Make sure that the connected user has local/xp:usemcp.
  • Make sure that the connected user has the XP permissions to find the learner and award points.
  • Make sure that the learner can participate in XP in the selected context.

Before you try the action again, ask the assistant to identify the learner and describe the intended award.