Lolipop MCP Server

Lolipop MCP サーバー

日本語版 README はこちら / 日本語版 README

Lolipop Rental Server（GMO Pepabo, Inc. が運営する共用ウェブホスティングサービス）向けの公式リモート Model Context Protocol（MCP） サーバーです。

AI アシスタントとの自然言語での会話を通じて、ドメイン、サブドメイン、無料 SSL 証明書、WordPress のインストールを管理できます。

エンドポイント

https://lolipop.jp/api/v1/mcp

トランスポート：Streamable HTTP。認証：Authorization: Bearer ヘッダーを介した Personal Access Token（PAT）。

機能

• ドメイン管理 — 独自ドメインの追加、一覧表示、更新（公開フォルダー）、削除
• サブドメイン管理 — サブドメインの追加、一覧表示、削除
• SSL — 無料 SSL 証明書の一覧表示と発行申請（Let's Encrypt）
• WordPress — インストール済み環境の一覧表示とワンクリックインストール
• アカウント情報 — 認証済み API キーのアカウント情報（プラン、サーバー、レート制限）の取得

料金：MCP サーバーへのアクセスは無料です。 有効な Lolipop Rental Server の契約が必要です。

認証

Lolipop MCP サーバーは、Lolipop のユーザーパネルから発行する Personal Access Token（PAT） で認証します。

1. Lolipop ユーザーパネルにサインインし、API キー（PAT）を発行します。トークン（lp_pat_...）をコピーします。
2. エンドポイント URL と Authorization: Bearer <PAT> ヘッダーをセットで MCP クライアントに登録します（以下のクイックスタートを参照）。

発行時にスコープ（domains:read / domains:write / ssl:read / ssl:write / wordpress:read / wordpress:write）を選択します。トークンのスコープを超えるリクエストは 403 insufficient_scope を返します。

注意： claude.ai（ウェブアプリのカスタムコネクター）は現在 OAuth を必要とし、静的な Authorization ヘッダーを渡せないため、現時点ではサポートされていません。カスタムヘッダーに対応したクライアント（Claude Code、Cursor、Gemini CLI、OpenAI Codex）、または以下の mcp-remote stdio ブリッジを使用してください。

クイックスタート

PAT をコミット対象のファイルやシェル履歴に含めないでください。 生のトークンを設定ファイルやコマンドラインに貼り付けるのではなく、環境変数（例：LOLIPOP_PAT）に保存して参照してください。以下の例では ${LOLIPOP_PAT} を使用しています。

export LOLIPOP_PAT="lp_pat_..."   # your issued token

Claude Code

claude mcp add --transport http lolipop https://lolipop.jp/api/v1/mcp \
  --header "Authorization: Bearer ${LOLIPOP_PAT}"

Claude Code MCP のドキュメント

Cursor

.cursor/mcp.json に追加します。Cursor は ${env:VAR} 形式の参照を展開するため、生のトークンをファイルではなく環境変数に保存できます。

{
  "mcpServers": {
    "lolipop": {
      "url": "https://lolipop.jp/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LOLIPOP_PAT}"
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json に追加します。Gemini CLI は環境変数の $VAR / ${VAR} 形式の参照を展開します。

{
  "mcpServers": {
    "lolipop": {
      "httpUrl": "https://lolipop.jp/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${LOLIPOP_PAT}"
      }
    }
  }
}

詳細については、Gemini CLI MCP サーバーのドキュメントを参照してください。

OpenAI Codex CLI

Codex はリモート MCP サーバーに対応しており、bearer_token_env_var を使って環境変数からトークンを読み込めます。Codex MCP のドキュメントに従って https://lolipop.jp/api/v1/mcp を設定してください。

[mcp_servers.lolipop]
url = "https://lolipop.jp/api/v1/mcp"
bearer_token_env_var = "LOLIPOP_PAT"

ローカル stdio ブリッジ（カスタムヘッダーに対応していないクライアント向け）

mcp-remote を使用して、stdio のみに対応したクライアントをリモートエンドポイントに接続します。トークンが設定ファイルに現れないよう、環境変数を介して参照してください。

{
  "mcpServers": {
    "lolipop": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://lolipop.jp/api/v1/mcp",
        "--header", "Authorization: Bearer ${LOLIPOP_PAT}"
      ]
    }
  }
}

ドキュメント

• 公式 MCP サーバーガイド（日本語）
• 公開 API リファレンス（日本語）

必要条件

• 対応プランの Lolipop Rental Server アカウント
• ユーザーパネルから発行した Personal Access Token（PAT）
• カスタムリクエストヘッダーに対応した MCP 互換クライアント（Claude Code、Cursor、Gemini CLI、OpenAI Codex CLI など）

サポート

• サービスに関するお問い合わせ：Lolipop サポート
• このリポジトリに関する問題：GitHub Issueを作成してください

ライセンス

MIT