Pearl

Pearl エージェント連携パッケージ

Pearl を初めてご利用になる場合は、クイックスタート＆テスターガイドをご覧ください。

利用資格を満たす Pearl Reserve および Elite メンバーは接続できます。利用できるアクションは、接続の権限と実際に利用可能なツール一覧によって異なります。

Pearl のインストール可能なパッケージは、Codex、Claude、Cursor、Cursor の Grok Bot 向けに、認証済みの単一の Streamable HTTP MCP エンドポイントへの薄型ホスト連携を提供します。

https://agent.joinpearl.co/mcp

このパッケージには、ホストマニフェスト、Pearl Concierge スキル、公開セットアップドキュメント、ブランドアセット、表示専用の MCP Apps リソース、検証コードが含まれます。アプリケーション、データベース、OAuth サーバー、MCP 実行環境、デプロイ設定、アクセストークン、クライアントシークレットは含まれません。

現行リリース

パッケージ 0.12.7 では、認証済みのすべての接続で共通の 13 件の読み取り機能を利用できます。審査済みの Codex、Claude、Cursor クライアントでは、テーブルの空き状況、6 件の検索機能（店舗の詳細、予約開始時期、類似・近隣の店舗、Pearl のイベント、および Tables 対応都市で予約可能な店舗）、訪問、保存した場所、プライベート旅行に関する、確定操作用の 10 個のツールも利用できます。7 件の読み取り権限ではツールが 20 個、10 件すべての権限では 30 個です。検索機能に新たな権限は不要です。保存・旅行の権限を承認するには、再接続してください。ChatGPT は、申請済みの訪問・空き状況に関する 18 ツールの仕様を維持します。スタンドアロンの Pearl CLI と未知のクライアントでは、共通の 13 件の読み取り機能のみを利用できます。

現行の Codex は、OpenAI がホストする共通の CIMD クライアント ID を使用します（旧リリースではインストールごとに異なる ID を使用）。Pearl が受け入れるのは、厳密に検証されたこの公式 ID ファミリーのみです。すべてのホストで同じゲートウェイと実行環境を使用します。カードは表示専用で、店舗、保存した場所、訪問、場所の候補、プロフィール、旅行、予約、店舗の詳細、空き状況、利用可能な場合のフライト、訪問・保存・旅行のプレビューと確認情報を扱います。

ホストごとの正確な対応状況と、利用できないワークフローの明示的なラベルについては、機能スナップショットをご覧ください。このリリースでは、どのホストも予約の確保、仮押さえ、変更、キャンセル、支払いはできません。また、ホストが Pearl を承認済み、または掲載済みであるとは主張しません。

実用的な記録・編集用プロンプト、照合と確認のルール、予約に関する制限については、訪問と予約をご覧ください。

同梱されるアーティファクト

• .codex-plugin/plugin.json：Codex のメタデータと開始用プロンプトです。
• .claude-plugin/plugin.json：Claude Code と Cowork のメタデータです。
• cursor/.cursor-plugin/plugin.json：独立した Cursor ソース、ホスト固有の pearl-cursor 識別子、シークレット不要の公開 OAuth 設定です。
• .mcp.json：Codex と Claude で共有する、URL のみの単一接続です。Cursor の独立した薄型ラッパーも、必須の静的公開クライアントを使用して同じエンドポイントに接続します。
• server.json：同じリモート URL の MCP Registry プレビュー用エントリーです。ヘッダー、認証情報、パッケージのランタイム、ツール一覧は含まれません。
• skills/pearl-concierge/：Codex と Claude 向けの、検索優先の標準ワークフロースキルです。Cursor には、バイト単位で検証済みの複製が独立したソースサブツリーに含まれます。
• docs/：メンバー向けセットアップ、ホスト登録と審査、OAuth、リリース手順です。
• assets/：承認済みの Pearl マーケットプレイス用アートワークです。assets/README.mdをご覧ください。Cursor の独立したソースには、ハッシュ検証済みのロゴの複製が含まれます。
• mcp-apps/：依存関係のない、バージョン管理されたインライン UI リソースと連携ヘルパーです。ツール、認証、ネットワークエンドポイント、ビジネスロジックは追加しません。mcp-apps/README.mdをご覧ください。
• scripts/ と test/：依存関係のない検証機能です。

検証

リポジトリのルートから実行します。

npm --prefix plugins/pearl test
npm --prefix plugins/pearl run validate
npm --prefix plugins/pearl run validate:live
npm --prefix plugins/pearl run validate:registry
npm --prefix plugins/pearl run validate:registry:schema
npm --prefix plugins/pearl run validate:registry:live
claude plugin validate plugins/pearl --strict
claude plugin validate . --strict

ライブ検証では、公開情報の検出と認証なしのチャレンジチェックのみを行います。認証情報は使用せず、メンバー向けツールも呼び出しません。

Codex に同梱されている plugin-creator と skill-creator のスキルをインストール済みの Pearl メンテナーは、plugins/pearl と、パッケージに含まれる両方の Pearl Concierge スキルディレクトリに対して、それらのスキルのバリデーターも実行してください。これらはメンテナー向けのチェックであり、公開パッケージの依存関係ではありません。

マーケットプレイスでリリースする前に、docs/submission.md に記載されている、安全な静的ホスト登録プローブも実行してください。これらのプローブでは、意図的に無効な MCP リソースを使用し、認証リクエストの作成やメンバー向けツールの呼び出しは行いません。

公式 MCP Registry はプレビュー段階です。パッケージに server.json を含めても、公開されたことにはならず、Registry、Anthropic、Cursor、OpenAI の承認を意味するものでもありません。Registry への公開は、docs/releasing.md に記載されている、別途保護されたリリース操作です。

セキュリティとサポート

認証情報、環境ファイル、認証ヘッダー、非公開の実装詳細、メンバーデータを、このパッケージに追加しないでください。脆弱性は、件名に [Security] を含めて [email protected] に非公開で報告してください。

• メンバーのセットアップ：docs/setup.md
• ホストの登録とレビュー：docs/host-operators.md
• OAuth：docs/oauth.md
• リリース：docs/releasing.md
• ホストの提出：docs/submission.md
• プライバシー：https://joinpearl.co/privacy
• 利用規約：https://joinpearl.co/terms
• サポート：https://joinpearl.co/support