Troubleshooting
The most common issues and their fixes.
Connection & token
| Symptom | Fix |
|---|---|
invalidtoken | The token doesn't exist on that site, or the server started before you updated .env. Recreate the token, restart or reconnect the server. |
HTTP 403 on /webservice/rest/server.php | Web services or the REST protocol is disabled, or $CFG->wwwroot doesn't match the URL you're calling. |
| All connection attempts failed | Wrong MOODLE_URL, Moodle is down, or a firewall blocks the host. |
Server behaviour
| Symptom | Fix |
|---|---|
| Write tools missing | MOODLE_ALLOW_WRITE must be exactly true. |
| Activity creation fails | Confirm the local_mcpbridge plugin is installed and its functions are attached to your service. |
invaliddatarootpermissions | Fix moodledata ownership on the server (e.g. chown -R www-user moodledata). |
Still stuck? Open a GitHub issue.