ai-connect-with-webmcp

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