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.

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?»

Adiciona-o ao teu cliente

O servidor funciona sobre stdio e está publicado no npm, por isso a maioria dos clientes lança-o com npx — sem instalação global. Define a tua chave na variável de ambiente PEDRA_API_KEY dentro da configuração.

{
  "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, além de pedra_credits e pedra_feedback — vê Vídeo e Créditos.

A maioria das ferramentas de imagem recebe um imageUrl — um URL público ou um URL data:; alguns clientes MCP também permitem anexar uma imagem diretamente. Mais alguns parâmetros opcionais — o teu cliente mostra o esquema de entrada de cada ferramenta.

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.