Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Détails du serveur

PropriétéValeur
URLhttps://replit-mcp.com/server/mcp
TransportHTTP streamable
AuthentificationOAuth 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) :
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ètreTypeRequisDescription
appDescriptionstringOuiDescription en langage naturel de l’application à construire.
app_stackstring (enum)OuiL’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.
userSpecifiedAppNamestring | nullNonNom de l’application si fourni par l’utilisateur.
userQuotesstring | nullNonCitations exactes de l’utilisateur non entièrement capturées dans appDescription.
attachmentSummarystring | nullNonRé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ètreTypeRequisDescription
replIdstring (UUID)OuiLe replId provenant de create_app_from_prompt.
changeDescriptionstringOuiDescription de la modification à effectuer.
replUrlstringNonLe replUrl provenant de create_app_from_prompt.
userQuotesstring | nullNonCitations exactes de l’utilisateur non capturées dans changeDescription.
attachmentSummarystring | nullNonRé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ètreTypeRequisDescription
replIdstring (UUID)OuiLe replId provenant de create_app_from_prompt.
questionstringOuiLa question à envoyer à Replit Agent.

​
Dépannage

ErreurCauseCorrection
MCP error -32001: Request timed outL’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.