Moodle AI Connect — Installation & Setup Guide

Overview

Goldnat AI Connect for Moodle (local_aiconnect) turns the LMS into a Servio Protocol tool server. The basic plugin is designed for students — viewing courses and grades. A separate Teacher Pro extension (in development) will support creating assignments, enrolling users, submitting grades, and updating courses.

What you get:

• 2 free tools — getCourses, getUserProfile
• Student Pro upgrade — getCourse, getAssignments, getGrades, sendMessage
• Separate Pro extension: moodle-teacher-ai-connect (Teacher/Admin — 6 tools: enroll, createAssignment, submitGrade, updateCourse, searchUsers, getEnrollments)

Prerequisites

• Moodle 4.1+ (4.3+ recommended)
• PHP 7.4+ (8.1+ recommended)
• MySQL/MariaDB or PostgreSQL
• HTTPS required
• Site admin for installation, enrolled user for use

Installation

1. Download the plugin ZIP from your personal area at goldnat.ai (sign in → your plugins → download the latest version).
2. Site administration → Plugins → Install plugins.
3. Drag & drop the ZIP → Install plugin from ZIP file.
4. Continue → Moodle runs DB migrations automatically.
5. Save changes on the settings page that appears.
6. Verify at Site administration → Notifications that there are no errors.

Connecting to an AI Agent

1. User profile → Preferences → AI Connect Tokens (or /local/aiconnect/mytokens.php).
2. Generate Prompt → copy and paste into your agent.
3. OAuth PKCE runs → approve.

First Test

• “What courses am I enrolled in?” → moodle.getCourses
• “Who am I on the system?” → moodle.getUserProfile

With Student Pro:

• “What assignments do I have in ‘Intro to AI’?” → moodle.getAssignments
• “What are my grades in that course?” → moodle.getGrades

With Teacher Pro (future):

• “Enroll student@example.com in course 5” → moodle.enrollUser
• “Create a new assignment in course 3” → moodle.createAssignment

Reconnecting

Tokens valid for 30 days. Refresh:

1. My Tokens → Revoke the old token.
2. Generate Prompt again.

Token Management

/local/aiconnect/mytokens.php page with 6 filters and bulk actions. Tokens are tied to a specific user_id in Moodle — you can’t use one user’s token as another.

Uninstalling the Plugin

1. Revoke all tokens

• My Tokens → Revoke All — kills every active agent session immediately.

2. Uninstall via UI

• Site administration → Plugins → Plugins overview → find local_aiconnect → click Uninstall.
• Moodle will prompt to confirm dropping the DB tables → confirm.

3. Remove the files

rm -rf /path/to/moodle/local/aiconnect/

4. Purge caches

php admin/cli/purge_caches.php

Or via UI: Site administration → Development → Purge all caches.

Common Troubleshooting

Error	Cause	Fix
Plugin not compatible with Moodle version	Moodle 3.x	Upgrade to 4.1+
Manifest 404	Web services not enabled	Site admin → Advanced → Enable web services
Permission denied (Grade assignment)	User isn’t a teacher on the course	Assign the teacher role on the relevant course
Course not found (courseid=1)	Trying to use the Frontpage	Frontpage isn’t a real course — use courseid ≥ 2

Support

Need help? Contact us and we’ll get back to you.

Video Tutorial (Coming Soon)

Segments: (A) Goldnat AI Connect on the Servio Protocol, (B) installing via Site administration, (C) connecting to an AI agent, (D) student flow — my courses and grades.

What Pro adds

The free Moodle plugin gives AI agents read-only access to courses, enrolments and grades. Pro adds the teacher write tools, so an agent can enrol students, create assignments, grade submissions, and message learners.

Pro ships as a separate Moodle plugin (local_aiconnectteacher) that declares a dependency on the free local_aiconnect plugin. The core plugin loads the Pro tools only when the edition is Pro — otherwise they never appear in the manifest.

Pro tools

Tool	Scope	What it does
enrollUser	write	Enrol a user into a course (manual enrolment)
createAssignment	write	Create an assignment in a course
submitGrade	write	Submit a grade for a student’s assignment
sendMessage	write	Send an instant message to a user
updateCourse	write	Update a course’s full name or summary
searchUsers	write	Search users by name or email

Enabling Pro

1. Install the free Moodle plugin first (see the basic guide above).
2. Install the local_aiconnectteacher plugin, then run admin/cli/upgrade.php.
3. Set the edition to Pro: AICONNECT_EDITION=pro, or set the edition config for local_aiconnect to pro.
4. Purge caches and regenerate your connection prompt — the six Pro tools now appear.

Scope note

All Pro tools require the write scope. Actions still run against the token owner’s own Moodle capabilities — the scope is the ceiling, the user’s role permissions are the floor. For example, submitGrade requires the token owner to hold the grading capability in that course’s context.