Pedra

Servidor MCP da Pedra

Servidor oficial do Model Context Protocol para a API Pedra — use a edição de fotos imobiliárias com IA da Pedra (virtual staging, reforma, esvaziamento de ambientes, aprimoramento, substituição de céu, remoção/desfoque de objetos e vídeos de imóveis) diretamente do Claude, ChatGPT, Cursor e de qualquer outro cliente MCP.

Ele expõe uma ferramenta por endpoint da API. Cada ferramenta é uma única chamada bloqueante que retorna a(s) URL(s) final(is) do asset — não há IDs de job para consultar.

Início rápido

Você precisa de uma chave de API da Pedra — obtenha uma na sua conta Pedra. O servidor a lê da variável de ambiente PEDRA_API_KEY.

O servidor roda via stdio e é publicado no npm, então a maioria dos clientes apenas o executa com npx — sem necessidade de instalação global.

Claude Desktop (um clique)

Baixe o pedra-mcp.mcpb mais recente em Releases e clique duas vezes nele (ou arraste-o para Claude Desktop → Configurações → Extensões). O Claude instala o servidor incluído e solicita sua PEDRA_API_KEY — sem edição de JSON.

Claude Desktop (manual)

Ou adicione isto ao seu claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "pedra": {
      "command": "npx",
      "args": ["-y", "@pedra-ai/mcp"],
      "env": { "PEDRA_API_KEY": "your-api-key" }
    }
  }
}

Cursor

Em ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "pedra": {
      "command": "npx",
      "args": ["-y", "@pedra-ai/mcp"],
      "env": { "PEDRA_API_KEY": "your-api-key" }
    }
  }
}

Qualquer cliente MCP

Execute o binário diretamente com a chave no ambiente:

PEDRA_API_KEY=your-api-key npx -y @pedra-ai/mcp

Ou instale-o:

npm install -g @pedra-ai/mcp
PEDRA_API_KEY=your-api-key pedra-mcp

Smithery

Você também pode instalar e configurar a Pedra automaticamente via Smithery:

npx -y @smithery/cli install @pedra-ai/mcp --client claude

(troque claude por cursor, windsurf, etc.) O Smithery solicita sua PEDRA_API_KEY e escreve a configuração do cliente para você.

Ferramentas

Ferramenta	Endpoint	O que faz
pedra_enhance	/enhance	Melhora iluminação, cor e nitidez
pedra_enhance_and_correct_perspective	/enhance_and_correct_perspective	Aprimora e corrige a perspectiva
pedra_empty_room	/empty_room	Remove todos os móveis/objetos
pedra_furnish	/furnish	Faz virtual staging de um ambiente
pedra_renovation	/renovation	Reforma paredes, pisos e acabamentos
pedra_edit_via_prompt	/edit_via_prompt	Edita a partir de um prompt em linguagem natural
pedra_sky_blue	/sky_blue	Substitui um céu sem graça por azul claro
pedra_remove_object	/remove_object	Remove um objeto usando uma máscara
pedra_blur	/blur	Desfoca rostos, placas de veículos, etc.
pedra_create_video	/create_video	Gera um vídeo do imóvel a partir de imagens
pedra_update_video	/update_video	Edita um vídeo sem re-renderizar clipes inalterados
pedra_generate_voice_script	/generate_voice_script	Escreve um roteiro de narração a partir de fotos do imóvel
pedra_generate_voice	/generate_voice	Transforma um roteiro em faixa de áudio de narração
pedra_music_library	/music_library	Lista faixas de música de fundo + idiomas de voz
pedra_list_properties	/list_properties	Lista os imóveis da conta
pedra_list_property_images	/list_property_images	Lista as fotos de um imóvel como URLs
pedra_create_property	/create_property	Cria um imóvel
pedra_add_images_to_property	/add_images_to_property	Adiciona fotos a um imóvel por URL
pedra_credits	/credits	Lê o plano e os créditos restantes
pedra_feedback	/feedback	Avaliação positiva/negativa + possível devolução de crédito

A maioria das ferramentas de imagem aceita um imageUrl além de alguns parâmetros opcionais; consulte o schema de entrada de cada ferramenta no seu cliente MCP. O imageUrl (e o maskUrl, e cada frame de create_video) aceita qualquer um dos seguintes:

• uma URL pública de https://,
• uma URI de data:, ou
• um caminho absoluto para um arquivo de imagem local — o servidor o lê do disco e o incorpora como base64 para você, então você pode apontar uma ferramenta para um arquivo que acabou de arrastar sem precisar hospedá-lo antes (.jpg, .jpeg, .png, .webp, .gif, .bmp, .tif/.tiff, .heic/.heif, .avif; até 40 MB).

Observação: uma imagem colada no chat não é um caminho de arquivo, portanto não pode ser encaminhada para a ferramenta — arraste um arquivo ou salve a imagem colada e passe o caminho dela.

Exemplos de prompts após conectar:

"Use a Pedra para fazer virtual staging de https://example.com/empty-living-room.jpg como uma sala de estar minimalista."

"Faça virtual staging de /Users/me/Desktop/empty-living-room.jpg como uma sala de estar minimalista."

"Quantos créditos da Pedra ainda tenho?"

Como funciona

Este servidor é um wrapper fino sobre @pedra-ai/sdk, que codifica os detalhes do contrato da API:

• Síncrono por design. Cada endpoint bloqueia e retorna a(s) URL(s) final(is) no corpo da resposta. Até o pedra_create_video faz polling no lado do servidor e retorna o videoUrl finalizado inline (pode levar até ~10 minutos; a API mantém a conexão ativa com um heartbeat).
• Erros são erros de ferramenta. As respostas 4xx da API (créditos insuficientes, imagem inválida, …) retornam como erros de ferramenta do MCP com uma mensagem legível, não como falhas.

Política de Privacidade

Este servidor envia as URLs de imagem/vídeo e os parâmetros que você passa para a API Pedra para realizar a edição solicitada, autenticado com sua PEDRA_API_KEY. Ele não armazena dados por conta própria. Coleta de dados, uso, armazenamento, retenção, compartilhamento com terceiros e informações de contato são cobertos pela política de privacidade da Pedra: https://pedra.ai/privacy.

Licença

MIT © Pedra