O Servidor MCP do Replit está em beta. As ferramentas e o comportamento podem mudar.
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):
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);
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. |
{
"phase": "creating",
"replId": "d44d994b-96e1-4a1c-8085-88401b870a9a",
"turnId": "turn-id",
"replUrl": "https://replit.com/@username/App-Name",
"user": { "id": 12345, "username": "username" }
}
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. |
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. |
