Servidor MCP do Replicate: rode modelos no Claude, Claude Code e Cursor

Agora você pode pedir ao Claude que encontre um modelo de imagem no Replicate, rode esse modelo com o seu prompt e devolva o arquivo final sem sair do chat. Essa é justamente a ideia do servidor MCP do Replicate. Ele conecta a API HTTP do Replicate a qualquer cliente que fale o Model Context Protocol, para que Claude Desktop, Claude Code e Cursor possam pesquisar milhares de modelos e criar previsões em seu nome.

A configuração leva cerca de cinco minutos. O que atrasa as pessoas são os pequenos detalhes: qual URL colar, qual transporte escolher, onde o token vai e o que aparece na fatura depois. Abaixo você encontra os comandos exatos para cada cliente, uma lista de verificação de segurança do token, uma olhada no modo de código experimental e uma rota sem configuração para quem só quer imagens e vídeos prontos.

O que o servidor MCP do Replicate faz

O Replicate hospeda um grande catálogo de modelos de imagem, vídeo, áudio e texto por trás de uma única API. O servidor MCP oficial empacota essa API como ferramentas, para que um assistente possa chamá-la diretamente, em vez de você ficar alternando entre comandos curl e abas do navegador. De acordo com a documentação do Replicate, ele oferece todas as operações da API HTTP do Replicate: pesquisar, listar e inspecionar modelos e, depois, criar e buscar previsões.

Como um prompt vira uma previsão

Digamos que você digite: faça uma foto 16:9 de um farol ao amanhecer. O cliente encaminha sua mensagem ao modelo de linguagem, o modelo decide que precisa de uma ferramenta de imagem e chama o servidor. O servidor repassa a solicitação ao Replicate, que roda o modelo escolhido em suas GPUs e devolve uma URL de saída. A sequência costuma ser esta:

1. O assistente pesquisa um modelo que se encaixe na tarefa.
2. Ele lê as opções de entrada desse modelo, como o campo de prompt e a proporção.
3. Ele cria uma previsão com o seu prompt e as configurações.
4. Ele busca o resultado e mostra o link de saída para você.

💡 Dica: Se você já sabe qual modelo quer, cite-o no prompt. Isso pula a etapa de pesquisa e mantém os resultados repetíveis de uma sessão para outra.

O mesmo ciclo funciona para modelos de vídeo e áudio. Peça um clipe de cinco segundos e o assistente escolhe um modelo de vídeo, preenche o campo de duração e consulta o status até a execução terminar. Execuções de vídeo levam mais tempo do que as de imagem, então espere um minuto ou mais, em vez de alguns segundos.

As ferramentas que você recebe

A página MCP do Replicate indica três ferramentas, e a documentação lista as operações subjacentes:

O hardware importa porque define tanto a velocidade quanto o preço, então vale testar list_hardware antes de um lote grande.

Configuração hospedada ou local

Você pode rodar o servidor de duas formas, e a escolha define como funciona a autenticação.

Escolha o servidor hospedado, a menos que você tenha um motivo para rodar um processo na sua própria máquina. Ele elimina o arquivo de token da sua configuração e é o caminho que todos os exemplos das próximas seções usam primeiro.

⚠️ Atenção: Tutoriais antigos mandam instalar mcp-replicate. Era um experimento da comunidade, e o README diz que ele não está mais em desenvolvimento ativo. O servidor oficial o substituiu, então pule o pacote antigo.

Servidor hospedado em mcp.replicate.com

O servidor hospedado é o que o Replicate recomenda. Os clientes se conectam ao endpoint SSE, https://mcp.replicate.com/sse, e você finaliza com uma etapa de aprovação na web, onde cola um token de API do Replicate. Crie um em replicate.com/account/api-tokens antes de começar e deixe-o na área de transferência.

Servidor local com npx

A opção local roda o mesmo servidor como um processo na sua máquina. Defina REPLICATE_API_TOKEN, inicie com npx -y replicate-mcp e pare com Ctrl+C. A maioria dos clientes o inicia para você a partir de um arquivo de configuração como este:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "replicate-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "your-token-here"
      }
    }
  }
}

Copiar prompt

O VS Code com GitHub Copilot lê .vscode/mcp.json e usa um objeto servers no nível superior em vez de mcpServers, então copie o bloco e renomeie apenas esse campo. Se o servidor nunca aparecer, confira se o Node está instalado e se npx roda a partir de um terminal comum.

Conecte ao Claude Desktop

O Claude Desktop é o caminho mais rápido, porque o servidor hospedado não precisa de nenhum arquivo de configuração.

Adicione o conector personalizado

1. Abra Configurações e vá para Conectores.
2. Clique em Adicionar conector personalizado.
3. Digite a URL do servidor: https://mcp.replicate.com/sse.
4. Clique em Conectar e cole o seu token de API do Replicate.
5. Clique em Entrar e aprovar.
6. Reinicie o Claude Desktop. As ferramentas aparecem sob o ícone de controles, abaixo do campo de mensagem do chat.

Prefere o servidor local? Coloque o JSON da seção anterior em claude_desktop_config.json e reinicie o aplicativo.

Primeiro prompt para testar

Comece com algo que force o ciclo completo de pesquisar, inspecionar e rodar:

Pesquise no Replicate um modelo texto para imagem rápido e fotorrealista, mostre as opções de entrada dele e depois gere uma foto 16:9 de um farol ao amanhecer.

Variantes rápidas do FLUX, como o FLUX Schnell, são candidatas típicas para um pedido desse tipo, embora a pesquisa decida o que aparece primeiro. Se a resposta chegar como um link em vez de uma imagem na conversa, isso é normal: o servidor devolve a URL de saída, e o cliente decide como exibi-la.

Quando isso funcionar, seja específico. Diga a proporção, a lente, a direção da luz e o número de variações que você quer. Prompts vagos desperdiçam execuções, e cada execução é cobrada.

Conecte ao Claude Code

O Claude Code usa um único comando e mantém a conexão entre projetos.

Instalação com um comando

Instale a CLI se ainda não a tiver e, em seguida, adicione o servidor:

npm install -g @anthropic-ai/claude-code
claude mcp add replicate https://mcp.replicate.com/sse --transport sse --scope user

Copiar prompt

A opção --scope user guarda o servidor na sua configuração de usuário, então todo projeto que você abrir terá acesso a ele.

Autentique com /mcp

Abra o claude, digite /mcp, escolha a entrada do Replicate, e uma janela do navegador se abrirá para o mesmo fluxo de aprovação usado pelo Claude Desktop. Quando aparecer como conectado, peça uma execução em linguagem simples.

Como o Claude Code trabalha dentro do seu repositório, ele pode fazer mais do que mostrar um link. Experimente isto: Gere três opções de imagem de destaque para a página inicial e depois baixe cada saída em public/images. A etapa de download importa mais do que parece, e a seção de custos abaixo explica o motivo.

Se as ferramentas não aparecerem, rode /mcp de novo e confira a linha de status do servidor. Um servidor que aparece como desconectado normalmente precisa de uma nova autenticação, não de uma reinstalação.

Conecte ao Cursor

O Cursor lê servidores MCP a partir de um arquivo JSON, então essa configuração são algumas linhas de config.

Edite o arquivo mcp.json

Abra as Configurações do Cursor, vá para Ferramentas e integrações e clique em Novo servidor MCP. O Cursor abre ~/.cursor/mcp.json, onde você adiciona o servidor hospedado pela ponte mcp-remote:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.replicate.com/sse"]
    }
  }
}

Copiar prompt

Para um único repositório, crie .cursor/mcp.json no projeto e use o JSON do servidor local visto antes, com o seu token em env. Salve o arquivo e o servidor deve aparecer no mesmo painel de configurações, junto com as suas ferramentas.

A partir daí, o agente do Cursor pode gerar artes provisórias, fotos de produto ou ícones enquanto edita o componente que precisa deles. Esse é o verdadeiro ganho: o recurso e a mudança no código acontecem na mesma conversa.

Outros clientes que funcionam

O mesmo servidor funciona além destes três:

• Claude.ai no navegador
• Codex CLI
• Google Gemini CLI
• Windsurf
• Chorus
• VS Code com GitHub Copilot, usando .vscode/mcp.json

O padrão nunca muda: aponte o cliente para a URL hospedada ou inicie replicate-mcp localmente, e depois autentique uma vez.

Tokens, custos e modo de código

Três coisas decidem se essa configuração continua agradável: como você cuida do token, quanto custa cada execução e até onde você leva a automação.

Proteja o seu token

• Crie o token em replicate.com/account/api-tokens e trate-o como uma senha.
• Prefira o fluxo hospedado sempre que possível. O token passa pela tela de aprovação, em vez de ficar guardado em um arquivo no seu repositório.
• Com o servidor local, mantenha o token em uma variável de ambiente ou deixe o arquivo de configuração fora do controle de versão. Adicione .cursor/mcp.json ou .vscode/mcp.json a .gitignore sempre que eles contiverem um token.
• Gere um novo token imediatamente se ele aparecer em um commit, em uma captura de tela ou em um chat compartilhado.

Pelo que você paga

O servidor MCP é uma porta de entrada para a mesma API, então cada previsão é cobrada na sua conta do Replicate como qualquer outra chamada de API. O preço depende do modelo e do hardware em que ele roda, e é por isso que list_hardware e uma olhada rápida nas páginas dos modelos ajudam antes de um lote grande.

Um hábito simples mantém a fatura previsível. Faça rascunhos com um modelo rápido e barato, como o FLUX Schnell, gere quatro opções, escolha a melhor composição e rode novamente apenas esse prompt em um modelo de maior qualidade. Diga essa regra ao assistente uma vez, no começo da sessão, e ele a seguirá em todos os pedidos seguintes.

💡 Dica: As URLs de saída das previsões da API desaparecem após cerca de uma hora. Peça ao assistente para baixar ou enviar cada resultado logo, especialmente em uma sessão longa.

Modo de código em sandbox

O Replicate também traz um modo de código experimental. Em vez de chamar uma ferramenta por vez, o modelo escreve TypeScript e o executa dentro de um sandbox do Deno. Isso serve bem para tarefas que encadeiam várias previsões, como gerar seis variações e manter as duas melhores. Ele precisa do Deno instalado. Adicione-o ao Claude Code com:

claude mcp add "replicate-code-mode" --scope user --transport stdio -- npx -y replicate-mcp@alpha --tools=code

Copiar prompt

A tag @alpha indica o que esperar. Trate-o como um ambiente de testes, mantenha o servidor regular instalado ao lado dele e confira a saída antes de depender dela para trabalho de produção.

Alternativa sem configuração no PicassoIA

Se você só quer a imagem ou o clipe final, sem uma tarde inteira de configuração, o PicassoIA mantém centenas de modelos em páginas navegáveis, sem tokens para colar. Combine-o com um LLM como o Claude Sonnet 5 para rascunhar prompts e depois gere no navegador.

Como usar o PicassoIA Image

O PicassoIA Image é o modelo próprio de texto para imagem da plataforma, e é um lugar rápido para testar um prompt antes de automatizar qualquer coisa.

1. Abra a página do modelo PicassoIA Image.
2. Escreva um prompt com um sujeito, um cenário, uma direção de luz e uma lente, por exemplo um farol ao amanhecer, baixo ângulo, luz dourada suave vinda da esquerda, lente de 35mm, granulação de filme.
3. Escolha a proporção de que você precisa, como 16:9 para cabeçalhos de blog.
4. Gere, revise o resultado e ajuste um detalhe por vez.
5. Envie o melhor resultado para o PicassoIA Image Editor Pro para edições como trocar um objeto ou corrigir um detalhe.
6. Anime-o com o PicassoIA Video, que aceita texto ou imagem, ou experimente o Seedance 2.5 Lite para clipes de até 10 segundos.

💡 Dica: Mude uma variável por execução. Quando o resultado melhorar, você saberá qual edição causou a melhora.

API e MCP do PicassoIA

O PicassoIA também oferece uma API REST no estilo do Replicate, então o padrão de criar, consultar e buscar que você acabou de configurar vai parecer familiar:

• URL base: https://api.picassoia.com/v1, autenticada com um token Bearer da sua conta
• Criar uma execução: POST /v1/models/{owner}/{name}/predictions
• Consultar uma execução: GET /v1/predictions/{id}
• Cancelar uma execução: POST /v1/predictions/{id}/cancel

Quatro modelos estão disponíveis pela API e pela conexão MCP: PicassoIA Image, PicassoIA Image Editor Pro, PicassoIA Video e Seedance 2.5 Lite. Cada conta recebe 5 previsões simultâneas, compartilhadas entre os tokens e as conexões MCP, e os prompts podem ter até 4.000 caracteres. O acesso à API e ao MCP depende do seu plano, então confira a página de preços antes de construir sobre isso e leia a documentação em picassoia.com/en/api.

Crie sua primeira imagem hoje

Escolha a rota que combina com o seu dia. Se você passa a maior parte do tempo no terminal ou em um editor, conecte o servidor MCP do Replicate com o comando do seu cliente e rode o prompt do farol. Se você quer um resultado nos próximos sessenta segundos, abra o PicassoIA e teste o mesmo prompt por lá. Rode os dois, compare os resultados e fique com o que encaixa no seu fluxo de trabalho, ou use cada um para o que faz de melhor.

Três prompts para testar no PicassoIA Image, cada um curto o bastante para colar:

• Um barco de pesca ao nascer do sol, baixo ângulo, textura de madeira molhada, lente de 35mm, névoa suave, granulação de filme
• Uma prateleira de estúdio de cerâmica com luz de janela da manhã, lente de 85mm, profundidade de campo rasa
• Um ciclista atravessando uma ponte de pedra ao entardecer, vista aérea, luz quente, leve desfoque de movimento

Explore todos os modelos, de geradores de imagem e vídeo a modelos de linguagem, em picassoia.com/en/all-models, e comece a criar suas próprias imagens no PicassoIA hoje.