メインコンテンツにスキップ

リモートMCPサーバー提出ガイド

昨日アップデートされました

これは、リモートMCPサーバーをAnthropicのMCPディレクトリに送信して、より広い配布と発見可能性を実現するための完全なガイドです。

前提条件

サーバー送信前に、以下を用意する必要があります:

  • 動作確認済みで完全にテストされたリモートMCPサーバー

  • OAuth 2.0認証の実装(認証が必要な場合)

  • 適切なセーフティアノテーション付きのすべてのツール

  • 本番環境対応のデプロイメント

  • 専用のサポートチャネル(メールまたはウェブ)

  • サンプルデータを含むプロビジョニング済みテストアカウント

  • 包括的なドキュメント

リモートMCP開発が初めてですか?まずリモートMCPを使用したカスタムコネクタの開始をご覧ください。技術的なベストプラクティスとプロトコルの詳細については、MCPプロトコルドキュメントをご覧ください。

注:このガイドはリモートMCPサーバー(クラウドホスト、HTTPS)をカバーしています。ローカルデスクトップ拡張機能については、ローカルMCPサーバー送信ガイドをご覧ください。


1. ディレクトリの概要

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

発見可能性と信頼性:

  • Claude.aiからアクセス可能な公式AnthropicMCPディレクトリに掲載

  • すべてのプラットフォーム(ウェブ、デスクトップ、モバイル)のClaudeユーザーがアクセス可能

  • サービスの専門的な可視性

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

  • ディレクトリからのワンクリック接続

  • Claudeのコネクタインターフェースと統合

  • プラットフォーム全体での標準化された表示

  • シームレスに処理されるOAuthフロー

サポートと信頼性:

  • 品質、セキュリティ、コンプライアンスのAnthropicレビュー

  • 他の検証済みコネクタと並んで掲載

  • コミュニティの可視性とフィードバック

  • 専門的な配布チャネル

どのClaudeプラットフォームがリモートMCPサーバーをサポートしていますか?

すべての主要なClaudeプラットフォーム:

  • Claude.ai(ウェブ) - OAuthによる完全なサポート

  • Claude Desktop - OAuthによる完全なサポート

  • Claude Code - ユーザーのマシンからの直接接続(OAuthサポート付き)

  • Claude API - 統合サポート

  • Claudeモバイルアプリ - コネクタサポート


2. 必須要件

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

セーフティアノテーションは必須ですか?

はい - すべてのツールに正確なセーフティアノテーションが必須です。

すべてのツールで必須:

  • readOnlyHint: true - データのみを読み取るツール用

  • destructiveHint: true - データを変更するか副作用があるツール用

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

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

アノテーションの選択方法:

ツールの動作

アノテーション

データのみを読み取る

readOnlyHint: true、destructiveHint: false

search、get、list、fetch、read

データを書き込み/変更する

destructiveHint: true、readOnlyHint: false

create、update、delete、send

一時ファイルを作成する

destructiveHint: true

一時的な書き込みもカウント

外部リクエストを送信する

destructiveHint: true

メール、通知、ウェブフック

内部的にのみキャッシュする

readOnlyHint: true

内部最適化はOK

推奨される追加アノテーション:

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

テストアカウントを提供する必要がありますか?

はい - サーバーが認証を必要とする場合。

提供するもの:

  • テストアカウント認証情報(ユーザー名/パスワードまたはAPIキー)

  • アカウント内のサンプルデータ(機能テストに必要)

  • テスト環境のセットアップ手順

  • アクセス制限(ある場合)

テストアカウントは以下を備えている必要があります:

  • レビュー対象のすべてのツールへのアクセス

  • 代表的なサンプルデータ

  • 完全な機能テストのための適切な権限

  • レビュー期間中およびそれ以降のアクティブなステータス

提供方法:

  • 送信フォームに認証情報を含める(理想的には1Passwordリンクなどの安全な方法で共有)

  • レビュー中およびレビュー後の定期的なレビューのためにアカウントがアクティブなままであることを確認

  • 包括的なテストのための十分なアクセスを提供

OAuth 2.0は必須ですか?

はい - サーバーが認証を必要とする場合。

OAuth実装要件:

  • OAuth 2.0認可コードフローを使用する必要があります

  • 認識された認証局からの証明書

  • ローカルMCPクライアント(例:Claude Code、MCP Inspector)のコールバックURLをホワイトリストに登録:

    • http://localhost:6274/oauth/callback

    • http://localhost:6274/oauth/callback/debug

  • ClaudeコールバックURLをホワイトリストに登録:

  • 適切なリダイレクトURI設定

回避すべき一般的なOAuth問題:

  • 無効なリダイレクトURIエラー(両方のコールバックURLがホワイトリストに登録されていることを確認)

  • トークンなしのHEADリクエスト(OAuthフロー後に適切に処理)

実装ガイダンス:完全なOAuth実装の詳細については、OAuth 2.0認可フレームワークをご覧ください。

ファイアウォール要件はありますか?

はい - claude.ai互換性のためにClaudeのIPアドレスをホワイトリストに登録する必要があります

ファイアウォールの背後にあるサーバーの場合、https://docs.claude.com/en/api/ip-addressesからIPアドレスをホワイトリストに登録してください。

必須:Claude.aiおよびClaude Desktop

不要:Claude Code(ユーザーのマシンから直接接続)

重要:IPホワイトリストだけはセキュリティ対策として推奨されません。可能な限りOAuth 2.0を認証に使用してください。

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

特定のセクションを含む包括的なサーバードキュメント。

推奨セクション:

  1. サーバーの説明 - サーバーが何をするかの明確な説明

  2. 機能 - 主な機能とユースケース

  3. セットアップ手順 - ユーザーが接続して設定する方法

  4. 認証 - OAuth設定と要件(該当する場合)

  5. 使用例 - プロンプト付きの最小3つの動作例(必須)

  6. プライバシーポリシー - 完全なプライバシーポリシーへのリンク

  7. サポート - ユーザーがヘルプを取得したり問題を報告したりする方法

ドキュメント構造の例:

# [サービス名] MCPサーバー

## 説明
[サービス統合と機能の簡潔な説明]

## 機能
- 機能1:[説明と価値]
- 機能2:[説明と価値]
- 機能3:[説明と価値]

## セットアップ
1. [Anthropic MCPディレクトリ](https://claude.com/connectors)にアクセス
2. [サービス名]を見つけて接続
3. OAuth認証を完了
4. 必要な設定を構成

## 認証
このサーバーはOAuth認証が必要です。以下が必要です:
- 有効な[サービス名]アカウント
- [特定の権限またはアカウントタイプ]

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

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

## サポート
- メール:[email protected]
- ドキュメント:https://your-domain.com/mcp-docs
- 問題:https://github.com/yourcompany/mcp-server/issues

何個の使用例が必須ですか?

コア機能を実証する最小3つの動作例。

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

  • 現実的なユーザープロンプト/リクエストを表示

  • 実際のサーバー機能を実証

  • 期待される出力または動作を含む

  • 明確で理解しやすいワークフロー

  • 異なる機能をカバー

例の形式:

## 例

### 例1:ドキュメントを検索
**ユーザープロンプト:**「ワークスペース内の最近のプロジェクトレポートを見つけて」
**動作:**
- サーバーがワークスペースを検索
- メタデータ付きの一致するドキュメントを返す
- クイックアクセスリンクを提供

### 例2:新しいコンテンツを作成
**ユーザープロンプト:**「マーケティングキャンペーン用の新しいタスクリストを作成して」
**動作:**
- サーバーが新しいタスクリストを作成
- コンテキストに基づいて初期構造を追加
- 新しく作成されたリストへのリンクを返す

### 例3:既存データを更新
**ユーザープロンプト:**「プロジェクトステータスを「進行中」に更新して、今日のマイルストーンを追加して」
**動作:**
- サーバーがプロジェクトを検索
- ステータスフィールドを更新
- 現在の日付でマイルストーンを追加
- 加えられた変更を確認

要件:

  • 最小3つの例(最大値なし)

  • 異なるツール/機能をカバー

  • 現実的なユーザーインタラクションを表示

  • 価値提案を実証

  • サーバードキュメントに含める

本番環境対応の要件は何ですか?

サーバーは一般提供(GA)ステータスである必要があります。

本番環境対応とは:

  • サーバーが本番環境で安定して信頼性がある

  • 「ベータ」、「アルファ」、または「開発」とマークされていない

  • すべての機能が完全に実装およびテストされている

  • 適切なエラーハンドリングと優雅な失敗

  • スケーラブルなインフラストラクチャと監視

  • 完全なドキュメントとサポートチャネル

含めることができません:ベータ版、開発サーバー、またはアクセス制限されたサービス。

満たす必要がある技術要件は何ですか?

コアの技術的コンプライアンス基準を満たす必要があります。

トランスポートとパフォーマンス:

  • Streamable HTTPトランスポートをサポートする必要があります(SSEサポートは廃止される可能性があります)

  • 高可用性での高速応答時間

  • 有用なメッセージを含む優雅なエラーハンドリング

  • トークン効率的な応答(ツール結果あたり最大25,000トークン)

セキュリティとデータ:

  • 有効な証明書を備えたHTTPS/TLS

  • ブラウザクライアント用に適切に設定されたCORS

  • すべての必要なClaudeクライアントオリジンのサポート

  • 機能に必要なデータのみを収集

  • 無関係な会話データの収集なし

  • プライバシー準拠のデータプラクティス


3. 送信プロセス

リモートMCPサーバーを送信するにはどうすればよいですか?

このステップバイステップの送信プロセスに従ってください:

1. 送信前チェックリスト:

必須要件を確認:

  • [ ] すべてのツールにreadOnlyHintまたはdestructiveHintアノテーションがある

  • [ ] OAuth 2.0が実装されている(認証が必要な場合)

  • [ ] サーバーがHTTPSでアクセス可能

  • [ ] ClaudeのIPアドレスがホワイトリストに登録されている(ファイアウォールの背後にある場合)

  • [ ] 包括的なドキュメントが公開されている

  • [ ] プライバシーポリシーが公開されてアクセス可能

  • [ ] 専用のサポートチャネル(メールまたはウェブ)

  • [ ] テストアカウントが準備完了(認証が必要な場合)

  • [ ] サーバーが本番環境対応(GAステータス)

サーバーをテスト:

  • [ ] Claude.aiから正しく動作

  • [ ] Claude Desktopから正しく動作

  • [ ] Claude Codeから正しく動作(IPの制限がない場合)

  • [ ] OAuthフローが正常に完了

  • [ ] すべてのツールがドキュメント通りに機能

  • [ ] エラーメッセージが有用でユーザーフレンドリー

  • [ ] 負荷下でのパフォーマンスが許容範囲

2. 送信フォームを完成:

必須情報:サーバーの詳細、ドキュメントリンク、テスト認証情報、例(最小3つ)、および連絡先情報。フォームに完全なリストが記載されています。

すべての送信をできるだけ早くレビューするよう努力していますが、関心の量が多いため、送信を受け入れたり個別に対応したりすることを保証することはできません。


4. 一般的な問題

修正リクエストの最も一般的な理由は何ですか?

これらは送信データに基づいた主な問題です:

1. ツールアノテーションの欠落

  • 問題:ツールに必須のセーフティアノテーションがない

  • 修正:すべ

こちらの回答で解決しましたか?