Это полное руководство по отправке вашего удаленного MCP сервера в Anthropic MCP Directory для более широкого распространения и обнаружения.

Предварительные требования

Перед отправкой сервера у вас должны быть:

Работающий и полностью протестированный удаленный MCP сервер
Реализована аутентификация OAuth 2.0 (если требуется аутентификация)
Все инструменты с надлежащими аннотациями безопасности
Развертывание, готовое к производству
Выделенный канал поддержки (электронная почта или веб)
Подготовленный тестовый аккаунт с примерами данных
Полная документация

Новичок в разработке удаленного MCP? Сначала см. Начало работы с пользовательскими соединителями с использованием Remote MCP. Для технических лучших практик и деталей протокола см. Документацию протокола MCP.

Примечание: Это руководство охватывает удаленные MCP серверы (облачные, HTTPS). Для локальных расширений рабочего стола см. Руководство по отправке локального MCP сервера.

1. Обзор каталога

Каковы преимущества включения в каталог?

Обнаружение и доверие:

Указан в официальном Anthropic MCP Directory, доступном с Claude.ai
Доступен пользователям 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 Protocol - Tool Annotations для полной схемы и деталей реализации.

Не опционально. Это жесткое требование, вытекающее из Политики MCP Directory.

Как выбрать аннотацию:

Поведение инструмента	Аннотация	Примеры
Только читает данные	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
Сертификаты от признанных центров сертификации
Добавить в список разрешений локальные URL обратного вызова MCP клиента (например Claude Code, MCP Inspector):
- http://localhost:6274/oauth/callback
- http://localhost:6274/oauth/callback/debug
Добавить в список разрешений URL обратного вызова Claude:
- https://claude.ai/api/mcp/auth_callback
- https://claude.com/api/mcp/auth_callback
Надлежащая конфигурация URI перенаправления

Распространенные проблемы OAuth, которых следует избегать:

Ошибки неверного URI перенаправления (убедитесь, что оба URL обратного вызова добавлены в список разрешений)
HEAD запросы без токенов (обрабатывайте корректно после потока OAuth)

Руководство по реализации: См. OAuth 2.0 Authorization Framework для полных деталей реализации OAuth.

Есть ли требования к брандмауэру?

ДА - Должны добавить в список разрешений IP адреса Claude для совместимости с claude.ai

Для серверов за брандмауэром добавьте в список разрешений IP адреса из https://docs.claude.com/en/api/ip-addresses.

Требуется для: Claude.ai и Claude Desktop

Не требуется для: Claude Code (подключается напрямую с машины пользователя)

Важно: Добавление IP адресов в список разрешений не рекомендуется как мера безопасности. Используйте OAuth 2.0 для аутентификации, когда это возможно.

Какая документация требуется?

Полная документация сервера с конкретными разделами.

Рекомендуемые разделы:

Описание сервера - Четкое объяснение того, что делает ваш сервер
Функции - Ключевые возможности и варианты использования
Инструкции по настройке - Как пользователи подключаются и настраивают
Аутентификация - Настройка OAuth и требования (если применимо)
Примеры использования - Минимум 3 рабочих примера с подсказками (требуется)
Политика конфиденциальности - Ссылка на полную политику конфиденциальности
Поддержка - Как пользователи могут получить помощь или сообщить о проблемах

Пример структуры документации:

# MCP сервер [Название вашего сервиса]

## Описание
[Краткое описание интеграции сервиса и возможностей]

## Функции
- Функция 1: [описание и ценность]
- Функция 2: [описание и ценность]  
- Функция 3: [описание и ценность]

## Настройка
1. Посетите [Anthropic MCP Directory](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

Сколько примеров использования требуется?

МИНИМУМ три рабочих примера, демонстрирующих основную функциональность.

Что считается хорошим примером:

Показывает реалистичный запрос/просьбу пользователя
Демонстрирует фактическую функциональность сервера
Включает ожидаемый результат или поведение
Четкий и понятный рабочий процесс
Охватывает различные возможности

Формат примера:

## Примеры

### Пример 1: Поиск документов
**Запрос пользователя:** "Найди недавние отчеты о проектах в моем рабочем пространстве"
**Что происходит:**
- Сервер ищет в вашем рабочем пространстве
- Возвращает совпадающие документы с метаданными
- Предоставляет быстрые ссылки доступа

### Пример 2: Создание нового контента
**Запрос пользователя:** "Создай новый список задач для маркетинговой кампании"
**Что происходит:**
- Сервер создает новый список задач
- Добавляет начальную структуру на основе контекста
- Возвращает ссылку на вновь созданный список

### Пример 3: Обновление существующих данных
**Запрос пользователя:** "Обновите статус проекта на 'В процессе' и добавьте сегодняшний этап"
**Что происходит:**
- Сервер находит проект
- Обновляет поле статуса
- Добавляет этап с текущей датой
- Подтверждает внесенные изменения

Требования:

Минимум 3 примера (максимума нет)
Охватывают различные инструменты/возможности
Показывают реалистичные взаимодействия пользователя
Демонстрируют ценностное предложение
Включены в документацию сервера

Каковы требования готовности к производству?

Сервер должен быть в статусе General Availability (GA).

Готовность к производству означает:

Сервер стабилен и надежен в производстве
Не помечен как "бета", "альфа" или "разработка"
Все функции полностью реализованы и протестированы
Надлежащая обработка ошибок и корректные отказы
Масштабируемая инфраструктура и мониторинг
Полная документация и каналы поддержки

Не может быть включено: Бета-версии, серверы разработки или сервисы с ограниченным доступом.

Какие технические требования должны быть выполнены?

Должны соответствовать основным стандартам технического соответствия.

Транспорт и производительность:

Должен поддерживать транспорт Streamable HTTP (поддержка SSE может быть устаревшей)
Быстрое время отклика с высокой доступностью
Корректная обработка ошибок с полезными сообщениями
Эффективные по токенам ответы (максимум 25 000 токенов на результат инструмента)

Безопасность и данные:

HTTPS/TLS с действительными сертификатами
CORS надлежащим образом настроен для клиентов браузера
Поддержка всех требуемых источников клиента Claude
Сбор только данных, необходимых для функциональности
Отсутствие сбора посторонних данных разговора
Практики обработки данных, соответствующие конфиденциальности

3. Процесс отправки

Как отправить мой удаленный MCP сервер?

Следуйте этому пошаговому процессу отправки:

1. Контрольный список перед отправкой:

Проверьте обязательные требования:

[ ] Все инструменты имеют аннотации readOnlyHint ИЛИ destructiveHint
[ ] OAuth 2.0 реализован (если требуется аутентификация)
[ ] Сервер доступен через HTTPS
[ ] IP адреса Claude добавлены в список разрешений (если сервер за брандмауэром)
[ ] Полная документация опубликована
[ ] Политика конфиденциальности опубликована и доступна
[ ] Выделенные каналы поддержки (электронная почта или веб)
[ ] Тестовый аккаунт готов (если требуется аутентификация)
[ ] Сервер готов к производству (статус GA)

Протестируйте ваш сервер:

[ ] Работает правильно с Claude.ai
[ ] Работает правильно с Claude Desktop
[ ] Работает правильно с Claude Code (если нет ограничений IP)
[ ] Поток OAuth завершается успешно
[ ] Все инструменты функционируют как задокументировано
[ ] Сообщения об ошибках полезны и удобны для пользователя
[ ] Производительность приемлема под нагрузкой

2. Заполните форму отправки:

Форма отправки: Форма проверки MCP Directory Server

Требуемая информация: Детали сервера, ссылки на документацию, тестовые учетные данные, примеры (минимум 3) и контактная информация. Форма предоставляет полный список.

Хотя мы стараемся проверить каждую отправку как можно быстрее, из-за большого количества интереса мы не можем гарантировать, что примем вашу отправку или ответим на нее индивидуально.