GemstoneAI

GemstoneAI for Agents

GemstoneAI は、AI アシスタントがユーザーの所有するジュエリーについてサポートできる、ホスト型のリモート MCP サーバーです。アシスタントは次のことができます。

• ジュエリーの写真を 1～5 枚分析し、暫定的な識別結果と、その代替候補、不明点、判断を確定するための証拠を提示します
• 写真付きの類似商品や販売情報を表示します。それぞれに希望価格か実際の販売価格かを明記します
• ジュエリーをユーザーの GemstoneAI コレクションに保存し、スマートフォンの GemstoneAI アプリで開けるようにします

https://api.gemstoneaiapp.com/mcp

インストールや実行は不要です。製品ページ：gemstoneaiapp.com/agents。

接続

対応しているクライアントであれば、リモート（Streamable HTTP）MCP サーバーとして URL を追加してください。クライアントが自動的にサインインを検出します。ユーザーは GemstoneAI アプリで使用しているメールアドレスでサインインするため、同じコレクションを利用できます。新しいメールアドレスを使うと、無料アカウントが作成されます。分析を行うたびに、そのアカウントのプランに含まれるスキャンが消費されます。アプリでの利用と同様です。

Claude Code：プラグインとして追加（サーバーとジュエリー調査スキルを追加します）。

/plugin marketplace add Iveye-Inc/gemstoneai-agents
/plugin install gemstoneai@gemstoneai

Claude Code：サーバーのみ追加。

claude mcp add --transport http gemstoneai https://api.gemstoneaiapp.com/mcp

Claude Code で /mcp を実行してサインインしてください。

その他のクライアント（Claude のウェブ版とデスクトップ版、ChatGPT の開発者モード、Cursor、VS Code、MCP Inspector）：上記の URL を使ってリモート MCP サーバーを追加し、プロンプトが表示されたらサインインしてください。

対応クライアントの一覧は製品ページに記載されています。写真、分析、類似商品、保存、アプリでの再表示という一連の手順を最後まで完了できた場合にのみ、そのクライアントをテスト済みとしています。

ツール

ツール	機能	アノテーション
analyze_jewelry	1 点のジュエリーの写真を 1～5 枚使って暫定分析します。photos（添付ファイル）または image_urls（公開されている https URL）と、任意の idempotency_key を指定します。写真がない場合は、ユーザーがスマートフォンで開くアップロードリンクを返します。	書き込み、破壊的ではない、冪等、オープンワールド
get_jewelry_analysis	分析のステータスまたは完了した結果を返します。処理中の場合は、最大約 40 秒待機します。	読み取り専用
find_jewelry_comparables	写真付きの市場出品情報と販売情報を、出典、リンク、価格、価格の種類、確認日、およびこのジュエリーとの素材の違いとともに返します。	読み取り専用、オープンワールド
save_collection_item	分析したジュエリーをサインイン中のユーザーのコレクションに保存し、アプリで開くリンクを返します。	書き込み、破壊的ではない、冪等

結果に数値の信頼度が含まれることはありません。不確実な点は、代替候補、不明点、次に必要な証拠として提示されます。GemstoneAI 自身の分析結果が石の種類について一致しない場合は、その理由とともに価格情報を提示しません。価格付きの類似商品が見つからない場合は、「見つかりませんでした」と回答し、価格を 0 として示すことはありません。

プロトコルと認証

• Streamable HTTP、ステートレス、JSON レスポンスに対応しています。Initialize ベースのクライアント（プロトコル 2024-11-05～2025-11-25）と 2026-07-28 のクライアントに対応しています。
• PKCE（S256）を使用した OAuth 2.1 に対応しています。api.gemstoneaiapp.com でのディスカバリー先は /.well-known/oauth-protected-resource/mcp および /.well-known/oauth-authorization-server です。
• クライアントは Client ID Metadata Documents または動的クライアント登録を使って登録します。ループバックリダイレクトでは任意のポートを使用できます。
• トークンは、1 人のユーザー、1 つのクライアント、このサーバーにバインドされます（RFC 8707）。アクセストークンの有効期間は 1 時間です。リフレッシュトークンはローテーションされます。
• スコープ：jewelry:analyze および collection:write。

レイテンシと制限

• 分析には通常 20～45 秒かかります。analyze_jewelry は最大約 40 秒待機し、その後、再試行間隔とともに processing を返します。類似商品は通常 1 分以内に表示されます。
• 同じ写真、または同じ idempotency_key で再度リクエストすると、同じ分析結果が返され、二重に課金されることはありません。
• パイロット期間中は、アカウントごと、インテグレーションごとに 1 日あたりの評価回数に上限があります。開発者は製品ページからパイロットへの参加を申請できます。

対象外のこと

結果は写真に基づく予備的な分析です。査定ではなく、真正性、処理、産地、または認定価値を確定するものではありません。このサーバーが購入、販売、出品、または誰かへの連絡を行うことはありません。また、依頼された場合にのみコレクションに保存します。

プライバシー

写真は品物の分析に使用され、アプリ内でのスキャンと同様に、その人の GemstoneAI アカウントに品物と一緒に保存されます。位置情報はすべての写真から削除されます。プライバシーポリシーと利用規約をご覧ください。

リポジトリの構成

• .claude-plugin/marketplace.json, plugins/gemstoneai/：Claude Code プラグイン（MCP サーバーの設定とジュエリー調査スキル）
• openai/：ChatGPT プラグインパッケージのソース。python scripts/build_openai_zip.py で ZIP をビルドします
• server.json：公式 MCP Registry のエントリー。scripts/publish_registry.py で公開されています

サポート

[email protected]