¿Qué es MCP?
MCP significa Protocolo de Contexto de Modelo, un estándar abierto creado por Anthropic que permite que las aplicaciones de IA se conecten a herramientas y fuentes de datos. Para obtener información completa sobre MCP y cómo comenzar, consulte nuestra guía de MCP remoto: Introducción a Conectores Personalizados Usando MCP Remoto.
¿Qué es el Directorio de Conectores?
El Directorio de Conectores tiene como objetivo mostrar servidores del Protocolo de Contexto de Modelo que funcionan con Claude en todas nuestras plataformas: Claude web, Claude Desktop, nuestras aplicaciones móviles de Claude, Claude Code y nuestra API. El Directorio de Conectores sirve como un único centro donde los usuarios pueden descubrir servidores MCP que Anthropic ha revisado.
¿Cómo hago que mi MCP aparezca en el directorio?
Puede completar nuestro formulario de revisión del servidor del Directorio de Conectores y nos comunicaremos con usted sobre los próximos pasos si su MCP sería una buena opción para el directorio en este momento.
¿Hay estándares que mi MCP deba cumplir para ser incluido en el directorio?
Sí, los servidores deben cumplir con los estándares de seguridad, seguridad de datos y compatibilidad establecidos en nuestra Política del Directorio MCP. El cumplimiento de estos estándares no garantiza la inclusión en el directorio.
Completé el formulario de envío pero aún no he recibido respuesta, ¿cuánto tiempo tardará?
Aunque nos esforzamos por revisar cada envío lo más rápido posible, debido al interés abrumador no podemos prometer que aceptaremos su envío o que responderemos a él individualmente.
1. Autenticación y Autorización
¿Se requiere OAuth 2.0 si no necesitamos autenticación de usuario?
OAuth 2.0 solo es obligatorio si se requiere autenticación para el servidor MCP. Los servidores que no requieren autenticación no requieren OAuth.
¿Claude admite el flujo OAuth de máquina a máquina (credenciales de cliente)?
No. El flujo puro de credenciales de cliente (OAuth de máquina a máquina con solo client_id/client_secret y sin interacción del usuario) no es compatible. Podemos proporcionar un client_id/client_secret estático para Claude, pero los usuarios aún deben completar un flujo de consentimiento de OAuth para autenticar sus cuentas individuales. Esto funciona en claude.ai y Claude Desktop, pero no en Claude Code porque Claude Code establece conexiones directamente desde la computadora del usuario a su servidor MCP (y por lo tanto no tienen acceso a las credenciales estáticas).
¿Podemos identificar usuarios individuales sin implementar OAuth?
No. OAuth es la única forma de identificar de forma única a los usuarios. No reenviamos direcciones IP, ID de usuario u otros metadatos de usuarios finales a servidores MCP.
¿Dónde ocurre la comunicación del servidor MCP: del lado del cliente o en los servidores de Anthropic?
Depende de la superficie del producto. La comunicación ocurre a través de servidores de Anthropic (claude.ai, Claude Desktop), su navegador o sus clientes locales (Claude Code). Actualmente no hay un método de conexión centralizado en todas las superficies.
Para servidores MCP remotos (conectores agregados a través de Personalizar > Conectores), toda la comunicación se origina desde la infraestructura en la nube de Anthropic. Esto es cierto independientemente de qué superficie de cliente esté utilizando la persona: claude.ai, Claude Desktop, Cowork o aplicaciones móviles de Claude. Su servidor MCP debe ser accesible a través de Internet público desde los rangos de IP de Anthropic.
Los servidores MCP locales configurados a través de claude_desktop_config.json en Claude Desktop, o a través de Claude Code, se comunican directamente desde su máquina utilizando redes locales.
¿Pueden los usuarios autenticarse con credenciales personales desde una cuenta de Claude corporativa?
Sí. Los usuarios se autentican con servidores MCP por servidor. Pueden usar credenciales de autenticación personales para servidores MCP incluso cuando han iniciado sesión en claude.ai con una cuenta corporativa.
¿Podemos implementar OAuth por herramienta en lugar de OAuth por servidor?
No. OAuth ocurre cuando el cliente se conecta al servidor MCP, no a nivel de herramienta. Puede aplicar permisos a nivel de herramienta basados en la autenticación del usuario después de que se establezca la conexión del servidor.
Cuando un usuario desconecta una herramienta MCP, ¿se revocan los tokens de OAuth?
Los tokens se eliminan de los sistemas de Anthropic pero no de los suyos. Los tokens de acceso y actualización en su proveedor de identidad permanecen válidos hasta su vencimiento, y las cookies de sesión no se borran (ya que están a nivel del navegador, fuera del control de Claude).
¿Cómo puede nuestro servicio MCP señalar a Claude que la sesión de un usuario no es válida?
Devuelva una respuesta 401 No autorizado. Para activar la regeneración completa de las credenciales del cliente DCR, devuelva un error invalid_client según la sección 5.2 de RFC 6749.
¿Se requieren client_id/client_secret para flujos OAuth estándar?
No. Las credenciales de cliente no son obligatorias para flujos OAuth estándar con autenticación de usuario.
2. Limitación de Velocidad y Prevención de Abuso
¿Cómo podemos implementar limitación de velocidad por usuario sin OAuth?
La limitación de velocidad por usuario requiere OAuth. Sin OAuth, sus opciones son:
Opción 1: Sin autenticación con limitación de velocidad global
Opción 2: Lista blanca de IP usando las IP estáticas de Claude
¿Podemos usar la lista blanca de IP para restringir el acceso al servidor MCP solo a usuarios de Claude?
Recomendamos encarecidamente usar OAuth y no usar lista blanca de IP. Sin embargo, esto es posible usando las direcciones IP estáticas disponibles en https://docs.claude.com/en/api/ip-addresses.
Limitaciones importantes:
Solo funciona para claude.ai y Claude Desktop. Su servidor MCP no funcionará en Claude Code.
Las IP de salida podrían cambiar: se publicará un aviso previo del cambio en la documentación
No se recomienda como medida de seguridad única, pero está bien usarla cuando OAuth no es viable
¿Claude proporciona limitación de velocidad o protección DDoS para servidores MCP?
No. Los propietarios del servidor MCP deben implementar sus propias medidas de limitación de velocidad y prevención de abuso.
3. Límites Técnicos y Restricciones
¿Cuál es el tamaño máximo de token para los resultados de herramientas MCP?
25.000 tokens. Use paginación, filtrado o parámetros de límite para reducir el tamaño de la respuesta si es necesario.
¿Cuáles son los límites de tiempo de espera para herramientas MCP?
Los tiempos de espera varían según el componente:
Claude Code: Configurable a través de la configuración MCP_TOOL_TIMEOUT
Claude.ai y Claude Desktop: 300 segundos (5 minutos)
4. Envío de Directorio y Requisitos
¿Qué tipos de planes de Claude pueden acceder a Conectores?
Todos los usuarios pueden acceder a conectores, excepto los conectores personalizados, que están disponibles solo para planes pagos (Pro, Max, Team y Enterprise).
¿Necesitamos un plan de Claude específico para enviar un MCP al directorio?
No. Cualquier organización puede enviar al directorio independientemente del tipo de plan.
¿Necesitamos proporcionar a Anthropic una cuenta de prueba?
Si tu servidor requiere autenticación / una cuenta para usar, necesitaremos que nos proporciones una cuenta de prueba para propósitos de control de calidad inicial. También es útil incluir datos ficticios en la cuenta para verificar la funcionalidad.
¿Cuántas herramientas debe proporcionar un servidor MCP?
Sin requisito mínimo o máximo. Recomendamos que comiences con un conjunto útil de herramientas y expandas las capacidades con el tiempo.
¿Cuáles son los requisitos de rendimiento para los servidores MCP?
Actualmente no hay requisitos específicos de SLA. Sin embargo, los conectores con problemas de rendimiento o confiabilidad pueden ser eliminados del directorio.
¿Cuáles son las razones más comunes por las que los envíos de MCP se retrasan o se rechazan?
Problema principal: Anotaciones de herramientas faltantes (30% de rechazos)
Requisito: Todas las herramientas DEBEN incluir readOnlyHint o destructiveHint
Impacto: Rechazo inmediato, requiere cambios de código.
No es opcional: Requisito de cumplimiento según la Política del Directorio MCP
Ejemplo:
{
"name": "read_data",
"readOnlyHint": true
}
5. Privacidad de Datos y Aspectos Legales
¿Qué telemetría recopila Anthropic de las llamadas de herramientas MCP?
La telemetría incluye todos los parámetros y datos pasados a las llamadas de herramientas, así como la respuesta del servidor MCP.
¿Se utilizan los datos de MCP para entrenar modelos de Claude?
Solo entrenamos con datos de consumidor cuando los usuarios optan explícitamente. Consulta https://www.anthropic.com/news/updates-to-our-consumer-terms para más detalles. No entrenamos en planes Team/Enterprise.
¿Pueden los servidores MCP identificar en qué SKU de Claude se encuentra el usuario?
No. Los servidores MCP no pueden determinar el SKU de Claude que se está utilizando.
¿Qué significa 'URL del Acuerdo de Procesamiento de Datos' en el formulario de envío?
Proporciona una URL a los términos de procesamiento de datos de tu empresa aplicables al servicio MCP. Esto no necesita ser específico de MCP - tu DPA estándar es aceptable.
¿Están disponibles los conectores globalmente? ¿Podemos restringir por geografía?
Los conectores están disponibles para usuarios de Claude globalmente. La restricción geográfica no es compatible. Puedes guiar al usuario y la comprensión de Claude de cualquier limitación geográfica en tu descripción de MCP o descripciones de herramientas si es necesario (por ejemplo, 'solo organizaciones de EE.UU. disponibles').
¿Dónde puedo encontrar los Términos de Servicio del Directorio MCP y las políticas de datos?
Recursos clave:
¿Cuáles son los requisitos de cumplimiento de protección de datos (por ejemplo, GDPR, CCPA, LGPD) para servidores MCP?
Los servidores MCP deben manejar el cumplimiento independientemente de Claude. Si un usuario ejerce un derecho legal de protección de datos con tu servicio, debes manejarlo por tu cuenta.
¿Dónde debo incluir políticas de privacidad para conectores locales (extensiones de escritorio)?
En tu .mcpb, hay dos ubicaciones requeridas:
1. README.md - Añade una sección 'Política de Privacidad' con URL o texto completo.
2. manifest.json - Añade matriz privacy_policies con URLs HTTPS (requiere manifest_version 0.2+)
Ejemplo:
{
"manifest_version": "0.2",
"privacy_policies": ["https://your-domain.com/privacy"],
...
}
Debe cubrir: Qué datos se recopilan, cómo se usan/almacenan, compartición con terceros, retención e información de contacto. ⚠️ La falta de política de privacidad resultará en un rechazo inmediato.
6. Experiencia del Usuario y Marca
¿Cómo actualizamos el icono de nuestro conector?
Utilizamos el favicon proporcionado por Google, por lo que puedes personalizar la URL del icono de tu conector actualizando el favicon para tu URL de conector. Puedes verificar el icono que usaremos en https://www.google.com/s2/favicons?domain=<YOUR_CONNECTOR_URL>&sz=64
Asegúrate de probar cada tamaño de favicon (16, 32, 48, 64, 96, 128) actualizando la porción &sz= de la URL.
Conectores remotos:
Si usas una URL de icono personalizado: Actualiza el icono en tu URL proporcionada.
Si confías en la detección automática: Los iconos se extraen del favicon indexado por Google en tu URL del servidor MCP. Actualiza tu favicon y espera a que Google lo reindexe.
De lo contrario, proporcione una URL con el favicon que desea usar como su icono.
Conectores locales (extensiones de escritorio): Reemplace `icon.png` en su paquete y redistribuya el paquete `.mcpb` actualizado a los usuarios.
¿Las descripciones del conector en Claude admiten markdown?
Sí. El formato Markdown es compatible en las descripciones del conector.
¿Podemos incluir requisitos de cuenta y enlaces de registro en los detalles del conector?
Sí. Incluya el idioma de requisitos de cuenta (por ejemplo, 'se requiere cuenta registrada gratuita') e hipervínculos a páginas de registro en los detalles del conector.
¿Cómo podemos asegurar que los usuarios vean nuestros Términos de Servicio antes de conectarse?
Implemente una pantalla OAuth. Esta es la única forma de garantizar la visualización de TOS. Sin OAuth, los usuarios podrían teóricamente agregar conectores a Claude Desktop editando directamente claude_desktop_config.json.
¿Podemos mostrar el idioma de consentimiento con enlaces de TOS/Aviso de Privacidad durante la instalación?
Incluya el idioma en la descripción del conector, pero no hay un flujo de consentimiento especial ni ventana emergente. Use una pantalla OAuth para asegurar que los usuarios vean y acepten los términos.
7. Implementación Técnica
¿Es aceptable el transporte SSE o debemos usar HTTP Streamable?
Debe usar HTTP Streamable.
¿Podemos agregar descripciones a nivel de servidor o solo descripciones a nivel de herramienta?
Actualmente solo se admiten descripciones a nivel de herramienta. No existe descripción a nivel de servidor. Esto requiere repetir la orientación de dirección en descripciones de herramientas individuales. Reconocemos que esto es inconveniente y estamos explorando mejoras.
¿Cómo hacemos que los servidores MCP locales (.mcpb) estén disponibles en Claude Code?
Use el marketplace de complementos. Node.js se recomienda sobre Python u otros lenguajes para MCP locales debido a una mejor compatibilidad con el tiempo de ejecución integrado de Claude Desktop.
¿Cuáles son las mejores prácticas de observabilidad para MCP locales en Claude Desktop?
Los MCP locales solo pueden registrarse en ~/Library/Logs/Claude/mcp*.log. Los usuarios deben compartir manualmente archivos de registro para solucionar problemas. La transmisión directa de registros desde servidores MCP locales no es compatible debido a restricciones de seguridad.
8. Pruebas y Depuración
La lista blanca de IP no funciona. ¿Cómo depuramos problemas de conexión?
Elimine temporalmente la lista blanca de IP para verificar que el resto de la configuración sea correcta. Si la conexión funciona sin lista blanca, el problema está en la configuración del filtrado de IP.
¿Qué pruebas debemos completar antes de enviar al directorio?
Las pruebas esenciales previenen el 80% de los retrasos en el envío. Consulte nuestras guías para enviar conectores remotos y locales para obtener mejores prácticas y una lista de verificación previa al envío.
Mi conector personalizado no se conecta o las conexiones se agotan
Esto generalmente significa que su servidor MCP no es accesible desde la infraestructura en la nube de Anthropic.
Cuando agrega un conector personalizado a través de Personalizar > Conectores en cualquier cliente de Claude (incluidos claude.ai, Claude Desktop y Cowork), la conexión a su servidor MCP se origina desde los servidores de Anthropic, no desde su máquina local. Aunque Cowork y Claude Desktop se ejecutan en su computadora, los conectores remotos se intermedian del lado del servidor.
Causas comunes:
Su servidor MCP está dentro de una red corporativa privada, detrás de una VPN o en un rango de IP interno que no es enrutable desde la Internet pública.
Su firewall bloquea conexiones entrantes desde los rangos de IP de Anthropic.
Su red requiere una configuración de proxy o túnel dividido que los servidores de Anthropic no pueden atravesar.
Para resolver esto:
Confirme que su servidor tiene un punto final accesible públicamente. Intente acceder a la URL de MCP de su servidor desde una máquina fuera de su red corporativa (por ejemplo, un dispositivo personal no en VPN o una VM en la nube) para verificar que sea accesible a través de Internet pública.
Agregue a la lista blanca los rangos de IP de Anthropic en su firewall si su servidor es accesible desde Internet pero filtrado. Consulte direcciones IP de Anthropic para obtener la lista actual.
Nota: Los servidores MCP locales configurados en Claude Desktop a través de claude_desktop_config.json son un mecanismo separado que sí utiliza la red local de su máquina. Pero los servidores locales no están disponibles en claude.ai o Cowork.
9. Patrones de Implementación Comunes
¿Qué enfoque de autenticación debemos usar para nuestro MCP?
Elija según sus requisitos de seguridad y restricciones:
Opción 1: Sin Autenticación + Limitación de Velocidad Global
Mejor para: Datos públicos con bajo riesgo de abuso
Implementación más simple, funciona en todas las superficies de Claude
Sin limitación de velocidad por usuario, accesible desde Internet pública
Puede agregar lista blanca de IP para restringir solo al tráfico de Claude
Opción 2: OAuth Completo con Registro de Usuario
Mejor para: Seguridad empresarial, datos sensibles, limitación de velocidad por usuario
Más seguro, funciona en todas las superficies, identificación completa del usuario
Requiere sistema de registro de usuario, implementación más compleja
Enfoque recomendado para sistemas de producción
Opción 3: Lista blanca de IP
Recomendamos fuertemente la Opción 2 sobre la Opción 3, pero si implementar OAuth es realmente inviable, aún puede obtener acceso restringido solo a usuarios de Claude
Sin capacidad para identificar usuarios individuales, pero se restringe a solicitudes desde claude.ai y Claude Desktop.
El servidor MCP no funcionará con Claude Code
Implementación: Usar Claude Static IPs
10. Recursos Clave
Enlaces importantes:
Claude Static IPs: https://docs.claude.com/en/api/ip-addresses
Formularios de Envío del Directorio MCP: https://docs.google.com/forms/d/e/1FAIpQLSeafJF2NDI7oYx1r8o0ycivCSVLNq92Mpc1FPxMKSw1CzDkqA/viewform
Términos del Directorio MCP: https://support.claude.com/en/articles/11697081-anthropic-mcp-directory-terms-and-conditions
Política del Directorio MCP: https://support.claude.com/en/articles/11697096-anthropic-mcp-directory-policy
Política de Consentimiento para Entrenamiento: https://www.anthropic.com/news/updates-to-our-consumer-terms
Especificación del Protocolo MCP: https://modelcontextprotocol.io
Utilidad de Empaquetamiento MCPB de Escritorio Local: https://github.com/anthropics/mcpb
Especificación del Manifiesto MCPB: https://github.com/anthropics/mcpb/blob/main/MANIFEST.md
