Servidor MCP

Liga a Pedra ao Claude, ChatGPT, Cursor e qualquer cliente MCP. O servidor oficial Model Context Protocol expõe uma ferramenta por cada endpoint da Pedra — home staging virtual, renovação, melhoria de imagens e vídeos para anúncios — como chamadas que esperam e devolvem o URL final do recurso.

Servidor MCP oficial

De código aberto, com licença MIT e publicado no npm como @pedra-ai/mcp. Expõe uma ferramenta por cada endpoint da API; cada ferramenta é uma única chamada que espera e devolve o(s) URL(s) final(is) do recurso — sem IDs de tarefa para consultar. Internamente é uma camada fina sobre o SDK Node da Pedra.

Usa-o no Claude (web, telemóvel e desktop)

No Claude, abre Definições → Conectores → Adicionar conector personalizado, cola o URL acima e clica em Ligar — inicias sessão na Pedra uma vez e autorizas o acesso. Sem chave API para copiar. Funciona no Claude na web, no telemóvel e no desktop, e usa os créditos da tua conta.

O que podes fazer

Depois de ligado, pede ao teu assistente em linguagem natural — escolhe a ferramenta certa e devolve o URL da imagem ou vídeo final:

«Usa a Pedra para fazer home staging virtual de https://example.com/empty-living-room.jpg como uma sala minimalista.»

«Esvazia este quarto mobilado para mostrar a divisão vazia: https://example.com/bedroom.jpg»

«Renova esta cozinha antiquada num estilo escandinavo: https://example.com/kitchen.jpg»

«Adiciona uma planta grande ao canto desta sala: https://example.com/living.jpg»

«Clareia e endireita a foto que acabei de anexar.»

«Troca o céu cinzento desta foto exterior por um azul limpo: https://example.com/facade.jpg»

«Desfoca os rostos e as matrículas nesta foto virada para a rua: https://example.com/street.jpg»

«Cria um vídeo de anúncio com estas 8 fotos, com música e a legenda '3 quartos · 2 WC'.»

«Quantos créditos da Pedra me restam?»

Trabalhar com as tuas fotos

As fotos que já estão na tua conta Pedra são a fonte mais fácil — basta pedir, p. ex. «cria um vídeo com as fotos do meu anúncio da Calle Mayor», e o assistente lista os teus projetos, lê os URLs das imagens e renderiza o vídeo. Para trazer uma foto da web, indica o seu URL e é adicionada a um projeto (o servidor descarrega-a). Para fotos novas no teu dispositivo, o assistente dá-te um link para abrir o projeto na Pedra e largá-las lá — o chat não consegue carregar ficheiros grandes diretamente.

Outros clientes e configuração local (Cursor, scripts, config do Claude Desktop)

Para o Claude, usa o conector alojado acima. Para o Cursor, scripts locais ou para editar diretamente o ficheiro de configuração do Claude Desktop, executa o pacote npm sobre stdio — lança-se com npx (sem instalação global) e lê a tua chave da variável de ambiente PEDRA_API_KEY.

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

No Claude Desktop, abre Definições → Programador → Editar configuração e adiciona a entrada pedra. No Cursor, usa ~/.cursor/mcp.json (ou .cursor/mcp.json num projeto). Reinicia o cliente depois de guardar.

Autenticação

O servidor lê a tua chave de PEDRA_API_KEY. Obtém uma registando-te em app.pedra.ai e abrindo Definições → API. Vê Autenticação para detalhes.

Ferramentas

Uma ferramenta por cada endpoint, todas devolvem URLs finais:

• pedra_furnish, pedra_empty_room, pedra_renovation, pedra_edit_via_prompt, pedra_remove_object — vê Home staging virtual.
• pedra_enhance, pedra_enhance_and_correct_perspective, pedra_sky_blue, pedra_blur — vê Melhoria de imagens.
• pedra_create_video, pedra_update_video, pedra_generate_voice_script, pedra_generate_voice, pedra_music_library, além de pedra_credits e pedra_feedback — vê Vídeo e Créditos.
• pedra_list_projects, pedra_list_project_images, pedra_create_project, pedra_add_images_to_project — explora a tua biblioteca e adiciona fotos para que qualquer ferramenta as possa usar.

A maioria das ferramentas de imagem recebe um imageUrl — um URL público, um URI data: ou um caminho absoluto para um ficheiro local (lido e incorporado automaticamente). Mais alguns parâmetros opcionais — o teu cliente mostra o esquema de entrada de cada ferramenta. Nota: uma imagem colada no chat não é enviada à ferramenta — arrasta um ficheiro ou indica o seu caminho. Todas as ferramentas de imagem e vídeo também aceitam um propertyId opcional: indica-o e o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL. Vê Propriedades.

Como funciona

Uma camada fina sobre o SDK Node da Pedra. Cada endpoint espera e devolve o(s) URL(s) final(is) na resposta — mesmo pedra_create_video, que pode demorar até ~10 minutos (a API mantém a ligação viva com um heartbeat). Os erros da API — créditos insuficientes, uma imagem inválida — voltam como erros de ferramenta MCP legíveis, não como crashes.

Código & suporte

O servidor tem licença MIT e é desenvolvido de forma aberta em github.com/pedra-ai/pedra-mcp. Sabe mais sobre o protocolo em modelcontextprotocol.io, e envia email para felix@pedra.ai para ajuda com integração, quotas mais altas ou condições enterprise.

Perguntas frequentes