Pedra

Pedra MCP サーバー

Pedra API用の公式Model Context Protocolサーバーです。Pedra の AI による不動産写真編集（バーチャルステージング、リノベーション、部屋の家具消し、画質向上、空の差し替え、オブジェクトの削除／ぼかし、物件動画、ホスト型 360° バーチャルツアー）を、Claude、ChatGPT、Cursor、その他の MCP クライアントから直接利用できます。

API エンドポイントごとに 1 つのツールを公開します。各写真・動画ツールは、最終アセット URL を返す単一のブロッキング呼び出しです。ポーリングするジョブ ID はありません。バーチャルツアーはバックグラウンドで作成されます。pedra_create_virtual_tour が tourId を返し、準備が整うまで pedra_get_virtual_tour をポーリングします。

クイックスタート

サーバーは、PEDRA_API_KEY 環境変数から Pedra API キーを読み込みます（Pedra アカウントの Settings にあります）。まだアカウントをお持ちでない場合は、キーを指定せずに起動してください。詳しくはまだ Pedra アカウントをお持ちでない場合をご覧ください。

サーバーは stdio 経由で実行され、npm で公開されているため、ほとんどのクライアントでは npx で起動するだけです。グローバルインストールは不要です。

Claude Desktop（ワンクリック）

Releasesから最新の pedra-mcp.mcpb をダウンロードし、ダブルクリックするか、Claude Desktop → Settings → Extensions にドラッグしてください。Claude がバンドルされたサーバーをインストールし、PEDRA_API_KEY の入力を求めます。JSON の編集は不要です。

Claude Desktop（手動）

または、claude_desktop_config.json（Settings → Developer → Edit Config）に以下を追加してください。

{
  "mcpServers": {
    "pedra": {
      "command": "npx",
      "args": ["-y", "@pedra-ai/mcp"],
      "env": { "PEDRA_API_KEY": "your-api-key" }
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に記述します。

{
  "mcpServers": {
    "pedra": {
      "command": "npx",
      "args": ["-y", "@pedra-ai/mcp"],
      "env": { "PEDRA_API_KEY": "your-api-key" }
    }
  }
}

その他の MCP クライアント

環境変数にキーを設定して、バイナリを直接実行します。

PEDRA_API_KEY=your-api-key npx -y @pedra-ai/mcp

または、インストールします。

npm install -g @pedra-ai/mcp
PEDRA_API_KEY=your-api-key pedra-mcp

Smithery

Smithery経由で Pedra を自動的にインストール、設定することもできます。

npx -y @smithery/cli install @pedra-ai/mcp --client claude

（claude を cursor、windsurf などに置き換えてください。）Smithery が PEDRA_API_KEY の入力を求め、クライアント設定を代わりに書き込みます。

まだ Pedra アカウントをお持ちでない場合

たとえば Claude Code では、PEDRA_API_KEY を指定せずにサーバーを起動します。

claude mcp add pedra -- npx -y @pedra-ai/mcp

その後、「この写真を Pedra でステージングして」のように依頼してください。キーがなくても、サーバーは 2 つのツールを追加し、残りはアシスタントが処理します。

1. メールアドレスを指定して pedra_request_access を呼び出します。Pedra から有効期限 30 分のリンクがメールで届きます。新規アカウントの場合はそこでパスワードを設定し、既存アカウントの場合は Allow をクリックします。クリックするまで何も作成されず、リクエストを拒否することもできます。
2. 確認が完了するまで pedra_check_access を呼び出します。承認されると、セッション中はすべての Pedra ツールを利用できます。キーはメモリ内にのみ保持され、ディスクには書き込まれません。ツールの結果にはキーとその保存方法が表示されます。サーバーの env に PEDRA_API_KEY として追加します（例：claude mcp add pedra -e PEDRA_API_KEY=<key> -- npx -y @pedra-ai/mcp）。または Claude Desktop の拡張機能の設定に貼り付けます。

その間、ほかのツールは「No API key yet: call pedra_request_access with the user's email」と応答します。メールの受信箱での確認が必要です。一時利用のメールドメインは拒否され、リクエストにはレート制限が適用されます。新規アカウントには Pedra の無料トライアルクレジットが付与されます。

（ChatGPT と claude.ai では、代わりに Pedra のホスト型コネクターを使用してください。接続するとサインインが実行され、新規ユーザーはそこでアカウントを作成できます。）

ツール

9 つの画像編集ツール（enhance から blur まで）は propertyId も受け付けます。結果をその物件のギャラリーに保存でき、name を指定すると、同じ呼び出しで元の写真をその名前で保存できます。その場合、結果には元画像の source（imageId、name）が含まれます。preserveAspectRatio を指定すると、入力と正確に同じサイズで結果が返されます。

ツール	エンドポイント	機能
pedra_enhance	/enhance	照明、色、シャープネスを改善します
pedra_enhance_and_correct_perspective	/enhance_and_correct_perspective	画像を補正し、遠近感をまっすぐにします
pedra_empty_room	/empty_room	家具や物をすべて取り除きます
pedra_furnish	/furnish	部屋を仮想的にホームステージングします
pedra_renovation	/renovation	壁、床、仕上げをリノベーションします
pedra_edit_via_prompt	/edit_via_prompt	自然言語のプロンプトで編集します
pedra_sky_blue	/sky_blue	曇った空を澄んだ青空に置き換えます
pedra_remove_object	/remove_object	マスクを使って物を取り除きます
pedra_blur	/blur	顔、ナンバープレートなどをぼかします
pedra_create_video	/create_video	画像から物件の動画をレンダリングします
pedra_update_video	/update_video	変更のないクリップを再レンダリングせずに動画を編集します
pedra_generate_voice_script	/generate_voice_script	物件の写真からナレーション原稿を作成します
pedra_generate_voice	/generate_voice	原稿をナレーション音声トラックに変換します
pedra_music_library	/music_library	BGM トラック、音声の言語、ナレーション音声を一覧表示します
pedra_list_properties	/list_properties	アカウントの物件を一覧表示します
pedra_list_property_images	/list_property_images	物件の写真を URL として一覧表示します（type: "360" を指定すると、360°写真を一覧表示します）
pedra_create_property	/create_property	物件を作成します
pedra_add_images_to_property	/add_images_to_property	URL で写真を物件に追加します（type: "360" を指定すると、360°写真を追加します）。必要に応じて names も指定できます
pedra_add_local_panoramas	/add_images_to_property (batched)	ローカルのみ： このコンピューターから 360°写真ファイルを物件にアップロードします
pedra_create_upload_link	/create_upload_link	ログイン不要のページを作成し、スマートフォンまたはコンピューターから写真や 360°写真をアップロードできます（ツアーのみ、type: "360" を指定）
pedra_create_virtual_tour	/create_virtual_tour	ホストされた 360°バーチャルツアーを作成します（AI が部屋の名前を付け、リンクします）
pedra_get_virtual_tour	/get_virtual_tour	ツアーのステータス、共有リンク、埋め込みコード、シーン、リンクを取得します
pedra_list_virtual_tours	/list_virtual_tours	アカウントのバーチャルツアーを一覧表示します
pedra_update_virtual_tour	/update_virtual_tour	名前の変更、並べ替え、部屋の削除、リンクの再設定、スタイルの変更を行います（無料）
pedra_add_virtual_tour_scenes	/add_virtual_tour_scenes	ツアーの最後に部屋を追加します
pedra_credits	/credits	プランと残りのクレジットを確認します
pedra_feedback	/feedback	高評価／低評価と、任意のクレジット返還を送信します
pedra_request_access	/agent_signup	API キーがない場合のみ： アカウントを作成／許可するためのリンクをユーザーにメールで送信します
pedra_check_access	/agent_signup_status	API キーがない場合のみ： リクエストを確認します。承認されると、そのセッションですべてのツールを使用できます

ほとんどの画像ツールは imageUrl といくつかの任意パラメーターを受け付けます。各ツールの入力スキーマは、お使いの MCP クライアントで確認してください。imageUrl（および maskUrl、create_video の各フレーム）には、次のいずれかを指定できます。

• 公開された https:// URL、
• data: URI、または
• ローカル画像ファイルの絶対パス — サーバーがディスクから読み込み、Base64 としてインライン化するため、事前にホスティングしなくても、取り込んだばかりのファイルをツールに指定できます（.jpg、.jpeg、.png、.webp、.gif、.bmp、.tif/.tiff、.heic/.heif、.avif。最大 40 MB）。

注：チャットに貼り付けた画像はファイルパスではないため、ツールに渡せません。ファイルをドラッグするか、貼り付けた画像を保存して、そのパスを渡してください。ユーザーのスマートフォンにある写真は pedra_create_upload_link を使用します。ログイン不要のページにアップロードし（最大100ファイル、24時間有効）、その後 pedra_list_property_images が返すURLを使って編集するか、pedra_create_video または pedra_create_virtual_tour を使用します。

アップロード数には1日あたりの上限があります。無料プランでは画像30枚、有料プランでは500枚です（UTCの午前0時にリセット）。アプリ外から保存した画像（pedra_add_images_to_property、pedra_add_local_panoramas、ツアー内のURLシーン、アップロードリンク経由のファイル）はすべてカウントされます。上限を超えると呼び出しは HTTP 429, upload_limit エラーで失敗し、何も保存されません。アップロードリンクの上限は、無料プランでは1日5件、有料プランでは50件です（upload_link_limit）。

接続後のプロンプト例：

「Pedraを使って、https://example.com/empty-living-room.jpg をミニマリストなリビングルームとしてバーチャルステージングしてください。」

「/Users/me/Desktop/empty-living-room.jpg をミニマリストなリビングルームとしてバーチャルステージングしてください。」

「Pedraのクレジットはあといくつありますか？」

バーチャルツアー

360°写真をPOSTすると、ホストされ、リンクで共有できるバーチャルツアーが返されます。AIが部屋に名前を付け、部屋から部屋への移動ポイントを配置します。ツアーツールは、Pedraのホスト型MCPサーバー（https://app.pedra.ai/mcp）と同じ名前、説明、入力スキーマを備えているため、エージェントはどちらでも同じように動作します。

一般的な手順：

1. 360°写真を物件に追加します。
   • このコンピューター上のファイル → 歩く順にパスを指定して pedra_add_local_panoramas を使用します。このツールはこのローカルサーバーにのみ存在します。ファイルをディスクから読み込み、base64でエンコードして送信します。APIのリクエスト上限は50 MBのため、1回につき10枚までです。約33 MBを超えるファイルは、この方法では送信できません。
   • 誰かのスマートフォンにある写真（または大きなファイル） → type: "360" を指定して pedra_create_upload_link を使用し、uploadUrl を共有します（ログイン不要、有効期限は24時間）。
   • すでにオンラインにある写真 → この手順を省略し、URLを scenes として渡します。
2. 作成します： propertyId を指定した pedra_create_virtual_tour（アップロード順のすべての360°写真を使用）または scenes を指定して作成します。すぐに tourId が返されます。
3. 待ちます： status が "ready" になるまで pedra_get_virtual_tour をポーリングします（1部屋あたり約10秒）。準備ができたら tourUrl を共有するか、embedCode を埋め込みます。作成に失敗した場合は "failed" と理由が返され、料金はかかりません。
4. pedra_update_virtual_tour で調整する（無料、即時）か、pedra_add_virtual_tour_scenes で部屋を追加します。

リンクの作成には、"sequential"（デフォルト。各部屋を次の部屋につなぐ）の場合は max(3, ceil(rooms/3)) クレジット、"smart"（AIが部屋同士のつながりを判断）の場合は5～160クレジットが必要です。"none" の場合は無料です。ツアーの削除はAPI経由でのみ可能です（ツールとしては公開されていません）。

「/Users/me/360/entrance.jpg、/Users/me/360/living.jpg、/Users/me/360/kitchen.jpg の順に使って、Calle Mayor 12のPedraバーチャルツアーを作成し、リンクを教えてください。」

仕組み

このサーバーは @pedra-ai/sdk の薄いラッパーであり、APIの契約に関する詳細を処理します。

• バーチャルツアーを除き、同期処理です。 すべての写真・動画エンドポイントは処理を完了してから、最終的なURLをレスポンスボディで返します。pedra_create_video もサーバー側でポーリングし、完成した videoUrl をそのまま返します（最大約10分かかることがあります。APIはハートビートで接続を維持します）。
• エラーはツールエラーとして返されます。 APIの4xxレスポンス（クレジット不足、画像の不備など）は、クラッシュではなく、読みやすいメッセージを伴うMCPツールエラーとして返されます。

プライバシーポリシー

このサーバーは、リクエストされた編集を行うため、渡された画像／動画の URL とパラメーターを、PEDRA_API_KEY で認証したうえで Pedra API に送信します。キーがない場合、pedra_request_access は入力されたメールアドレスを Pedra に送信し、Pedra から確認リンクがメールで届くようにします。この方法で取得したキーは、セッション中のみメモリに保持されます。このサーバー自体はデータを保存しません。データの収集、利用、保存、保持、第三者との共有、および連絡先情報については、Pedra のプライバシーポリシーをご確認ください：**https://pedra.ai/privacy**。

ライセンス

MIT © Pedra