メインコンテンツへスキップ

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サーバーはベータ版です。ツールと動作は変更される可能性があります。
ReplitのMCPサーバーは、外部クライアントがModel Context Protocolを使用してReplit上でフルスタックアプリケーションを作成・更新・管理できるようにします。Replit Agentを活用し、自然言語プロンプトを実際に動作するデプロイ済みアプリに変換します。

サーバーの詳細

プロパティ
URLhttps://replit-mcp.com/server/mcp
トランスポートStreamable HTTP
認証OAuth 2.0(MCPクライアントとSDKが自動処理)

要件

開発者向け:
  • Streamable HTTPトランスポートをサポートするMCPクライアントまたはSDK
ビルダー(エンドユーザー)向け:
  • Replitアカウント(Free、Core、Teams、またはEnterprise)

認証

サーバーはPKCEを使用したOAuth 2.1を採用しています。Claude CodeなどのMCPクライアントは、フロー全体を自動的に処理します。MCPクライアントSDKで開発する場合、SDKがディスカバリー、動的クライアント登録、PKCE、トークン交換を処理します。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

ツール

サーバーは3つの公開ツールを提供します。

create_app_from_prompt

自然言語の説明から新しいReplitアプリを作成します。Replit Agentはすぐにアプリのビルドを開始します。
パラメーター必須説明
appDescriptionstringはいビルドするアプリの自然言語による説明。
app_stackstring (enum)はい以下のいずれか:"react_website""mobile_app""design""slides""animation""data_visualization""3d_game""document""spreadsheet"。ほとんどのWebアプリには"react_website"を使用。
userSpecifiedAppNamestring | nullいいえユーザーが指定したアプリ名。
userQuotesstring | nullいいえappDescriptionに完全に含まれていないユーザーの正確な引用。
attachmentSummarystring | 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に誘導してください。後続のツール呼び出しではreplIdreplUrlを使用します。

update_app_using_prompt

既存のReplitアプリに変更を加えます。アプリが作成された後、機能の追加、バグの修正、反復的な改善に使用します。
パラメーター必須説明
replIdstring (UUID)はいcreate_app_from_promptからのreplId
changeDescriptionstringはい行う変更の説明。
replUrlstringいいえcreate_app_from_promptからのreplUrl
userQuotesstring | nullいいえchangeDescriptionに含まれていないユーザーの正確な引用。
attachmentSummarystring | nullいいえ添付ファイルの詳細情報の要約。

ask_question

現在のアプリについてReplit Agentに質問します。ディスカッションモードで実行され、アプリを変更しません。ビルドステータスの確認、技術スタックについての質問、ビルダーの質問の中継に使用します。
パラメーター必須説明
replIdstring (UUID)はいcreate_app_from_promptからのreplId
questionstringはい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フローで再認証する。