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 トークン）で保護されます。すべてのツールは 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

カスタムコネクタを追加してサイトの 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 トークンでヘッドレス運用する場合は --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 トークンによる自動化

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 トークンに対応。
• すべてのツールは core.create、core.edit、core.delete などの Joomla ACL 権限で制御されます。
• アクセスはクライアントごとにスコープ指定・取り消しが可能で、読み取り専用モードもあります。
• 無料パックは記事、カテゴリ、タグ、カスタムフィールド値、記事バージョン、サイト情報、ページレンダリング、キャッシュをカバーします。
• 有料プラグインでカスタムフィールド定義、メディア、メニュー、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： 強く堅牢化したサイトではログインフローがブロックされることがあります。OAuth の手順を完了できるよう、Users コンポーネントのログインにアクセスできる状態にしてください。
• /api/…/mcp で 403： WAF や ModSecurity のルールがクライアントをブロックしている可能性があります。MCP サーバーのパスをそれらのルールから除外してください。
• クライアントが認証方法を見つけられない： .well-known 文書にアクセスできるか確認してください。サーバーによっては追加のルールが必要です。
• 基本チェックリスト： 有効な証明書による HTTPS、URL リライトの有効化、Senso MCP プラグインの有効化。