Esta es una guía completa para enviar tu servidor MCP remoto al Directorio MCP de Anthropic para una distribución y descubribilidad más amplia.
Requisitos previos
Antes del envío del servidor, debes tener:
Un servidor MCP remoto completamente funcional y probado
Autenticación OAuth 2.0 implementada (si se requiere autenticación)
Todas las herramientas con anotaciones de seguridad adecuadas
Implementación lista para producción
Un canal de soporte dedicado (correo electrónico o web)
Cuenta de prueba aprovisionada con datos de ejemplo
Documentación completa
¿Nuevo en el desarrollo de MCP remoto? Consulta primero Introducción a conectores personalizados usando MCP remoto. Para mejores prácticas técnicas y detalles del protocolo, consulta Documentación del protocolo MCP.
Nota: Esta guía cubre servidores MCP remotos (alojados en la nube, HTTPS). Para extensiones de escritorio local, consulta Guía de envío de servidor MCP local.
1. Descripción general del directorio
¿Cuáles son los beneficios de la inclusión en el directorio?
Descubribilidad y confianza:
Listado en el Directorio MCP oficial de Anthropic accesible desde Claude.ai
Accesible para usuarios de Claude en todas las plataformas (web, escritorio, móvil)
Visibilidad profesional para tu servicio
Experiencia del usuario:
Conexión con un clic desde el directorio
Integrado con la interfaz de conectores de Claude
Presentación estandarizada en todas las plataformas
Flujo OAuth manejado sin problemas
Soporte y credibilidad:
Revisión de Anthropic de calidad, seguridad y cumplimiento
Listado junto con otros conectores verificados
Visibilidad comunitaria y retroalimentación
Canal de distribución profesional
¿Qué plataformas de Claude admiten servidores MCP remotos?
Todas las principales plataformas de Claude:
Claude.ai (web) - Soporte completo con OAuth
Claude Desktop - Soporte completo con OAuth
Claude Code - Conexión directa desde la máquina del usuario (con soporte OAuth)
Claude API - Soporte de integración
Aplicaciones móviles de Claude - Soporte de conectores
2. Requisitos obligatorios
Todos los requisitos en esta sección son obligatorios para la aprobación del directorio. La falta de cualquiera de estos resultará en rechazo o solicitudes de revisión.
¿Se requieren anotaciones de seguridad?
SÍ - Cada herramienta DEBE tener anotaciones de seguridad precisas.
Requerido en cada herramienta:
readOnlyHint: true - Para herramientas que solo leen datos
destructiveHint: true - Para herramientas que modifican datos o tienen efectos secundarios
Consulta MCP Protocol - Anotaciones de herramientas para el esquema completo y detalles de implementación.
No es opcional. Este es un requisito obligatorio derivado de la Política del Directorio MCP.
Cómo decidir qué anotación usar:
Comportamiento de la herramienta | Anotación | Ejemplos |
Solo lee datos | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
Escribe/modifica datos | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
Crea archivos temporales | destructiveHint: true | Incluso las escrituras temporales cuentan |
Envía solicitudes externas | destructiveHint: true | Correos electrónicos, notificaciones, webhooks |
Solo almacena en caché internamente | readOnlyHint: true | La optimización interna está bien |
Anotación adicional recomendada:
title - Nombre de herramienta legible por humanos para visualización en la interfaz (mejora la experiencia del usuario)
¿Necesito proporcionar cuentas de prueba?
SÍ - Si tu servidor requiere autenticación.
Qué proporcionar:
Credenciales de cuenta de prueba (nombre de usuario/contraseña o claves API)
Datos de ejemplo en la cuenta (necesarios para pruebas funcionales)
Instrucciones de configuración para el entorno de prueba
Limitaciones de acceso (si las hay)
Las cuentas de prueba deben tener:
Acceso a todas las herramientas siendo revisadas
Datos de ejemplo representativos
Permisos apropiados para pruebas de funcionalidad completa
Estado activo durante el período de revisión y más allá
Cómo proporcionar:
Incluye credenciales en el formulario de envío (idealmente compartidas mediante un método seguro, como un enlace de 1Password)
Asegúrate de que las cuentas permanezcan activas durante y después de la revisión para revisiones periódicas posteriores a la admisión
Proporciona acceso suficiente para pruebas exhaustivas
¿Se requiere OAuth 2.0?
SÍ - Si tu servidor requiere autenticación.
Requisitos de implementación de OAuth:
Debe usar el flujo de código de autorización OAuth 2.0
Certificados de autoridades reconocidas
Lista blanca de cliente MCP local (p. ej. Claude Code, MCP Inspector) URLs de devolución de llamada:
http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
Lista blanca de URLs de devolución de llamada de Claude:
Configuración adecuada del URI de redirección
Problemas comunes de OAuth a evitar:
Errores de URI de redirección inválido (asegúrate de que ambas URLs de devolución de llamada estén en la lista blanca)
Solicitudes HEAD sin tokens (maneja con elegancia después del flujo OAuth)
Orientación de implementación: Consulta Marco de autorización OAuth 2.0 para detalles completos de implementación de OAuth.
¿Hay requisitos de firewall?
SÍ - Debe permitir las direcciones IP de Claude para compatibilidad con claude.ai
Para servidores detrás de firewalls, permite las direcciones IP de https://docs.claude.com/en/api/ip-addresses.
Requerido para: Claude.ai y Claude Desktop
No requerido para: Claude Code (se conecta directamente desde la máquina del usuario)
Importante: La lista blanca de IP por sí sola no se recomienda como medida de seguridad. Usa OAuth 2.0 para autenticación siempre que sea posible.
¿Qué documentación se requiere?
Documentación completa del servidor con secciones específicas.
Secciones recomendadas:
Descripción del servidor - Explicación clara de qué hace tu servidor
Características - Capacidades clave y casos de uso
Instrucciones de configuración - Cómo los usuarios se conectan y configuran
Autenticación - Configuración de OAuth y requisitos (si aplica)
Ejemplos de uso - Mínimo 3 ejemplos funcionales con indicaciones (requerido)
Política de privacidad - Enlace a la política de privacidad completa
Soporte - Cómo los usuarios pueden obtener ayuda o reportar problemas
Estructura de documentación de ejemplo:
# Servidor MCP de [Tu nombre de servicio]
## Descripción
[Breve descripción de la integración del servicio y capacidades]
## Características
- Característica 1: [descripción y valor]
- Característica 2: [descripción y valor]
- Característica 3: [descripción y valor]
## Configuración
1. Visita el [Directorio MCP de Anthropic](https://claude.com/connectors)
2. Encuentra y conéctate a [Tu servicio]
3. Completa la autenticación OAuth
4. Configura cualquier ajuste requerido
## Autenticación
Este servidor requiere autenticación OAuth. Necesitarás:
- Cuenta válida de [Tu servicio]
- [Cualquier permiso específico o tipos de cuenta]
## Ejemplos
[Ver sección de mínimo 3 ejemplos abajo]
## Política de privacidad
Consulta nuestra política de privacidad: https://tu-dominio.com/privacy
## Soporte
- Correo electrónico: [email protected]
- Documentación: https://tu-dominio.com/mcp-docs
- Problemas: https://github.com/tucompania/mcp-server/issues
¿Cuántos ejemplos de uso se requieren?
MÍNIMO de tres ejemplos funcionales que demuestren la funcionalidad principal.
Qué califica como un buen ejemplo:
Muestra una solicitud/indicación de usuario realista
Demuestra la funcionalidad real del servidor
Incluye salida esperada o comportamiento
Flujo de trabajo claro y comprensible
Cubre diferentes capacidades
Formato de ejemplo:
## Ejemplos
### Ejemplo 1: Buscar documentos
**Indicación del usuario:** "Encuentra reportes de proyectos recientes en mi espacio de trabajo"
**Qué sucede:**
- El servidor busca en tu espacio de trabajo
- Devuelve documentos coincidentes con metadatos
- Proporciona enlaces de acceso rápido
### Ejemplo 2: Crear nuevo contenido
**Indicación del usuario:** "Crea una nueva lista de tareas para la campaña de marketing"
**Qué sucede:**
- El servidor crea una nueva lista de tareas
- Añade estructura inicial basada en contexto
- Devuelve enlace a la lista recién creada
### Ejemplo 3: Actualizar datos existentes
**Indicación del usuario:** "Actualiza el estado del proyecto a 'En progreso' y añade el hito de hoy"
**Qué sucede:**
- El servidor localiza el proyecto
- Actualiza el campo de estado
- Añade hito con la fecha actual
- Confirma los cambios realizados
Requisitos:
Mínimo 3 ejemplos (sin máximo)
Cubren diferentes herramientas/capacidades
Muestran interacciones de usuario realistas
Demuestran la propuesta de valor
Incluidos en la documentación del servidor
¿Cuáles son los requisitos de preparación para producción?
El servidor debe estar en estado de Disponibilidad General (GA).
Listo para producción significa:
El servidor es estable y confiable en producción
No marcado como "beta", "alpha" o "desarrollo"
Todas las características completamente implementadas y probadas
Manejo de errores adecuado y fallos elegantes
Infraestructura escalable y monitoreo
Documentación completa y canales de soporte
No puede ser incluido: Versiones beta, servidores de desarrollo o servicios de acceso limitado.
¿Qué requisitos técnicos deben cumplirse?
Debe cumplir con los estándares técnicos de cumplimiento principal.
Transporte y rendimiento:
Debe soportar transporte HTTP transmisible (el soporte SSE puede quedar obsoleto)
Tiempos de respuesta rápidos con alta disponibilidad
Manejo de errores elegante con mensajes útiles
Respuestas eficientes en tokens (máximo 25,000 tokens por resultado de herramienta)
Seguridad y datos:
HTTPS/TLS con certificados válidos
CORS configurado correctamente para clientes de navegador
Soporte para todos los orígenes de cliente Claude requeridos
Recopila solo datos necesarios para la funcionalidad
Sin recopilación de datos de conversación extraños
Prácticas de datos conformes con privacidad
3. Proceso de envío
¿Cómo envío mi servidor MCP remoto?
Sigue este proceso de envío paso a paso:
1. Lista de verificación previa al envío:
Verifica los requisitos obligatorios:
[ ] Todas las herramientas tienen anotaciones readOnlyHint O destructiveHint
[ ] OAuth 2.0 implementado (si se requiere autenticación)
[ ] Servidor accesible vía HTTPS
[ ] Direcciones IP de Claude en lista blanca (si el servidor está detrás de firewall)
[ ] Documentación completa publicada
[ ] Política de privacidad publicada y accesible
[ ] Canales de soporte dedicados (correo electrónico o web)
[ ] Cuenta de prueba lista (si se requiere autenticación)
[ ] El servidor está listo para producción (estado GA)
Prueba tu servidor:
[ ] Funciona correctamente desde Claude.ai
[ ] Funciona correctamente desde Claude Desktop
[ ] Funciona correctamente desde Claude Code (si no hay restricciones de IP)
[ ] El flujo OAuth se completa exitosamente
[ ] Todas las herramientas funcionan como se documenta
[ ] Los mensajes de error son útiles y amigables
[ ] El rendimiento es aceptable bajo carga
2. Completa el formulario de envío:
Formulario de envío: Formulario de revisión de servidor del Directorio MCP
Información requerida: Detalles del servidor, enlaces de documentación, credenciales de prueba, ejemplos (mínimo 3) e información de contacto. El formulario proporciona una lista completa.
Aunque nos esforzamos por revisar cada envío lo más rápido posible, debido a la cantidad de interés no podemos prometer que aceptaremos tu envío o responderemos individualmente.
4. Problemas comunes
¿Cuáles son las razones más comunes para solicitudes de revisión?
Estos son los principales problemas basados en datos de envío:
1. Anotaciones de herramientas faltantes
Problema: Las herramientas carecen de anotaciones de seguridad requeridas
Solución: Añade readOnlyHint o destructiveHint a TODAS las herramientas
Impacto: Rechazo inmediato, requiere cambios de código
Prevención: Valida todas las herramientas antes del envío
2. Problemas de implementación de OAuth
Problema: El flujo OAuth falla o tiene errores de configuración
Causas comunes:
URLs de devolución de llamada faltantes en el proveedor OAuth
Configuración de URI de redirección inválida
Configuración incorrecta del firewall
Solución: Prueba el flujo OAuth exhaustivamente con MCP Inspector, Claude Code o Claude.ai
Impacto: No se puede completar pruebas funcionales, retrasa la aprobación
3. Documentación incompleta
Problema: Faltan ejemplos, instrucciones de configuración poco claras o secciones requeridas faltantes
Solución: Proporciona mínimo 3 ejemplos detallados y completa todas las secciones de documentación
Impacto: Solicitud de revisión, retrasa la aprobación
Prevención: Sigue la plantilla de documentación exactamente
4. Problemas de preparación para producción
Problema: El servidor está marcado como "beta" o muestra problemas de inestabilidad
Solución: Asegúrate del estado GA e implementación de producción estable
Impacto: No puede ser incluido hasta estar listo para producción
Prevención: Completa pruebas internas y validación de estabilidad
5. Problemas de política de privacidad/canal de soporte
Problema: URLs faltantes o inaccesibles para política de privacidad/canales de soporte
Solución: Proporciona política de privacidad adecuada y canales de soporte (correo electrónico o web)
Impacto: Rechazo inmediato debido a requisito de política
Prevención: Verifica la accesibilidad de política de priv