Replit Docs

Replit MCP 서버는 현재 베타 버전입니다. 도구와 동작이 변경될 수 있습니다.

Replit의 MCP 서버를 통해 외부 클라이언트는 Model Context Protocol을 사용하여 Replit에서 풀스택 애플리케이션을 생성, 업데이트, 관리할 수 있습니다. Replit Agent로 구동되며, 자연어 프롬프트를 실제 배포된 앱으로 변환합니다. 이 페이지는 자체 MCP 클라이언트를 연결하기 위한 개발자 참조 문서입니다. 이미 사용 중인 도구에서 Replit을 사용하려면 Claude에서 Replit, Slack에서 Replit, 또는 ChatGPT에서 Replit을 참조하세요.

서버 정보

속성	값
URL	`https://replit-mcp.com/server/mcp`
전송	Streamable HTTP
인증	OAuth 2.0 (MCP 클라이언트와 SDK가 자동으로 처리)

요구 사항

개발자의 경우:

Streamable HTTP 전송을 지원하는 MCP 클라이언트 또는 SDK

빌더(최종 사용자)의 경우:

Replit 계정(무료, Core, Pro 또는 Enterprise)

인증

서버는 PKCE를 사용하는 OAuth 2.1을 사용합니다. Claude Code와 같은 MCP 클라이언트는 전체 흐름을 자동으로 처리합니다. MCP 클라이언트 SDK로 개발하는 경우, discovery, 동적 클라이언트 등록, PKCE, 토큰 교환을 SDK가 처리하며 — UX(브라우저 리디렉션, 콜백 핸들러, 토큰 저장)만 제공하면 됩니다. 자세한 내용은 MCP 인증 사양을 참조하세요.

연결하기

MCP 클라이언트에서 서버 URL을 설정하세요. 빌더는 처음 연결 시 OAuth 동의 흐름을 완료합니다. MCP SDK (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 } // OAuthClientProvider 인터페이스 구현
);

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

자세한 내용은 MCP TypeScript SDK 문서를 참조하세요. SDK가 내부 OAuth 흐름을 자동으로 처리합니다. Claude Code:

Claude Code

claude mcp add --transport http replit https://replit-mcp.com/server/mcp

도구

서버는 세 가지 공개 도구를 제공합니다.

`create_app_from_prompt`

자연어 설명으로 새 Replit 앱을 생성합니다. Replit Agent가 즉시 앱 빌드를 시작합니다.

파라미터	타입	필수	설명
`appDescription`	string	예	빌드할 앱에 대한 자연어 설명
`app_stack`	string (enum)	예	다음 중 하나: `"react_website"`, `"mobile_app"`, `"design"`, `"slides"`, `"animation"`, `"data_visualization"`, `"3d_game"`, `"document"`, `"spreadsheet"`. 대부분의 웹 앱에는 `"react_website"`를 사용하세요.
`userSpecifiedAppName`	string \| null	아니오	사용자가 지정한 앱 이름
`userQuotes`	string \| null	아니오	`appDescription`에 완전히 담기지 않은 사용자의 정확한 인용구
`attachmentSummary`	string \| null	아니오	첨부 파일의 필수 세부 정보 요약

응답:

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

Agent가 비동기적으로 앱을 빌드합니다 — 진행 상황을 추적하려면 빌더를 replUrl로 안내하세요. 이후 도구 호출에서 replId와 replUrl을 사용하세요.

`update_app_using_prompt`

기존 Replit 앱을 변경합니다. 앱 생성 후 기능 추가, 버그 수정, 반복 개선에 사용하세요.

파라미터	타입	필수	설명
`replId`	string (UUID)	예	`create_app_from_prompt`의 `replId`
`changeDescription`	string	예	적용할 변경 사항 설명
`replUrl`	string	아니오	`create_app_from_prompt`의 `replUrl`
`userQuotes`	string \| null	아니오	`changeDescription`에 담기지 않은 사용자의 정확한 인용구
`attachmentSummary`	string \| null	아니오	첨부 파일 세부 정보 요약

`ask_question`

현재 앱에 대해 Replit Agent에게 질문합니다. 토론 모드로 실행되므로 앱을 수정하지 않습니다. 빌드 상태 확인, 기술 스택 문의, 빌더의 질문 전달에 사용하세요.

파라미터	타입	필수	설명
`replId`	string (UUID)	예	`create_app_from_prompt`의 `replId`
`question`	string	예	Replit Agent에게 보낼 질문

문제 해결

오류	원인	해결 방법
`MCP error -32001: Request timed out`	도구 호출이 MCP 타임아웃 시간보다 오래 걸렸습니다. 작업은 백그라운드에서 계속 실행 중입니다.	사용자를 `replUrl`로 안내하세요. 재시도하지 마세요.
`"Replit was not able to build your Replit App."`	액세스 토큰이 MCP 서버 리소스로 범위가 지정되지 않았습니다.	인증 프로바이더 설정이 올바른지 확인하세요. 커스텀 OAuth 흐름을 구축하는 경우 `resource` 파라미터가 `https://replit-mcp.com/server/mcp`로 설정되어 있는지 확인하세요.
`"Not authenticated"`	유효한 세션 또는 토큰이 없습니다.	OAuth 흐름을 통해 재인증하세요.

Enterprise

커넥터

Warehouse Connectors

Developer Integrations

ID 및 액세스 관리

디자인 시스템 및 템플릿

엔터프라이즈 결제

Replit MCP 서버

서버 정보

요구 사항

인증

연결하기

도구

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

문제 해결

​서버 정보

​요구 사항

​인증

​연결하기

​도구

​create_app_from_prompt

​update_app_using_prompt

​ask_question

​문제 해결

서버 정보

요구 사항

인증

연결하기

도구

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

문제 해결