Drupal AI Connect — Installation & Setup Guide

Overview

Goldnat AI Connect for Drupal (module: webmcp_connect) exposes your Drupal content to AI agents over the Servio Protocol. Five read-only tools: search nodes, get a single node, search comments, get a single comment, and identify the current user.

What you get:

• 5 free tools — getCurrentUser, searchNodes, getNode, searchComments, getComment
• Compatible with Drupal 9 and 10
• Version 1.5.0 — passes drupal-check cleanly

Note: Drupal AI Connect currently includes 5 read-only tools. Additional tools may be added in future releases.

Prerequisites

• Drupal 9.x or 10.x
• PHP 8.0 or higher
• Composer installed on the server
• Clean URLs enabled (Configuration → Search and metadata → URL aliases)
• HTTPS recommended
• “administer modules” permission

Installation

Via Composer (recommended)

composer require 'drupal/webmcp_connect:^1.5'
drush en webmcp_connect
drush cr

Manual installation

1. Download the module from Drupal.org.
2. Extract to modules/contrib/webmcp_connect/.
3. Admin → Extend → check AI Connect → Install.
4. Admin → Configuration → Web services → AI Connect — verify the manifest is reachable.

Connecting to an AI Agent

1. Go to Admin → Configuration → Web services → AI Connect → My Tokens.
2. Click Generate Prompt.
3. Copy the prompt and paste it into your agent (Claude / ChatGPT / goldnat.ai).
4. Approve OAuth PKCE in the browser.

First Test

• “Who am I on this site?” → drupal.getCurrentUser
• “Search for 5 articles about AI” → drupal.searchNodes with keyword=AI
• “Show me the comments on article #42” → drupal.searchComments + drupal.getComment

Reconnecting

Refresh tokens valid for 30 days. If expired:

1. AI Connect → My Tokens → Revoke the old one.
2. Generate Prompt again → paste into your agent.

Token Management

As on WordPress — there’s a /user/tokens page (with local_task) that shows all tokens filtered by Active/Renewable/Unused/Inactive/Revoked/All.

Uninstalling the Module

1. Revoke all tokens

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

2. Uninstall the module

drush pmu webmcp_connect
drush cr

Or via UI: Admin → Extend → Uninstall → check AI Connect → Uninstall.

3. Remove the module files

composer remove drupal/webmcp_connect

Or delete modules/contrib/webmcp_connect/ manually.

4. Clean the DB (fresh reinstall only)

DROP TABLE IF EXISTS webmcp_tokens;
DROP TABLE IF EXISTS webmcp_audit;
DELETE FROM key_value WHERE collection = 'system.schema' AND name = 'webmcp_connect';

Warning: Deletes all token history and audit logs.

Common Troubleshooting

Error	Cause	Fix
Manifest not found (404)	Clean URLs not enabled	Configuration → URL aliases → Save
Access denied	No permission to read nodes	Anonymous role isn’t enough — allow the authenticated user
Class not found	Composer autoload didn’t run	drush cr
Route not found	Stale router cache	drush router:rebuild

Support

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

Video Tutorial (Coming Soon)

3-4 minute walkthrough: (A) What is Goldnat AI Connect / Servio Protocol, (B) installing via Composer and drush, (C) connecting to an AI agent, (D) live usage.