ai-connect-with-webmcp
This module connects AI agents like ChatGPT to your Drupal site, allowing them to interact with content using natural language while respecting Drupal's existing user permissions. It exposes content and functionality through a secure API, enabling AI to search for nodes and comments, retrieve content, get user information, and translate text.
Overview
AI Connect is a WebMCP bridge that connects AI agents (Claude, ChatGPT, Grok, and others) to your Drupal site through a secure, standardized API. AI agents can interact with your site's content using natural language — without exposing passwords or bypassing permissions.
How It Works
The module exposes tools via a REST API. AI agents discover available tools automatically through a manifest endpoint, then call them using OAuth 2.0 Bearer tokens. Every action respects Drupal's existing permission system — the AI can only do what the authenticated user is allowed to do.
Available Tools
- drupal.searchNodes — Search published nodes by keyword, content type, or date range (includes body text)
- drupal.getNode — Retrieve a single node by ID
- drupal.searchComments — Search comments by keyword or node
- drupal.getComment — Retrieve a single comment by ID
- drupal.getCurrentUser — Get authenticated user info
- translation.getSupportedLanguages — List available languages
- translation.translate — Translate text between languages (MyMemory API or AI self-translate)
Key Features
- OAuth 2.0 + PKCE authentication (industry standard)
- Drupal role/permission integration — control access per role at Admin → People → Permissions
- Auto-registration of AI clients — no pre-configuration needed
- Configurable rate limiting (per minute and per hour)
- Public info page at /ai-connect — manifest URL, OAuth URL, and connection instructions
- One-click token generator — issues a Bearer token and a personalized prompt with step-by-step instructions for webmcp MCP clients (Claude Desktop, OpenCode) and direct HTTP agents (Kiro CLI, Cursor, etc.)
- Translation module — MyMemory API or AI self-translate, configurable in settings
- Extensible via hook_ai_connect_register_tools()
- Full token lifecycle management (refresh, revocation)
Requirements
- Drupal 9, 10, or 11
- PHP 8.0+
Documentation
Full installation guide, OAuth setup, and API reference:
https://webmcp-connect-drupal.gold-t.co.il