Serveur MCP Replit

Le serveur MCP de Replit est en bêta. Les outils et le comportement peuvent changer.

Le serveur MCP de Replit permet aux clients externes de créer, mettre à jour et gérer des applications full-stack sur Replit en utilisant le Model Context Protocol. Alimenté par Replit Agent, il transforme les instructions en langage naturel en applications déployées et fonctionnelles. Cette page est la référence pour les développeurs qui connectent leur propre client MCP. Vous cherchez à utiliser Replit depuis un outil que vous utilisez déjà ? Consultez Replit dans Claude, Replit dans Slack ou Replit dans ChatGPT.

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, Pro 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) :

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 } // Implement the OAuthClientProvider interface
);

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

Consultez la documentation du SDK TypeScript MCP pour plus de détails. Le SDK gère le flux OAuth interne automatiquement. Claude Code :

Claude Code

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.

Réponse :

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

L’Agent construit l’application de manière asynchrone — dirigez le créateur vers l’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.

Exemples de flux de travail

Ces exemples montrent les instructions qu’un client MCP peut traduire en appels d’outils Replit. La formulation exacte est flexible.

Créer et itérer sur une application

Commencez par une instruction produit détaillée :

Créez une application conviviale sur mobile pour échanger des graines entre voisins. Incluez des annonces de graines, des demandes de collecte, des profils, et un style visuel chaleureux inspiré du jardinage. Nommez-la Seed Circle.

Votre client appelle create_app_from_prompt, qui renvoie un replId et une replUrl. Replit Agent continue de construire l’application de manière asynchrone, donc ouvrez l’URL renvoyée pour suivre la progression. Après la première construction, demandez une modification ciblée :

Ajoutez des filtres pour le type de plante et la distance de collecte. Conservez le style visuel existant et rendez les filtres faciles à utiliser sur mobile.

Votre client appelle update_app_using_prompt avec le replId d’origine. Vous pouvez continuer à envoyer des modifications pour la même application.

Poser une question sur une application sans la modifier

Utilisez ask_question lorsque vous avez besoin de contexte plutôt que d’une modification :

Quelles tables de base de données cette application utilise-t-elle, et où le flux de demande de collecte est-il implémenté ?

L’outil exécute Replit Agent en mode discussion. Il peut expliquer l’application ou signaler la progression de la construction sans modifier les fichiers.

Transférer le travail entre clients

Le replId identifie l’application à travers les appels MCP. Conservez-le avec la conversation, puis fournissez-le lorsqu’un autre client poursuit le travail. Par exemple :

Créez une application depuis Claude Code.
Ouvrez la replUrl renvoyée pour consulter la construction en direct dans Replit.
Continuez à itérer depuis un autre client MCP en utilisant le même replId.

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.

Entreprise

Connecteurs

Warehouse Connectors

Developer Integrations

Gestion des identités et des accès

Systèmes de design et modèles

Facturation entreprise

Serveur MCP Replit

Détails du serveur

Prérequis

Authentification

Connexion

Outils

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Exemples de flux de travail

Créer et itérer sur une application

Poser une question sur une application sans la modifier

Transférer le travail entre clients

Dépannage

​Détails du serveur

​Prérequis

​Authentification

​Connexion

​Outils

​create_app_from_prompt

​update_app_using_prompt

​ask_question

​Exemples de flux de travail

​Créer et itérer sur une application

​Poser une question sur une application sans la modifier

​Transférer le travail entre clients

​Dépannage

Détails du serveur

Prérequis

Authentification

Connexion

Outils

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Exemples de flux de travail

Créer et itérer sur une application

Poser une question sur une application sans la modifier

Transférer le travail entre clients

Dépannage