> ## 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.

# Serveur MCP Replit

> Connectez votre client MCP à Replit pour créer, mettre à jour et gérer des applications de manière programmatique.

<Note>
  Le serveur MCP de Replit est en **bêta**. Les outils et le comportement peuvent changer.
</Note>

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](https://modelcontextprotocol.io). 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](/fr/references/platforms/claude), [Replit dans Slack](/fr/references/platforms/slack) ou [Replit dans ChatGPT](/fr/references/platforms/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](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) 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 TypeScript (MCP SDK) theme={null}
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](https://modelcontextprotocol.io/sdk/js) pour plus de détails. Le SDK gère le flux OAuth interne automatiquement.

**Claude Code :**

```bash Claude Code theme={null}
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 :**

```json theme={null}
{
  "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.              |

***

## 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.                                                                                                                                                                                    |
