Le serveur MCP de Replit est en bêta. Les outils et le comportement peuvent changer.
Détails du serveur
| Propriété | Valeur |
|---|
| URL | https://replit-mcp.com/server/mcp |
| Transport | HTTP streamable |
| Authentification | OAuth 2.0 (géré automatiquement par les clients et SDK MCP) |
Prérequis
Pour les développeurs :
- Un client ou SDK MCP prenant en charge le transport HTTP streamable
Pour les créateurs (utilisateurs finaux) :
- Un compte Replit (Gratuit, Core, Teams ou Enterprise)
Authentification
Le serveur utilise OAuth 2.1 avec PKCE. Les clients MCP comme Claude Code gèrent l’ensemble du flux automatiquement. Si vous construisez avec un SDK client MCP, il gère la découverte, l’enregistrement dynamique du client, PKCE et l’échange de jetons — vous fournissez l’interface utilisateur (redirection vers le navigateur, gestionnaire de callback, stockage des jetons). Consultez la spécification d’autorisation MCP pour plus de détails.
Connexion
Configurez l’URL du serveur dans votre client MCP. Les créateurs devront effectuer le flux de consentement OAuth lors de la première connexion.
SDK MCP (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 } // Implement the OAuthClientProvider interface
);
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
Outils
Le serveur expose trois outils publics.
create_app_from_prompt
Crée une nouvelle application Replit à partir d’une description en langage naturel. Replit Agent commence immédiatement à construire l’application.
| Paramètre | Type | Requis | Description |
|---|
appDescription | string | Oui | Description en langage naturel de l’application à construire. |
app_stack | string (enum) | Oui | L’une des valeurs suivantes : "react_website", "mobile_app", "design", "slides", "animation", "data_visualization", "3d_game", "document", "spreadsheet". Utilisez "react_website" pour la plupart des applications web. |
userSpecifiedAppName | string | null | Non | Nom de l’application si fourni par l’utilisateur. |
userQuotes | string | null | Non | Citations exactes de l’utilisateur non entièrement capturées dans appDescription. |
attachmentSummary | string | null | Non | Résumé des détails essentiels des pièces jointes. |
{
"phase": "creating",
"replId": "d44d994b-96e1-4a1c-8085-88401b870a9a",
"turnId": "turn-id",
"replUrl": "https://replit.com/@username/App-Name",
"user": { "id": 12345, "username": "username" }
}
replUrl pour suivre la progression. Utilisez replId et replUrl dans les appels d’outils suivants.
update_app_using_prompt
Apporte des modifications à une application Replit existante. Utilisez cet outil pour ajouter des fonctionnalités, corriger des bugs ou itérer sur l’application après sa création.
| Paramètre | Type | Requis | Description |
|---|
replId | string (UUID) | Oui | Le replId provenant de create_app_from_prompt. |
changeDescription | string | Oui | Description de la modification à effectuer. |
replUrl | string | Non | Le replUrl provenant de create_app_from_prompt. |
userQuotes | string | null | Non | Citations exactes de l’utilisateur non capturées dans changeDescription. |
attachmentSummary | string | null | Non | Résumé des détails des pièces jointes. |
ask_question
Pose une question à Replit Agent sur l’application en cours. S’exécute en mode discussion — il ne modifiera pas l’application. Utilisez cet outil pour vérifier l’état de la construction, poser des questions sur la pile technologique ou relayer les questions des créateurs.
| Paramètre | Type | Requis | Description |
|---|
replId | string (UUID) | Oui | Le replId provenant de create_app_from_prompt. |
question | string | Oui | La question à envoyer à Replit Agent. |
Dépannage
| Erreur | Cause | Correction |
|---|
MCP error -32001: Request timed out | L’appel d’outil a duré plus longtemps que la fenêtre de délai d’attente MCP. L’opération est toujours en cours en arrière-plan. | Dirigez l’utilisateur vers l’replUrl. Ne réessayez pas. |
"Replit was not able to build your Replit App." | Le jeton d’accès n’est pas limité à la ressource du serveur MCP. | Vérifiez que votre fournisseur d’authentification est configuré correctement. Si vous construisez un flux OAuth personnalisé, assurez-vous que le paramètre resource est défini sur https://replit-mcp.com/server/mcp. |
"Not authenticated" | Aucune session ou jeton valide. | Ré-authentifiez-vous via le flux OAuth. |
