Compilar o reutilizar servidores MCP

Utilice la decisión del servidor MCP del plan de componentes para proporcionar herramientas o recursos alojados de forma remota. El servidor MCP en ejecución permanece independiente del paquete de complementos, por lo que debes implementar o confirmar tanto el tiempo de ejecución remoto como la conexión compatible a la experiencia de Microsoft de destino.

Reutilizar un servidor MCP

Antes de crear un servidor:

  1. Identifique un servidor MCP aprobado que exponga las herramientas o los recursos necesarios.
  2. Revise las definiciones, entradas, salidas, errores, anotaciones y comportamiento de confirmación de su herramienta.
  3. Confirme que sus características de transporte, modelo de autenticación y protocolo son compatibles con la experiencia de Microsoft de destino.
  4. Confirme el propietario del servidor, el punto final, la versión, la disponibilidad, el tratamiento de datos, el soporte técnico y el proceso de cambio.
  5. Obtenga acceso y configure la conexión de desarrollo o de prueba.
  6. Pruebe los escenarios de detección, autenticación, invocación y error de representantes de prueba.

Hacer referencia a un servidor MCP no transfiere la responsabilidad de operarlo. Registre el propietario del servicio y el contrato de soporte técnico antes de volver a utilizarlo.

Compilación y funcionamiento de un servidor MCP

Cree un nuevo servidor MCP cuando ningún servidor aprobado cumpla el requisito.

  1. Implemente solo las herramientas y los recursos requeridos por el plan de componentes.
  2. Defina nombres claros, descripciones, entradas, salidas, errores y anotaciones de seguridad.
  3. Implementar la autenticación, la autorización, el acceso a datos y el comportamiento con privilegios mínimos.
  4. Configure el hospedaje, las redes, los secretos, el registro, la supervisión, el escalado y la respuesta a incidentes.
  5. Versión: el comportamiento del protocolo y las expectativas de compatibilidad de documentos.
  6. Pruebe el servidor de forma independiente antes de conectarlo a una experiencia de Microsoft.

GitHub Copilot puede ayudarle con el código del servidor, los esquemas, las pruebas y los cambios en el repositorio. No proporciona el tiempo de ejecución de MCP, el alojamiento, la autenticación o la conexión a Microsoft 365 por sí mismo.

Conectar el servidor

Utilice la integración compatible con la herramienta de desarrollo seleccionada y la experiencia de destino.

Nota

Use WIQD para crear un complemento que haga referencia a un servidor MCP remoto. Para la configuración manual a través de la agentConnectors matriz en el manifiesto de la aplicación de Microsoft 365, consulte Configuración de servidores MCP remotos para complementos de Microsoft 365 Copilot. Esta configuración difiere del manifiesto del complemento MCP utilizado para acciones de agente declarativo. El soporte técnico depende de la experiencia de destino.

Enfoque de desarrollo Empezar con
Herramientas de desarrollo de Work IQ (recomendadas para escenarios compatibles con código profesional) Cree un complemento con las herramientas de desarrollo de Work IQ; para una acción de agente, use el flujo de trabajo de acción de agente de WIQD
Proyecto de agente declarativo existente con el Kit de herramientas de agentes Tutorial de integración de MCP basado en kit de herramientas
Copilot Studio Documentación de Microsoft Copilot Studio
Respuesta de MCP interactiva Agregar aplicaciones de MCP a agentes declarativos
BYO registro del servidor MCP remoto con la CLI de Agent 365 Registrar un servidor MCP remoto en Herramientas de agente

Importante

La ruta MCP de la CLI de Agent 365 CLI BYO MCP está en versión preliminar y utiliza un modelo de registro y administración independiente de un complemento de MCP empaquetado para un agente declarativo de Microsoft 365. Los clientes admitidos documentados son Copilot Studio, Visual Studio Code, Claude Code y CLI de GitHub Copilot. Los agentes declarativos de Microsoft 365 no son compatibles con esta ruta. Los administradores usan las herramientas de agente para revisar, aprobar, dar su consentimiento, bloquear y supervisar el servidor registrado.

Herramientas de desarrollo de Work IQ

El wiqd plugin add connector comando agrega un conector MCP remoto a un paquete de complementos WIQD. Los requisitos del servidor documentados incluyen:

  • HTTPS con TLS 1.2 o posterior.
  • Transporte HTTP transmitible mediante JSON-RPC 2.0.
  • Compatibilidad con tools/list y tools/call.
  • Llamadas a herramientas que se completan en menos de 30 segundos.

Andamios WIQD en la versión del manifiesto 1.29, donde mcpToolDescription es opcional. Si incluye un archivo de descripción de herramienta, pase su ruta relativa a appPackage con wiqd plugin add connector --tool-description <relative-file-path> junto con las opciones de conector necesarias. El archivo al que se hace referencia debe estar incluido en el archivo ZIP. Para conocer el comportamiento actual de detección de Cowork y los requisitos del paquete, consulte Compilar complementos para Copilot Cowork.

Para la autenticación con OAuth o clave de API, primero registre la credencial y agregue solo su identificador de referencia al paquete. No incluya secretos de cliente, claves de API o tokens en el manifiesto. Consulte la referencia de creación del complemento WIQD.

Para la ruta del paquete de complementos WIQD, configure la autenticación y la detección de herramientas en el manifiesto de la aplicación de Microsoft 365. Si en su lugar agrega el servidor como una acción MCP a un agente declarativo, utilice la autenticación de acciones de agente y la detección dinámica o herramientas ancladas para el agente. Siga los requisitos de la integración seleccionada en lugar de copiar la configuración entre modelos de manifiesto.

Confirmar que la funcionalidad MCP funciona

El servidor MCP y su conexión están listos para la integración cuando:

  • El punto de conexión está disponible en el entorno de desarrollo o prueba.
  • La experiencia de destino puede detectar las herramientas o los recursos necesarios.
  • Las operaciones representativas devuelven los resultados estructurados esperados.
  • La autenticación, la autorización, el consentimiento y los permisos funcionan según lo previsto.
  • El comportamiento de confirmación, tiempo de espera, servicio no disponible, entrada no válida y error parcial es comprensible.
  • Los registros y la supervisión proporcionan información suficiente para diagnosticar errores.
  • Se registran el propietario del servidor, la versión, el punto de conexión, el alojamiento, las dependencias, las limitaciones y las pruebas de prueba.

Use la depuración de MCP local y API cuando el servidor no sea accesible públicamente durante el desarrollo.

Continúe con cualquier otro componente del plan. Cuando estén completos, integre y pruebe los componentes.