Ir al contenido principal

Construcción de Extensiones de Escritorio con MCPB

Actualizado ayer

Esta guía te ayudará a crear un MCP Bundle (.mcpb) para crear una extensión de escritorio para uso interno, distribución privada, o como base para envío al Directorio de Conectores de Anthropic.

1. Introducción

¿Qué es un MCPB?

Los archivos MCPB (.mcpb) son archivos zip que contienen un servidor MCP local y manifest.json. Permiten instalación de un solo clic en Claude Desktop, similar a las extensiones de navegador.

Características clave:

  • Se ejecuta localmente en la máquina del usuario

  • Se comunica a través del transporte stdio

  • Agrupa todas las dependencias

  • Funciona sin conexión

  • No requiere OAuth

Más información:

¿Cuándo debo usar un servidor local (MCPB) versus un servidor remoto?

Elige un servidor local (MCPB) para:

Sistemas Internos y Seguridad

  • Acceder a sistemas detrás de tu firewall (JIRA, Confluence, wikis internos, bases de datos privadas)

  • Autenticación sin problemas - Utiliza automáticamente las sesiones de SSO y navegador existentes, sin gestión de tokens

  • Cumplimiento de confianza cero - Opera dentro de los límites de tu red corporativa sin exponer recursos internos públicamente

Recursos Locales

  • Acceso directo al sistema de archivos para edición de código y operaciones de Git

  • Integración con herramientas instaladas localmente (Docker, IDEs, bases de datos)

  • Integración de hardware y control de aplicaciones de escritorio

  • Operaciones sensibles a la privacidad que no deben salir de la máquina del usuario

Implementación Empresarial

  • Instalación de un solo clic con tiempo de ejecución Node.js integrado (sin dependencias que gestionar)

  • Sin infraestructura en la nube, configuraciones de VPN o reglas de firewall requeridas

  • Controles a nivel de organización - Los administradores pueden cargar extensiones personalizadas y gestionar el acceso a través de listas de permitidos

  • Control completo sobre autenticación, autorización y registros de auditoría
    ​

Elige un conector remoto para:

  • Servicios en la nube e APIs públicas que requieren infraestructura centralizada

  • Distribución en Claude en web, móvil y escritorio

  • Servicios que necesitan actualizaciones centralizadas en todos los usuarios

  • Flujos OAuth que requieren gestión de tokens del lado del servidor

  • Integraciones públicas utilizadas por múltiples organizaciones

Diferencia clave: Los MCPBs se ejecutan en la máquina del usuario a través del transporte stdio con acceso a recursos locales e internos. Los conectores remotos se ejecutan en tus servidores a través de HTTPS y se acceden a través de la infraestructura de Anthropic.

Uso en el mundo real: Las organizaciones están construyendo MCPBs como proxies seguros para servidores MCP internos, para acceso a documentación interna, y para conectar herramientas de desarrollo mientras mantienen su arquitectura de seguridad.

Para orientación sobre conectores remotos: Consulta Preguntas Frecuentes del Socio MCP para documentación completa de conectores remotos.

2. Primeros Pasos

¿Qué lenguaje de programación debo usar?

Node.js es fuertemente recomendado porque:

  • Se incluye con Claude para macOS y Windows (cero fricción de instalación para usuarios)

  • Los usuarios no necesitan instalación de tiempo de ejecución separada

  • Mejor compatibilidad y confiabilidad con Claude Desktop

  • Soporte extensivo del SDK de MCP

¿Qué plataformas debo soportar?

Claude Desktop se ejecuta en:

  • macOS (darwin)

  • Windows (win32)

Especifica las plataformas soportadas en la sección de compatibilidad de tu manifest.json.

Mejor práctica: Prueba en ambas plataformas incluso si desarrollas principalmente en una.

Detalles de compatibilidad de plataforma: Consulta Especificación de Manifiesto MCPB - Compatibilidad para especificación de plataforma y requisitos de tiempo de ejecución.

¿Cómo creo mi primer MCPB?

Sigue este proceso de cinco pasos:

1. Instala MCPB CLI: npm install -g @anthropic-ai/mcpb

2. Crea tu servidor MCP (consulta SDK de MCP)

3. Ejecuta mcpb init para crear manifest.json

4. Ejecuta mcpb pack para agrupar

5. Instala y prueba en Claude Desktop

Para orientación de implementación detallada:

  • Repositorio MCPB - Guía completa de primeros pasos, uso de CLI y especificaciones

  • Ejemplos de MCPB - Implementaciones de referencia funcionales incluyendo "Hola Mundo"

  • SDK de MCP - Implementación del protocolo central

Para orientación completa sobre desarrollo, pruebas y mejores prácticas, consulta la sección "Para Desarrolladores de Bundles" del README de MCPB.

Importante: Antes de distribuir tu MCPB, revisa la orientación de pruebas y mejores prácticas en el README de MCPB para asegurar calidad.

3. Configuración

¿Qué es manifest.json?

El archivo manifest.json es metadatos requeridos que describen tu MCPB - qué hace, cómo ejecutarlo, qué herramientas proporciona y qué configuración necesita.

Para la información más actualizada, consulta la Especificación oficial de MCPB.

¿Cómo agrego un icono?

Los iconos son opcionales pero recomendados para una apariencia profesional.

Enfoque básico: Incluye el archivo icon.png en el directorio raíz de tu bundle y haz referencia a él en manifest.json.

Requisitos:

  • Nombre de archivo: icon.png (o ruta personalizada)

  • Tamaño: 512×512px recomendado (mínimo 256×256px)

  • Formato: PNG con soporte de transparencia

  • Ubicación: Raíz del bundle o ruta especificada

Opciones avanzadas: Múltiples variantes de icono para diferentes tamaños y temas (soporte de modo claro/oscuro).

Detalles de implementación: Consulta Especificación de Manifiesto MCPB - Iconos para:

  • Configuración del campo de icono

  • Sintaxis de múltiples variantes de icono

  • Especificaciones de tamaño y tema

  • Mejores prácticas y requisitos

¿Cómo configuran los usuarios mi MCPB?

Define la sección user_config en manifest.json. Claude Desktop crea automáticamente una interfaz de configuración donde los usuarios pueden configurar tu extensión.

Consulta Especificación de Manifiesto MCPB - Configuración de Usuario para la implementación completa:

  • Esquema completo y ejemplos

  • Todos los tipos de configuración y propiedades

  • Restricciones de validación

  • Manejo de datos sensibles

  • Patrones de selección múltiple

¿Cómo instalan los usuarios mi MCPB?

Hay tres métodos de instalación diferentes:

  1. Doble clic - Descarga el archivo .mcpb y haz doble clic para abrir

  2. Arrastrar y soltar - Arrastra el archivo .mcpb a la ventana de Claude Desktop

  3. Menú de archivo - Desarrollador → Extensiones → Instalar Extensión → selecciona archivo .mcpb

Todos los métodos abren la interfaz de instalación donde los usuarios pueden:

  • Revisar detalles de la extensión y permisos

  • Configurar ajustes requeridos

  • Otorgar permisos necesarios

  • Completar la instalación

Alcance de instalación: Instalación por usuario - cada usuario debe instalar por separado en su propio sistema.

Experiencia del usuario y controles de administrador: Para información detallada sobre la experiencia de instalación del usuario final y controles de administrador empresarial (incluyendo gestión de organizaciones de Equipo/Empresa y configuración de políticas), consulta:

4. Recursos

Documentación Oficial

Marco MCPB:

Protocolo MCP:

Claude Desktop:

Obtener Ayuda

Canales de soporte:

Recursos de la comunidad:

  • Consulta las discusiones del repositorio para preguntas y respuestas de la comunidad

  • Sigue las notas de versión para las últimas actualizaciones

  • Revisa ejemplos para patrones de implementación

¿Listo para Distribución Pública?

Si has construido un MCPB funcional y deseas enviarlo al Directorio de Anthropic para distribución más amplia y descubribilidad, consulta nuestra guía complementaria: Envío al Directorio de Anthropic.

La guía del directorio cubre requisitos adicionales incluyendo:

  • Anotaciones de herramientas obligatorias para todas las herramientas

  • Requisitos de política de privacidad

  • Mínimo de tres ejemplos funcionales

  • Credenciales de prueba (si aplica)

  • Proceso de envío completo y cronograma de revisión

Artículos relacionados
Introducción a los Servidores MCP Locales en Claude Desktop
Preguntas Frecuentes del Directorio de Conectores de Anthropic
Habilitación y uso de la lista de permitidos de extensiones de escritorio
Implementación de servidores MCP de nivel empresarial con extensiones de escritorio
Guía de Envío de Servidor MCP Local
¿Ha quedado contestada tu pregunta?