これは、ローカルサーバー（MCPB）をAnthropicのパブリックディレクトリに提出して、より広い配布と発見可能性を実現するための完全なガイドです。

前提条件

このガイドを読む前に、以下を用意してください：

動作するMCPB
変数置換を使用したポータブルコード
優れたエラーメッセージとユーザーエクスペリエンス
クリーンでバンドルされた依存関係

MCPBの開発が初めてですか？ まずBuilding MCPB Extensionsを参照してください。技術的なベストプラクティス（テスト、エラーメッセージ、ポータビリティ）については、MCPBリポジトリを参照してください。

注：このガイドはローカルMCPサーバーについて説明しています。リモートデスクトップ拡張機能については、Remote MCP Server Submission Guideを参照してください。

1. ディレクトリの概要

ディレクトリに含まれることの利点は何ですか？

発見可能性と信頼性：

Claude Desktop内の公式Anthropicディレクトリにリストされる
個別のClaude Desktopユーザーが検索可能
管理者がアローリストに追加した場合、Teams/Enterpriseユーザーに表示される
Anthropicのレビューがユーザーの信頼を構築する

ユーザーエクスペリエンス：

ディレクトリからのワンクリックインストール
Claude Desktopの設定UIと統合
標準化されたプレゼンテーション

サポートと信頼性：

品質とセキュリティのAnthropicレビュー
他のレビュー済み拡張機能と並んでリストされる
コミュニティの可視性とフィードバック
プロフェッショナルな配布チャネル

2. 必須要件

このセクションのすべての要件は、ディレクトリ承認のために必須です。 これらのいずれかが欠けている場合、却下または修正リクエストが発生します。

注：これらはAnthropicディレクトリ固有の要件です。

一般的なMCPB開発のベストプラクティス（テスト、エラーハンドリング、ポータビリティ）については、MCPBリポジトリREADMEを参照してください。

ツールアノテーションは必須ですか？

はい。すべてのツールは、正確なセーフティアノテーションを持ち、維持する必要があります。

すべてのツールで必須：

readOnlyHint: true - データのみを読み取るツール用
destructiveHint: true - データを変更するか副作用があるツール用

MCPプロトコル - ツールアノテーションで、完全なスキーマと実装の詳細を参照してください。

オプションではありません。 これはMCPディレクトリポリシーから派生した厳密な要件です。

どのアノテーションを選択するかの判断方法：

ツールの動作	アノテーション	例
データのみを読み取る	readOnlyHint: true	search、get、list、fetch、read
データを書き込み/変更する	destructiveHint: true	create、update、delete、send、write
一時ファイルを作成する	destructiveHint: true	一時的な書き込みもカウント
外部リクエストを送信する	destructiveHint: true	メール、通知、ウェブフック
内部的にのみキャッシュする	readOnlyHint: true	内部最適化はOK

実装の詳細： MCPプロトコル - ツールで以下を参照してください：

アノテーション付きの完全なツールスキーマ
ツール定義構造
入出力スキーマ仕様
追加のツールプロパティ（オプションのtitleフィールドを含む）

提出前の検証：

# すべてのツールにアノテーションがあるか確認

grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/

# 各ツールが正確に1つのアノテーションを持つことを確認

影響： 最初にチェックされ、修正リクエストの最も一般的な理由です。

追加の推奨アノテーション：

title - UI表示用の人間が読めるツール名（ユーザーエクスペリエンスを向上）

プライバシーポリシーは必須ですか？

はい、プライバシーポリシーは2つの場所で必須です：

場所1：README.md

README に「プライバシーポリシー」セクションを追加し、完全なプライバシーポリシーへのリンクを含めて、ユーザーがあなたのプラクティスを認識できるようにします：

## プライバシーポリシー

この拡張機能は[データタイプを説明]を収集します。完全なプライバシー情報については、プライバシーポリシーを参照してください：https://your-domain.com/privacy-policy

### データ収集
- [収集されるデータ]
- [使用方法]
- [第三者と共有されるかどうか]
- [保持期間]

場所2：manifest.json

公開アクセス可能なHTTPS URLを含むprivacy_policies配列を追加します：

完全な実装： MCPBマニフェスト仕様 - プライバシーポリシーで以下を参照してください：

プライバシーポリシーフィールド構造
マニフェストバージョン要件（0.3以上）
複数のポリシーURL対応
検証要件

プライバシーポリシーが対象とする必要があること：

MCPBが収集するデータ
データの使用方法と保存方法
データが第三者と共有されるかどうか
ユーザーデータの保持ポリシー
プライバシーに関する質問の連絡先情報

要件：

公開アクセス可能なHTTPS URLである必要があります
あなたのドメインからである必要があります（サードパーティホスティングではない）
現在で正確である必要があります
README AND manifest.jsonに含まれている必要があります
manifest_version「0.3」以上を使用する必要があります

一般的な間違い：

プライバシーポリシーがマニフェストにあるがREADMEにない
プライバシーポリシーがREADMEにあるがマニフェストにない
manifest_version「0.2」以前を使用している
無効またはアクセス不可のURL
プライバシーポリシーがサードパーティサイトでホストされている

影響： 却下の最も一般的な原因の1つです。修正は簡単ですが、頻繁に見落とされます。

何個の例が必要ですか？

コア機能を実証する3つ以上の動作する例が必須です。

良い例として適格なもの：

現実的なユースケースを示す
予想されるユーザー入力/プロンプトを含む
予想される出力/動作を示す
実際のツール使用を実証する
明確で理解しやすいワークフロー

例の形式（README.mdで）：

## 例

### 例1：ファイルを検索
**ユーザープロンプト：** 「プロジェクト内のすべてのJavaScriptファイルを見つけて」

**予想される動作：**
- 拡張機能がワークスペースディレクトリを検索
- パス付きの.jsファイルのリストを返す
- サマリーにファイル数を表示

### 例2：ファイルの内容を読む
**ユーザープロンプト：** 「config.jsonの内容を見せて」

**予想される動作：**
- 拡張機能がconfig.jsonを読む
- フォーマットされたJSONコンテンツを返す
- ファイルが見つからない場合を適切に処理

### 例3：新しいファイルを作成
**ユーザープロンプト：** 「notes.txtという新しいファイルを作成して、'Hello World'を書き込んで」

**予想される動作：**
- 拡張機能がnotes.txtを作成
- ファイルにコンテンツを書き込む
- ファイルパスで作成を確認

含めるべきもの：

現実的なユーザープロンプト（ユーザーがどのように相互作用するか）
予想されるツール呼び出し（バックグラウンドで何が起こるか）
予想される出力（ユーザーが何を見るか）
エラーハンドリングの例（オプションですが推奨）

要件：

最小3つの例（最大なし）
コア機能をカバー
異なるツール/機能を表示
価値提案を実証
README.mdに含める

影響： 遅延または却下の頻繁な原因です。レビュアーが提出を適切に評価するには、完全なドキュメントが必要です。

テスト認証情報を提供する必要がありますか？

MCPBが認証または外部サービスアクセスを必要とする場合、はい。

必須の場合：

MCPBが外部APIに接続する
機能に認証が必要
MCPBユーザーが機能を使用するためにアカウントを持つ必要がある
外部サービス統合が存在する

不要な場合：

純粋にローカルなMCPB（ファイルシステム操作のみ）
外部接続なし
認証不要
完全に自己完結型

提供するもの：

テストアカウント認証情報（ユーザー名/パスワードまたはAPIキー）
アカウント内のサンプルデータ（機能テストに役立つ）
セットアップ手順（テストアカウントの設定と使用方法）
アクセス制限（ある場合）
アカウント有効期限（一時的な場合）

提供方法：

提出フォームに含める
非常に機密の場合は安全な方法で送信
レビュー期間中、アカウントがアクティブなままであることを確認
完全なテストのための十分なアクセスレベルを提供

ベストプラクティス： 本番環境とは別の専用テストアカウントを作成して：

本番データの公開を回避
レビュアーがアクセスできるものを制御
承認後に簡単にアクセスを取り消す
テストアカウントの使用を追跡

影響： 必要な場合、欠けているとレビュープロセスが遅延します

どのようなドキュメントが必須ですか？

README.mdに最小限の必須セクションを含む包括的なドキュメント。

最小限の必須セクション：

説明 - MCPBが何をするかの明確な説明
機能 - 主な機能とユースケース
インストール - インストール方法（通常：「Anthropicディレクトリからインストール」）
設定 - 必須設定とセットアップステップ
使用例 - 最小3つの例（上記セクション参照）
プライバシーポリシー - 完全なプライバシーポリシーへのリンク
サポート - ユーザーがヘルプを得たり、問題を報告したりする方法

README.md構造の例：

# My MCPB Extension

## 説明
この拡張機能が何をするか、なぜ有用かの簡潔な説明。

## 機能
- 機能1：[説明]
- 機能2：[説明]
- 機能3：[説明]

## インストール
Claude Desktop設定 → 拡張機能からAnthropicディレクトリからインストール。

## 設定
1. 設定 → 拡張機能 → [拡張機能名]を開く
2. APIキーを追加（必要な場合）
3. ワークスペースディレクトリを選択
4. オプション設定を設定

## 例
[上記の最小3つの例セクションを参照]

## プライバシーポリシー
プライバシーポリシーを参照：https://your-domain.com/privacy

## サポート
問題または質問：[email protected]
GitHubイシュー：https://github.com/your-username/your-extension/issues