FindMe Photo

FindMe Photo MCP サーバー

FindMe Photo — AI を活用したウェディングギャラリープラットフォームの公式 Model Context Protocol サーバーです。

Claude、ChatGPT Codex、Cursor、その他の MCP 対応 AI クライアントから FindMe ギャラリーを操作できます。イベントの作成、写真のアップロード、分析データの取得などを、すべて自然言語で行えます。

できること

「4月22日のSarahとMikeの結婚式用にFindMeイベントを作成し、~/Pictures/Sarah-Mikeにある写真をすべてアップロードして、QRコードを表示してください。」

AI はこの MCP サーバーを使って、1回のやり取りですべての手順を実行します。

ツール

ツール	用途
create_event	新しいギャラリーを作成します。
list_events	イベントの一覧を表示します（ページネーション対応）。
get_event	イベントの詳細と統計情報を取得します。
update_event	イベント名、日付、アクセスコードを変更します。
delete_event	7日間の復元期間付きでイベントを論理削除します。
restore_event	7日以内にイベントを復元します。
upload_photos_from_paths	ローカルのファイルやフォルダーをアップロードします。主なアップロードツールです。
upload_photos_from_urls	公開 URL からアップロードします（Dropbox、Drive の直接リンクなど）。
upload_photos_from_drive_folder	Google Drive からインポートします（v1 では一部機能のみ）。
get_event_qr	公開ギャラリーへのリンクを含む PNG QR コードを取得します。
get_event_analytics	ゲストの訪問数、ユニーク訪問者数、ダウンロード数、自撮り写真検索数を取得します。
get_usage	当月の API 使用量、ストレージ、イベント合計数を取得します。

要件

• Node.js 18 以降
• Free+、Growth、Pro のいずれかの FindMe Photo アカウント
• https://findme.photo/settings/api で取得した個人用 API キー

インストール

最も簡単な方法：AI にインストールさせます。 プロンプトを貼り付けると、AI が自分の設定を編集します。隠しファイルはありません。

技術に詳しくない写真家向けの手順を追ったガイドについては、インストールガイド全文をご覧ください。

Claude Desktop

Claude Desktop を開き、Code タブ（Chat ではありません）をクリックして、次のプロンプトを貼り付けてください（キーを置き換えてください）。

Install the FindMe MCP server for me.

- Server name: findme
- Command: npx
- Args: -y findme-mcp
- Env var: FINDME_API_KEY = fm_live_PASTE_YOUR_KEY_HERE

Edit my claude_desktop_config.json under mcpServers, then tell me to fully quit and reopen Claude.

Claude Code（CLI）

claude mcp add findme --scope user --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

ChatGPT Codex

codex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp

Cursor / Windsurf / VS Code / Cline

ツールに組み込まれている MCP インストール UI で、次の内容を設定してください。

• コマンド：npx
• 引数：-y findme-mcp
• 環境変数：FINDME_API_KEY=fm_live_xxxxx

ChatGPT Web / モバイル

近日公開 — ホスト型 MCP エンドポイントが必要です。次に mcp.findme.photo をリリースする予定です。それまでは Claude Desktop または Codex をお使いください。

その他の MCP クライアント

FINDME_API_KEY=fm_live_xxxxx npx findme-mcp

動作確認

再起動後、クライアントのツール一覧に findme（12 個のツール）が表示されていることを確認してください。次のように試してみましょう。

今日の日付で「My First Gallery」というFindMeイベントを作成して、QRコードを表示してください。

トラブルシューティング

「MCP server failed to start」

• Node.js 18 以降であることを確認してください：node --version
• 初回起動時に npx 経由でパッケージがダウンロードされます。ファイアウォールを通過できるようにしてください
• 手動で編集した場合は、JSON が有効であることを確認してください（末尾のカンマは使用できません）

「Your FindMe API key is invalid or has been revoked」

• https://findme.photo/settings/api で新しいキーを生成してください
• fm_live_ プレフィックスを含むキー全体を貼り付けてください
• AI クライアントを完全に終了してから再起動してください

「API access requires Free+, Growth, or Pro」

API アクセスは有料プランの機能です。https://findme.photo/pricing でアップグレードしてください。

macOS で「can't find folder」と表示され、アップロードに失敗する

macOS のプライバシー保護によるものです。システム設定 → プライバシーとセキュリティ → フルディスクアクセス を開き、AI クライアント（Claude Desktop、Terminal など）を追加してください。その後、アプリを終了して再度開いてください。

アップロードが一部失敗する

このツールは、問題のあるファイルが1つあってもバッチ全体をエラーにすることはありません。成功したファイルと失敗したファイルを示す概要を返します。失敗したファイルだけを再試行するよう AI に依頼してください。

制限

プラン	レート制限	月間クォータ
Free+	10 req/min	500 / 月
Growth	60 req/min	10,000 / 月
Pro	300 req/min	無制限

ファイルごとの上限：写真 50 MB、動画 500 MB。アップロード1回あたり50ファイルまで。

v1 の制限事項

• upload_photos_from_drive_folder を使用するには、findme.photo のウェブ UI から作成済みの Drive インポートが必要です。MCP はステータスをポーリングできますが、現時点ではインポートを作成できません。
• MCP は AI クライアントと同じマシン上でローカルに実行され、そのマシン上のファイルのみを認識します。

リソース

• FindMe Photo
• インストールガイド
• Model Context Protocol

ライセンス

MIT — © 2026 FindMe Photo