Lolipop MCP Server

Servidor MCP remoto oficial para Lolipop Rental Server de GMO Pepabo. Administra dominios, subdominios, SSL gratuito y WordPress mediante lenguaje natural.

Documentación

Servidor MCP de Lolipop

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

El servidor oficial remoto de Model Context Protocol (MCP) para Lolipop Rental Server, un servicio de hosting web compartido operado por GMO Pepabo, Inc.

Gestiona dominios, subdominios, certificados SSL gratuitos e instalaciones de WordPress, todo mediante conversaciones en lenguaje natural con asistentes de IA.

Endpoint

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

Transporte: HTTP Streamable. Autenticación: Token de Acceso Personal (PAT) mediante el encabezado Authorization: Bearer.

Funcionalidades

  • Gestión de dominios: agregar, listar, actualizar (carpeta pública) y eliminar dominios personalizados
  • Gestión de subdominios: agregar, listar y eliminar subdominios
  • SSL: listar certificados SSL gratuitos y solicitar su emisión (Let's Encrypt)
  • WordPress: listar instalaciones y realizar una instalación con un solo clic
  • Información de la cuenta: recuperar la información de la cuenta de la clave API autenticada (plan, servidor, límite de tasa)

Precios: el acceso al servidor MCP es gratuito. Se requiere un contrato válido de Lolipop Rental Server.

Autenticación

El servidor MCP de Lolipop se autentica con un Token de Acceso Personal (PAT), emitido desde el panel de usuario de Lolipop.

  1. Inicia sesión en el panel de usuario de Lolipop y emite una clave API (PAT). Copia el token (lp_pat_...).
  2. Registra la URL del endpoint junto con el encabezado Authorization: Bearer <PAT> en tu cliente MCP (consulta el Inicio Rápido a continuación).

Los alcances se seleccionan al momento de la emisión (domains:read / domains:write / ssl:read / ssl:write / wordpress:read / wordpress:write). Las solicitudes que excedan el alcance del token devuelven 403 insufficient_scope.

Nota: claude.ai (los conectores personalizados de la aplicación web) actualmente requiere OAuth y no puede pasar un encabezado Authorization estático, por lo que no es compatible en este momento. Usa un cliente que admita encabezados personalizados (Claude Code, Cursor, Gemini CLI, OpenAI Codex) o el puente stdio mcp-remote que se muestra a continuación.

Inicio Rápido

Mantén tu PAT fuera de los archivos versionados y del historial del shell. Guárdalo en una variable de entorno (por ejemplo, LOLIPOP_PAT) y haz referencia a ella, en lugar de pegar el token sin procesar en un archivo de configuración o en una línea de comandos. Los ejemplos a continuación usan ${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}"

Documentación de MCP de Claude Code

Cursor

Agrega a .cursor/mcp.json. Cursor expande las referencias de ${env:VAR}, por lo que el token sin procesar permanece en tu entorno, no en el archivo:

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

Gemini CLI

Agrega a ~/.gemini/settings.json. Gemini CLI expande las referencias de $VAR / ${VAR} desde el entorno:

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

Consulta la documentación del servidor MCP de Gemini CLI para más detalles.

OpenAI Codex CLI

Codex admite servidores MCP remotos y puede leer el token desde una variable de entorno mediante bearer_token_env_var. Configura https://lolipop.jp/api/v1/mcp según la documentación de MCP de Codex:

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

Puente stdio local (para clientes sin soporte de encabezados personalizados)

Usa mcp-remote para conectar un cliente solo stdio al endpoint remoto. Haz referencia al token mediante una variable de entorno para que no aparezca en el archivo de configuración:

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

Documentación

Requisitos

  • Una cuenta de Lolipop Rental Server en un plan compatible
  • Un Token de Acceso Personal (PAT) emitido desde el panel de usuario
  • Un cliente compatible con MCP que admita encabezados de solicitud personalizados (Claude Code, Cursor, Gemini CLI, OpenAI Codex CLI, etc.)

Soporte

Licencia

MIT