Senso MCP for Joomla已验证已精选

什么是 Senso MCP for Joomla？

Senso MCP for Joomla 是一款 Joomla 5 和 6 扩展，可将你自己的网站变成远程 MCP 服务器，让 Claude、ChatGPT 或任意 MCP 客户端用自然语言创建、编辑、发布和整理文章、分类与标签。

服务器直接运行在 Joomla 内部，无需额外服务器，也无需 Node.js 桥接。它通过 Joomla 的 Web Services API 对外提供，使用 OAuth 2.1（或 Joomla API token）保护，且每个工具都会依据 Joomla 自身的 ACL 进行校验，因此助手只能执行所连接的 Joomla 账户被允许的操作。Senso MCP 由 Sensomedia 开发，免费包以 GPL v2+ 开源。

如何使用 Senso MCP for Joomla？

文档中的前置条件：

• Joomla 5.x 或 6.x（不支持 Joomla 3 和 4）
• PHP 8.2 或更高版本（推荐 8.3/8.4），并启用 cURL、JSON、OpenSSL 和 mbstring 扩展
• 使用有效证书的 HTTPS（OAuth 2.1 必需），并开启 URL 重写（SEF URL）

安装免费包：

1. 从 sensomcp.com 下载安装包（Downloads，Senso MCP Pack Free）。
2. 在 Joomla 中进入 System → Install → Extensions 上传安装。
3. 打开组件的 Settings 查看你的 MCP 服务器准确 URL，格式如下：

https://your-site.tld/api/index.php/v1/mcp

站点还会在 /.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server 提供 OAuth 发现文档，客户端可自动完成登录配置。传输方式为 Streamable HTTP，不使用 SSE。

Claude Desktop / claude.ai

添加一个自定义连接器（custom connector），填入站点的 MCP URL，保持默认设置并点击 Add。浏览器中会打开你 Joomla 站点上的授权页面。使用拥有你希望助手具备权限的 Joomla 账户登录，然后批准访问。Claude 只会获得访问令牌，不会拿到你的密码。

Claude Code

claude mcp add --transport http joomla https://your-site.tld/api/index.php/v1/mcp

在 Claude Code 中运行 /mcp，在浏览器中完成 OAuth 登录。如需使用 API token 无界面运行，可添加 --header "Authorization: Bearer YOUR_JOOMLA_API_TOKEN"。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "my-joomla-site": {
      "url": "https://your-site.tld/api/index.php/v1/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "my-joomla-site": {
      "type": "http",
      "url": "https://your-site.tld/api/index.php/v1/mcp"
    }
  }
}

使用 Joomla API token 的自动化

对于 n8n、Make、Zapier 或脚本，在用户资料的 API Token 选项卡中创建令牌（该账户需要 API Login 权限），并作为 Bearer 请求头发送：

{
  "mcpServers": {
    "joomla": {
      "type": "http",
      "url": "https://your-joomla-site.com/api/index.php/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_JOOMLA_API_TOKEN"
      }
    }
  }
}

令牌会跳过授权确认页面，可使用该账户 ACL 允许的所有工具。文档建议为此使用专用的最小权限账户。

Senso MCP for Joomla 的主要功能

• 以组件加插件的形式原生运行在 Joomla 5 和 6 中，无需额外托管任何东西。
• 支持带标准发现机制的 OAuth 2.1，以及用于自动化的 Joomla API token。
• 每个工具都受 Joomla ACL 权限控制，例如 core.create、core.edit 和 core.delete。
• 访问权限按客户端划分且可撤销，并提供只读模式。
• 免费包涵盖文章、分类、标签、自定义字段值、文章版本、站点信息、页面渲染和缓存。
• 付费插件增加自定义字段定义、媒体、菜单、SEO、多语言、模块、模板、扩展、用户和 YOOtheme Pro 工具。

Senso MCP for Joomla 工具

• 文章： create_article、update_article、get_article、search_articles、set_article_state（发布、取消发布、归档、移至回收站）、delete_article 和 reorder_article。创建和更新覆盖 Joomla 编辑器的所有选项卡，包括图片、日期、推荐状态、作者和元数据。
• 版本： list_article_versions、get_article_version、diff_article_versions 和 restore_article_version。
• 分类和标签： 各自提供列出、读取、创建、更新和删除工具，例如 list_categories 和 create_tag。
• 自定义字段值： list_article_fields 和 list_category_fields；字段值通过创建/更新工具的 fields 参数写入。
• 站点与系统： get_site_info、get_rendered_page（以匿名访客视角获取前台页面）和 clear_cache，安装 JCH Optimize 组件后还会提供其缓存工具。

Senso MCP for Joomla 的使用场景

• 发布内容：「在 News 分类中创建一篇名为‘Our summer opening hours’的文章并发布。」
• 批量整理：「把 2024 Promotions 分类里的文章全部归档。」
• 撤销错误编辑：「把定价文章恢复到昨天的版本。」
• 检查效果：更新后获取渲染后的前台页面，确认访客看到的内容。

Senso MCP for Joomla 常见问题排查

• 授权页面返回 401： 安全加固过度的站点可能会阻止登录流程。请确保 Users 组件的登录页可访问，以便完成 OAuth 步骤。
• /api/…/mcp 返回 403： WAF 或 ModSecurity 规则可能拦截了客户端。将 MCP 服务器路径从这些规则中排除。
• 客户端找不到认证方式： 检查 .well-known 文档是否可访问。有些服务器需要为其额外添加规则。
• 通用检查清单： 使用有效证书的 HTTPS、开启 URL 重写、启用 Senso MCP 插件。