> ## 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. # Replit MCP 서버 > MCP 클라이언트를 Replit에 연결하여 앱을 프로그래밍 방식으로 생성, 업데이트, 관리하세요. Replit MCP 서버는 현재 **베타** 버전입니다. 도구와 동작이 변경될 수 있습니다. Replit의 MCP 서버를 통해 외부 클라이언트는 [Model Context Protocol](https://modelcontextprotocol.io)을 사용하여 Replit에서 풀스택 애플리케이션을 생성, 업데이트, 관리할 수 있습니다. Replit Agent로 구동되며, 자연어 프롬프트를 실제 배포된 앱으로 변환합니다. 이 페이지는 자체 MCP 클라이언트를 연결하기 위한 개발자 참조 문서입니다. 이미 사용 중인 도구에서 Replit을 사용하려면 [Claude에서 Replit](/references/platforms/claude), [Slack에서 Replit](/references/platforms/slack), 또는 [ChatGPT에서 Replit](/references/platforms/chatgpt)을 참조하세요. ## 서버 정보 | 속성 | 값 | | ------- | ----------------------------------- | | **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 인증 사양](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)을 참조하세요. ### 연결하기 MCP 클라이언트에서 서버 URL을 설정하세요. 빌더는 처음 연결 시 OAuth 동의 흐름을 완료합니다. **MCP SDK (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 } // OAuthClientProvider 인터페이스 구현 ); const client = new Client({ name: "my-client", version: "1.0.0" }); await client.connect(transport); ``` 자세한 내용은 [MCP TypeScript SDK 문서](https://modelcontextprotocol.io/sdk/js)를 참조하세요. SDK가 내부 OAuth 흐름을 자동으로 처리합니다. **Claude Code:** ```bash Claude Code theme={null} 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 | 아니오 | 첨부 파일의 필수 세부 정보 요약 | **응답:** ```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" } } ``` 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 흐름을 통해 재인증하세요. |