Gerencie o conteúdo por um agente

O LPData expõe as operações de gerenciamento como um servidor MCP hospedado junto da API, em https://api.lpdata.io/mcp. Um agente conectado a ele cria landing pages, escreve o Documento de Conteúdo, envia arquivos e confere a leitura pública sem que você monte chamadas HTTP à mão. Não há nada para instalar: você adiciona uma URL e a sua credencial ao seu cliente MCP. Esta página é para quem desenvolve a landing page. As ferramentas são as mesmas operações descritas em Landing Pages e Assets, uma ferramenta por operação.

Adicione o servidor ao seu cliente MCP

O servidor identifica você pela mesma conta do login, enviada em dois headers: X-LPData-Email e X-LPData-Password. Grave a credencial literal, num arquivo de configuração fora do repositório. No Claude Code:

claude mcp add --transport http lpdata https://api.lpdata.io/mcp \
  -H "X-LPData-Email: <seu-email>" -H "X-LPData-Password: <sua-senha>"

claude mcp get lpdata   # deve responder ✔ Connected

Isso grava em escopo local, no ~/.claude.json. Em qualquer outro cliente, o equivalente é a mesma URL com os mesmos dois headers:

{
  "mcpServers": {
    "lpdata": {
      "type": "http",
      "url": "https://api.lpdata.io/mcp",
      "headers": {
        "X-LPData-Email": "<seu-email>",
        "X-LPData-Password": "<sua-senha>"
      }
    }
  }
}

Esse arquivo passa a conter a sua senha. Guarde-o fora do repositório e não versione.

Por que não usar `${LPDATA_EMAIL}` na configuração

Referenciar variáveis de ambiente na configuração parece mais seguro, e funciona — desde que o cliente MCP herde o ambiente do seu shell. Um cliente aberto pelo ícone do aplicativo ou por uma extensão de editor não lê o seu ~/.zshrc: a variável chega vazia e a conexão falha. O sintoma é traiçoeiro porque depende de como você abriu o programa: funciona quando você abre pelo terminal e falha quando abre pelo ícone, o que parece intermitência sem causa. Por isso a credencial literal, fora do repositório, é o caminho recomendado. A credencial diz quem está chamando: cada pessoa registra a sua e enxerga apenas as próprias Landing Pages e Assets. Não existe ferramenta de login, logout ou refresh, e nenhum token é devolvido ao agente. Peça ao agente para chamar check_connection. Ele responde com o id e o e-mail da conta, o que confirma que os headers chegaram ao servidor.

Prepare o shell antes de enviar arquivos

O envio de Assets não passa pelo MCP: get_asset_upload_command devolve um comando que o agente executa no shell dele, e esse comando lê a credencial do ambiente. É um canal separado do da configuração acima — registrar o servidor com a credencial literal resolve a conexão, mas não resolve o upload. Defina as variáveis no shell em que o agente roda comandos:

export LPDATA_EMAIL="owner@example.com"
export LPDATA_PASSWORD="<sua-senha>"
export LPDATA_URL="https://api.lpdata.io"

LPDATA_URL é opcional e assume https://api.lpdata.io quando não está definida. Confirme que as outras duas chegaram, pedindo ao agente para rodar:

printenv LPDATA_EMAIL LPDATA_PASSWORD

Com as variáveis vazias, o sign_in do comando devolve 401, o jq transforma a resposta em null e o segundo curl sai com Authorization: Bearer null, tomando outro 401. Nenhuma das mensagens aponta para o ambiente, então confira o printenv antes de suspeitar da senha ou da conta.

Ferramentas

Ferramenta	O que faz
`check_connection`	Devolve a conta autenticada. Carrega o contrato do Documento de Conteúdo na descrição
`create_landing_page`	Cria uma Landing Page com `name`, `current_data` e `allowed_hosts`
`list_landing_pages`	Lista as Landing Pages da conta, sem o `current_data`
`get_landing_page`	Devolve uma Landing Page própria, com o `current_data`
`update_landing_page`	Atualiza `name`, `current_data` ou `allowed_hosts`; o que você omite fica como está
`delete_landing_page`	Remove uma Landing Page
`get_public_content`	Lê o Documento de Conteúdo por `public_id`, cru, como a Aplicação Consumidora recebe
`list_assets`	Lista os Assets da conta com `public_url`
`get_asset_upload_command`	Monta o comando de shell que envia um arquivo
`delete_asset`	Remove um Asset

Use o id nas ferramentas de gerenciamento e o public_id em get_public_content; os dois identificadores não são intercambiáveis.

O contrato do Documento de Conteúdo

O agente recebe este contrato na descrição de check_connection, então não precisa consultar esta página para escrever um documento válido. Ele está aqui para você conferir o que o agente produziu.

current_data é um JSON não nulo; objetos e arrays aninham à vontade e podem estar vazios.
Um valor primitivo não pode aparecer solto em um objeto ou em um array. Toda folha é um Campo Editável.
Um Campo Editável é um objeto com as duas chaves value e type. Só uma delas é inválido.
string, text, url, hosted_file e external_file recebem string; number recebe número; boolean recebe true ou false.
hosted_file e external_file guardam a URL diretamente em value.
Chaves além de value e type são aceitas; é assim que o dashboard_config trafega.

{
  "hero": {
    "title": { "value": "Bem-vindo", "type": "string" },
    "cta_url": { "value": "https://exemplo.com", "type": "url" }
  },
  "features": [
    { "name": { "value": "Rápido", "type": "string" } }
  ]
}

Enviar { "features": ["Rápido"] } é recusado, porque "Rápido" é uma string solta dentro de um array:

Current data contains a value outside an editable field at $.features[0]

O servidor MCP não valida nem corrige o documento: quem recusa é a API, e o agente recebe a mensagem inteira, com o caminho do campo.

Envie um arquivo

O servidor é remoto e não lê o disco da sua máquina, então ele não transfere bytes. get_asset_upload_command devolve o comando que o agente executa no shell dele:

FILE='/caminho/do/hero.webp'

TOKEN=$(curl -s -X POST "${LPDATA_URL:-https://api.lpdata.io}/auth/sign_in" \
  -H 'Content-Type: application/json' \
  -d "{\"user\":{\"email\":\"$LPDATA_EMAIL\",\"password\":\"$LPDATA_PASSWORD\"}}" | jq -r .access_token)

curl -s -X POST "${LPDATA_URL:-https://api.lpdata.io}/assets" \
  -H "Authorization: Bearer $TOKEN" -F "asset[file]=@$FILE"

O shell é quem expande $LPDATA_EMAIL, $LPDATA_PASSWORD e $TOKEN: o agente escreve o comando, mas nunca vê a sua senha nem o token. O comando precisa do jq instalado e deve ser executado como está. Se ele responder 401, volte a preparar o shell: quase sempre é variável de ambiente vazia, não senha errada. A resposta do segundo curl traz a public_url do Asset. Use essa URL como value de um Campo Editável do tipo hosted_file.

Um fluxo completo

check_connection confirma a conta.
create_landing_page cria a página com o Documento de Conteúdo inicial e devolve o id e o public_id.
get_asset_upload_command monta o comando; o agente o executa e obtém a public_url da imagem.
update_landing_page grava o documento com a public_url em um campo hosted_file.
get_public_content lê pelo public_id e mostra exatamente o que a Aplicação Consumidora vai receber.

Lembre que current_data é sempre substituído por inteiro: para mudar um campo, o agente envia o documento completo com aquele campo alterado. O LPData não guarda histórico do documento.

Erros

O servidor repassa os erros da API sem reformular.

Situação	O que o agente recebe
Credencial ausente ou inválida	`401 Unauthorized` dizendo para conferir `X-LPData-Email` e `X-LPData-Password`
Documento fora do contrato	A lista de mensagens de validação, cada uma com o caminho do campo
`id` ou `public_id` inexistente, ou recurso de outra conta	`Landing page not found` ou `Asset not found`
Limite da leitura pública excedido	`Too many requests`, com o tempo de espera; veja Limite de leituras

Começar

Consumir conteúdo

Gerenciar conteúdo

Agentes

Referência

Servidor MCP

Gerencie o conteúdo por um agente

Adicione o servidor ao seu cliente MCP

Por que não usar `${LPDATA_EMAIL}` na configuração

Prepare o shell antes de enviar arquivos

Ferramentas

O contrato do Documento de Conteúdo

Envie um arquivo

Um fluxo completo

Erros

​Gerencie o conteúdo por um agente

​Adicione o servidor ao seu cliente MCP

​Por que não usar ${LPDATA_EMAIL} na configuração

​Prepare o shell antes de enviar arquivos

​Ferramentas

​O contrato do Documento de Conteúdo

​Envie um arquivo

​Um fluxo completo

​Erros

Gerencie o conteúdo por um agente

Adicione o servidor ao seu cliente MCP

Por que não usar `${LPDATA_EMAIL}` na configuração

Prepare o shell antes de enviar arquivos

Ferramentas

O contrato do Documento de Conteúdo

Envie um arquivo

Um fluxo completo

Erros