Servidor MCP do Replit

O Servidor MCP do Replit está em beta. As ferramentas e o comportamento podem mudar.

O servidor MCP do Replit permite que clientes externos criem, atualizem e gerenciem aplicações full-stack no Replit usando o Model Context Protocol. Alimentado pelo Replit Agent, ele transforma prompts em linguagem natural em aplicativos ativos e implantados. Esta página é a referência para desenvolvedores que desejam conectar seu próprio cliente MCP. Quer usar o Replit a partir de uma ferramenta que você já usa? Consulte Replit no Claude, Replit no Slack ou Replit no ChatGPT.

Detalhes do servidor

Propriedade	Valor
URL	`https://replit-mcp.com/server/mcp`
Transporte	HTTP com Streaming
Autenticação	OAuth 2.0 (gerenciado automaticamente por clientes e SDKs MCP)

Requisitos

Para desenvolvedores:

Um cliente ou SDK MCP que suporte transporte HTTP com Streaming

Para criadores (usuários finais):

Uma conta no Replit (Free, Core, Pro ou Enterprise)

Autenticação

O servidor usa OAuth 2.1 com PKCE. Clientes MCP como o Claude Code gerenciam todo o fluxo automaticamente. Se você estiver desenvolvendo com um SDK de cliente MCP, ele gerencia a descoberta, o registro dinâmico de cliente, PKCE e a troca de tokens — você fornece a UX (redirecionamento de navegador, manipulador de callback, armazenamento de tokens). Consulte a especificação de autorização MCP para detalhes.

Conectando

Configure a URL do servidor no seu cliente MCP. Os criadores concluirão o fluxo de consentimento OAuth na primeira conexão. MCP SDK (TypeScript):

TypeScript (MCP SDK)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://replit-mcp.com/server/mcp"),
  { authProvider: yourOAuthProvider } // Implemente a interface OAuthClientProvider
);

const client = new Client({ name: "my-client", version: "1.0.0" });
await client.connect(transport);

Consulte a documentação do MCP TypeScript SDK para detalhes. O SDK gerencia o fluxo OAuth interno automaticamente. Claude Code:

Claude Code

claude mcp add --transport http replit https://replit-mcp.com/server/mcp

Ferramentas

O servidor expõe três ferramentas públicas.

`create_app_from_prompt`

Cria um novo App do Replit a partir de uma descrição em linguagem natural. O Replit Agent começa a criar o aplicativo imediatamente.

Parâmetro	Tipo	Obrigatório	Descrição
`appDescription`	string	Sim	Descrição em linguagem natural do aplicativo a ser criado.
`app_stack`	string (enum)	Sim	Um dos seguintes: `"react_website"`, `"mobile_app"`, `"design"`, `"slides"`, `"animation"`, `"data_visualization"`, `"3d_game"`, `"document"`, `"spreadsheet"`. Use `"react_website"` para a maioria dos aplicativos web.
`userSpecifiedAppName`	string \| null	Não	Nome do aplicativo, se fornecido pelo usuário.
`userQuotes`	string \| null	Não	Citações exatas do usuário não completamente capturadas em `appDescription`.
`attachmentSummary`	string \| null	Não	Resumo dos detalhes essenciais de anexos.

Resposta:

{
  "phase": "creating",
  "replId": "d44d994b-96e1-4a1c-8085-88401b870a9a",
  "turnId": "turn-id",
  "replUrl": "https://replit.com/@username/App-Name",
  "user": { "id": 12345, "username": "username" }
}

O Agent cria o aplicativo de forma assíncrona — direcione o criador para o replUrl para acompanhar o progresso. Use replId e replUrl em chamadas subsequentes de ferramentas.

`update_app_using_prompt`

Faz alterações em um App do Replit existente. Use isso para adicionar recursos, corrigir bugs ou iterar no aplicativo após sua criação.

Parâmetro	Tipo	Obrigatório	Descrição
`replId`	string (UUID)	Sim	O `replId` de `create_app_from_prompt`.
`changeDescription`	string	Sim	Descrição da alteração a ser feita.
`replUrl`	string	Não	O `replUrl` de `create_app_from_prompt`.
`userQuotes`	string \| null	Não	Citações exatas do usuário não capturadas em `changeDescription`.
`attachmentSummary`	string \| null	Não	Resumo dos detalhes do anexo.

`ask_question`

Faz uma pergunta ao Replit Agent sobre o aplicativo atual. Funciona no modo de discussão — não modificará o aplicativo. Use para verificar o status de criação, perguntar sobre a stack tecnológica ou transmitir perguntas dos criadores.

Parâmetro	Tipo	Obrigatório	Descrição
`replId`	string (UUID)	Sim	O `replId` de `create_app_from_prompt`.
`question`	string	Sim	A pergunta a ser enviada ao Replit Agent.

Fluxos de trabalho de exemplo

Estes exemplos mostram os prompts que um cliente MCP pode traduzir em chamadas de ferramentas do Replit. A formulação exata é flexível.

Criar e iterar em um aplicativo

Comece com um prompt de produto detalhado:

Crie um aplicativo de troca de sementes para vizinhança, otimizado para dispositivos móveis. Inclua listagens de sementes, solicitações de retirada, perfis e um estilo visual caloroso, inspirado em jardins. Chame-o de Seed Circle.

Seu cliente chama create_app_from_prompt, que retorna um replId e um replUrl. O Replit Agent continua a criação de forma assíncrona, então abra a URL retornada para acompanhar o progresso. Após a primeira criação, solicite uma alteração específica:

Adicione filtros por tipo de planta e distância de retirada. Mantenha o estilo visual existente e torne os filtros fáceis de usar em dispositivos móveis.

Seu cliente chama update_app_using_prompt com o replId original. Você pode continuar enviando alterações para o mesmo aplicativo.

Perguntar sobre um aplicativo sem alterá-lo

Use ask_question quando precisar de contexto em vez de uma edição:

Quais tabelas de banco de dados esse aplicativo usa, e onde o fluxo de solicitação de retirada está implementado?

A ferramenta executa o Replit Agent no modo de discussão. Ele pode explicar o aplicativo ou relatar o progresso da criação sem modificar arquivos.

Transferir entre clientes

O replId identifica o aplicativo em todas as chamadas MCP. Armazene-o junto com a conversa e forneça-o quando outro cliente continuar o trabalho. Por exemplo:

Crie um aplicativo pelo Claude Code.
Abra o replUrl retornado para revisar a criação em tempo real no Replit.
Continue iterando a partir de outro cliente MCP usando o mesmo replId.

Solução de problemas

Erro	Causa	Solução
`MCP error -32001: Request timed out`	A chamada da ferramenta demorou mais do que a janela de timeout do MCP. A operação ainda está sendo executada em segundo plano.	Direcione o usuário para o `replUrl`. Não tente novamente.
`"Replit was not able to build your Replit App."`	O token de acesso não está com escopo definido para o recurso do servidor MCP.	Verifique se seu provedor de autenticação está configurado corretamente. Se estiver criando um fluxo OAuth personalizado, certifique-se de que o parâmetro `resource` esteja definido como `https://replit-mcp.com/server/mcp`.
`"Not authenticated"`	Nenhuma sessão ou token válido.	Autentique-se novamente pelo fluxo OAuth.

Enterprise

Conectores

Warehouse Connectors

Developer Integrations

Gestão de identidade e acesso

Sistemas de design e modelos

Faturamento empresarial

Servidor MCP do Replit

Detalhes do servidor

Requisitos

Autenticação

Conectando

Ferramentas

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Fluxos de trabalho de exemplo

Criar e iterar em um aplicativo

Perguntar sobre um aplicativo sem alterá-lo

Transferir entre clientes

Solução de problemas

​Detalhes do servidor

​Requisitos

​Autenticação

​Conectando

​Ferramentas

​create_app_from_prompt

​update_app_using_prompt

​ask_question

​Fluxos de trabalho de exemplo

​Criar e iterar em um aplicativo

​Perguntar sobre um aplicativo sem alterá-lo

​Transferir entre clientes

​Solução de problemas

Detalhes do servidor

Requisitos

Autenticação

Conectando

Ferramentas

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Fluxos de trabalho de exemplo

Criar e iterar em um aplicativo

Perguntar sobre um aplicativo sem alterá-lo

Transferir entre clientes

Solução de problemas