Ir al contenido principal

Guía de Envío de Servidor MCP Local

Actualizado esta semana

Esta es una guía completa para enviar tu servidor local (MCPB) al directorio público de Anthropic para una distribución y visibilidad más amplia.

Requisitos previos

Antes de leer esta guía, deberías tener:

  • Un MCPB funcional

  • Código portable usando sustitución de variables

  • Buenos mensajes de error y experiencia de usuario

  • Dependencias limpias y empaquetadas

¿Nuevo en el desarrollo de MCPB? Consulta primero Construcción de extensiones MCPB. Para mejores prácticas técnicas (pruebas, mensajes de error, portabilidad), consulta el Repositorio MCPB.

Nota: Esta guía cubre servidores MCP locales. Para extensiones de escritorio remotas, consulta la Guía de envío de servidores MCP remotos.


1. Descripción general del directorio

¿Cuáles son los beneficios de la inclusión en el directorio?

Visibilidad y confianza:

  • Listado en el directorio oficial de Anthropic dentro de Claude Desktop

  • Buscable por usuarios individuales de Claude Desktop

  • Visible para usuarios de Teams/Enterprise cuando los administradores lo agregan a la lista de permitidos

  • La revisión de Anthropic genera confianza en los usuarios

Experiencia de usuario:

  • Instalación con un clic desde el directorio

  • Integrado con la interfaz de configuración de Claude Desktop

  • Presentación estandarizada

Soporte y credibilidad:

  • Revisión de calidad y seguridad por parte de Anthropic

  • Listado junto con otras extensiones revisadas

  • Visibilidad y retroalimentación de la comunidad

  • Canal de distribución profesional


2. Requisitos obligatorios

Todos los requisitos en esta sección son obligatorios para la aprobación del directorio. Faltar cualquiera de estos resultará en rechazo o una solicitud de revisión.

Nota: Estos son requisitos específicos del directorio de Anthropic.

Para mejores prácticas generales de desarrollo de MCPB (pruebas, manejo de errores, portabilidad), consulta el README del Repositorio MCPB.


¿Se requieren anotaciones de herramientas?

SÍ. Cada herramienta DEBE tener y mantener 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 Protocolo MCP - Anotaciones de herramientas para el esquema completo y detalles de implementación.

No es opcional. Este es un requisito estricto 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

search, get, list, fetch, read

Escribe/modifica datos

destructiveHint: true

create, update, delete, send, write

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

Detalles de implementación: Consulta Protocolo MCP - Herramientas para:

  • Esquema completo de herramientas con anotaciones

  • Estructura de definición de herramientas

  • Especificaciones de esquema de entrada/salida

  • Propiedades adicionales de herramientas (incluyendo el campo opcional title)

Validación antes del envío:

# Verificar que todas las herramientas tengan anotaciones

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

# Verificar que cada herramienta tenga exactamente una anotación

Impacto: Lo primero que verificamos y la razón más común para una solicitud de revisión.

Anotación adicional recomendada:

¿Ha quedado contestada tu pregunta?