Lolipop MCP Server

Servidor MCP remoto oficial para Lolipop Rental Server da GMO Pepabo. Gerencie domínios, subdomínios, SSL gratuito e WordPress por meio de linguagem natural.

Documentação

Lolipop MCP Server

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

O servidor remoto oficial Model Context Protocol (MCP) para o Lolipop Rental Server — um serviço de hospedagem web compartilhada operado pela GMO Pepabo, Inc.

Gerencie domínios, subdomínios, certificados SSL gratuitos e instalações WordPress — tudo por meio de conversas em linguagem natural com assistentes de IA.

Endpoint

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

Transporte: Streamable HTTP. Autenticação: Personal Access Token (PAT) por meio do cabeçalho Authorization: Bearer.

Recursos

  • Gerenciamento de domínios — adicionar, listar, atualizar (pasta pública) e remover domínios personalizados
  • Gerenciamento de subdomínios — adicionar, listar e remover subdomínios
  • SSL — listar certificados SSL gratuitos e solicitar emissão (Let's Encrypt)
  • WordPress — listar instalações e executar uma instalação com um clique
  • Informações da conta — recuperar as informações da conta da chave de API autenticada (plano, servidor, limite de taxa)

Preços: O acesso ao servidor MCP é gratuito. É necessário um contrato válido do Lolipop Rental Server.

Autenticação

O servidor MCP da Lolipop autentica com um Personal Access Token (PAT), emitido pelo painel do usuário da Lolipop.

  1. Entre no painel do usuário da Lolipop e emita uma chave de API (PAT). Copie o token (lp_pat_...).
  2. Registre a URL do endpoint juntamente com o cabeçalho Authorization: Bearer <PAT> no seu cliente MCP (veja o Início Rápido abaixo).

Os escopos são selecionados no momento da emissão (domains:read / domains:write / ssl:read / ssl:write / wordpress:read / wordpress:write). Solicitações que excedem o escopo do token retornam 403 insufficient_scope.

Nota: o claude.ai (os conectores personalizados do aplicativo web) atualmente exige OAuth e não pode passar um cabeçalho Authorization estático, portanto não é suportado neste momento. Use um cliente que suporte cabeçalhos personalizados (Claude Code, Cursor, Gemini CLI, OpenAI Codex) ou a ponte stdio mcp-remote abaixo.

Início Rápido

Mantenha seu PAT fora de arquivos versionados e do histórico do shell. Armazene-o em uma variável de ambiente (por exemplo, LOLIPOP_PAT) e faça referência a ela, em vez de colar o token bruto em um arquivo de configuração ou linha de comando. Os exemplos abaixo usam ${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}"

Documentação MCP do Claude Code

Cursor

Adicione em .cursor/mcp.json. O Cursor expande referências ${env:VAR}, então o token bruto permanece no seu ambiente, não no arquivo:

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

Gemini CLI

Adicione em ~/.gemini/settings.json. O Gemini CLI expande referências $VAR / ${VAR} do ambiente:

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

Consulte a documentação do servidor MCP do Gemini CLI para obter detalhes.

OpenAI Codex CLI

O Codex suporta servidores MCP remotos e pode ler o token de uma variável de ambiente por meio de bearer_token_env_var. Configure https://lolipop.jp/api/v1/mcp de acordo com a documentação MCP do Codex:

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

Ponte stdio local (para clientes sem suporte a cabeçalhos personalizados)

Use mcp-remote para conectar um cliente somente stdio ao endpoint remoto. Faça referência ao token por meio de uma variável de ambiente para que ele não apareça no arquivo de configuração:

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

Documentação

Requisitos

  • Uma conta Lolipop Rental Server em um plano compatível
  • Um Personal Access Token (PAT) emitido pelo painel do usuário
  • Um cliente compatível com MCP que suporte cabeçalhos de solicitação personalizados (Claude Code, Cursor, Gemini CLI, OpenAI Codex CLI, etc.)

Suporte

Licença

MIT