Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Un complemento de Microsoft 365 Copilot conecta experiencias de Microsoft compatibles con herramientas proporcionadas por un servidor remoto de Protocolo de contexto de modelo (MCP). El paquete de complementos contiene la configuración de la conexión y el servidor se ejecuta por separado.
Usa Work IQ Dev Tools (WIQD) para crear, validar y empaquetar tu plugin. Comience con Crear un complemento con las herramientas de desarrollo de Work IQ.
En las secciones siguientes se explica la configuración subyacente para los desarrolladores que necesitan editar el manifiesto manualmente. Registra el servidor MCP remoto del complemento en la agentConnectors matriz del manifiesto de la aplicación Microsoft 365. Este identificador de esquema permanece agentConnectors aunque el paquete instalable se llame complemento.
Importante
Esta configuración usa el manifiesto de la aplicación Microsoft 365, no el manifiesto del complemento MCP que se usa para las acciones de agente declarativo. También es independiente de la ruta de registro de la CLI de Agent 365. Para obtener esas alternativas, consulte Compilación o reutilización de servidores MCP. La compatibilidad con MCP por sí sola no establece la compatibilidad con este modelo de registro.
Requisitos previos
Antes de comenzar, asegúrate de que tienes:
- Un inquilino de prueba y una experiencia de Microsoft de destino que admite complementos configurados a través de
agentConnectors - Un servidor MCP en funcionamiento con un punto de conexión HTTPS de acceso público, TLS 1.2 o posterior, y un transporte compatible con la experiencia de destino.
- Un paquete de aplicación de Microsoft 365 con una versión de manifiesto compatible con la experiencia de destino y el tipo de autorización elegido.
- Una configuración de autorización registrada para el servidor, como una configuración de OAuth o una configuración de clave API, a menos que el servidor permita el acceso anónimo.
Para conocer los requisitos del servidor WIQD y el requisito de descripción de la herramienta Copilot Cowork, consulte Herramientas de desarrollo de Work IQ.
Agregar el servidor MCP al manifiesto de la aplicación
Declare el servidor MCP en la matriz agentConnectors en el nivel raíz del manifiesto de la aplicación.
- Abra el manifiesto de la aplicación en el paquete de la aplicación de Microsoft 365.
- Busque o cree la matriz de nivel
agentConnectorsraíz. - Agregue una entrada con un , ,
displayNameadescriptiony atoolSourceúnicosidque identifiquen el servidor MCP remoto.
El siguiente JSON es un fragmento para combinar en el manifiesto de la aplicación existente, no un manifiesto de aplicación completo:
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.30/MicrosoftTeams.schema.json",
"manifestVersion": "1.30",
"agentConnectors": [
{
"id": "my-mcp-server",
"displayName": "My Automation Server",
"description": "Provides workflow automation and task management tools.",
"toolSource": {
"remoteMcpServer": {
"mcpServerUrl": "https://mcp.example.com/mcp",
"authorization": {
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
},
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
}
}
]
}
Reemplace el punto de conexión y la referencia de autorización por los valores del servidor. Cada entrada debe ser única dentro de idagentConnectors. Mantenga las otras propiedades de manifiesto de aplicación necesarias en el archivo existente.
Configurar el punto de conexión del servidor
Establezca toolSource.remoteMcpServer.mcpServerUrl en el punto de conexión HTTPS. Confirme que se puede llegar al servidor desde la experiencia de destino y responde a la inicialización de MCP y a las solicitudes de protocolo posteriores.
Configurar autenticación
Establecer authorization en agentConnectors[].toolSource.remoteMcpServer. En la tabla siguiente se enumeran los tipos de autorización y su configuración. Para obtener más información, consulte el esquema de autorización.
| Tipo de autorización | Configuración |
|---|---|
None |
No se requiere autenticación. Úselo solo cuando el servidor permita el acceso anónimo. |
OAuthPluginVault |
Configuración de OAuth almacenada en el almacén de Microsoft y referenciada por id. |
ApiKeyPluginVault |
Configuración de clave de API almacenada en un almacén y referenciada por ID. |
DynamicClientRegistration |
Configuración de registro de cliente de OAuth dinámico referenciada por ID. |
AzureKeyVault |
Configuración de Azure Key Vault referenciada por el identificador. Requiere soporte técnico del host. |
ConnectionVault (versión preliminar para desarrolladores) |
Configuración de conexión referenciada por el identificador. |
Un valor de esquema no garantiza la compatibilidad en la experiencia de destino. Compruebe los requisitos de autenticación antes de elegir un método.
Identifica referenceId una configuración adquirida por separado del manifiesto. No coloque claves de API, tokens de acceso, secretos de cliente o valores secretos en este campo ni en ninguna otra parte del manifiesto de la aplicación.
Usar la autenticación OAuth
Para los tokens de OAuth 2.0 almacenados en el almacén de Microsoft, use el siguiente authorization objeto:
{
"type": "OAuthPluginVault",
"referenceId": "my-oauth-config"
}
Registre la configuración de OAuth en el Portal para desarrolladores y use el id. de configuración devuelto como referenceId. Para obtener más información, consulte Configurar OAuth en el Portal para desarrolladores.
Agregue la siguiente dirección URL de devolución de llamada a los URI de redireccionamiento permitidos en el registro del proveedor de OAuth:
https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
Uso de la autenticación de claves API
Para una clave de API almacenada en un almacén, utilice el siguiente authorization objeto:
{
"type": "ApiKeyPluginVault",
"referenceId": "my-apikey"
}
Registre la clave en el Portal para desarrolladores y luego reemplácela my-apikey con el identificador de registro devuelto. Para obtener más información, consulte Autenticación de claves API.
Usar el registro de cliente dinámico
El registro dinámico de clientes permite al host registrarse como cliente OAuth con el servidor MCP mediante RFC 7591. Ambos deben admitir el flujo de registro. Microsoft Entra ID no proporciona un punto de conexión de registro RFC 7591; usar el registro de OAuth estático para un servidor protegido por Entra.
Utilice el siguiente authorization objeto:
{
"type": "DynamicClientRegistration",
"referenceId": "my-dcr-config"
}
Registre la configuración en el Portal para desarrolladores y reemplácela my-dcr-config con su ID de referencia. La configuración proporciona los valores de autorización que usa el host al negociar las credenciales de cliente.
El servidor debe:
- Exponer un punto de conexión de registro de cliente RFC 7591.
- Devuelva la información de registro del cliente requerida por el flujo de OAuth del host.
- Actualización del token de soporte cuando sea necesario para sesiones de larga duración.
Uso de la autenticación de Azure Key Vault
AzureKeyVault se incluye en los esquemas de manifiesto de la aplicación 1.29 y 1.30. Úselo solo cuando la experiencia de destino documente una integración de Azure Key Vault y un proceso para adquirir la referencia de configuración.
Utilice el siguiente authorization objeto:
{
"type": "AzureKeyVault",
"referenceId": "my-keyvault-config"
}
Siga los requisitos de acceso y almacenamiento de credenciales de la integración, y reemplácelos my-keyvault-config por la referencia devuelta. La declaración de manifiesto por sí sola no concede acceso a los secretos.
Uso de la autenticación de Connection Vault
Nota
La autenticación de Connection Vault está disponible en versión preliminar para desarrolladores. Use el esquema de manifiesto de la aplicación de vista previa para desarrolladores para configurar ConnectionVault; no está disponible en los esquemas de manifiesto de aplicación disponibles con carácter general.
Para una integración compatible de conexión y almacén, utilice el siguiente authorization objeto:
{
"type": "ConnectionVault",
"referenceId": "shared_example"
}
Reemplácelo shared_example por la referencia de conexión proporcionada por la integración de destino.
No utilizar ninguna autenticación
Si su servidor permite el acceso anónimo, establézcalo authorization.typeNone u omita authorization cuando el host lo permita.
Prefiera el acceso autenticado para escenarios empresariales y de producción, y OAuth sobre claves de API cuando se admita.
Definir detección de herramientas
Use definiciones de herramientas empaquetadas cuando el conjunto de herramientas sea fijo o detección dinámica cuando tanto la versión del manifiesto de la aplicación como el host de destino lo admitan.
Usar definiciones de herramientas estáticas
Incluye un archivo de descripción de la herramienta en el paquete de la aplicación y haz referencia a él en remoteMcpServer. La ruta de acceso es relativa al paquete de la aplicación. Use las definiciones de herramientas del resultado del tools/list servidor, incluido el nombre, la descripción y el esquema de entrada de cada herramienta. Por ejemplo, un archivo mínimo toolDescription.json puede contener:
{
"mcpToolDescription": {
"file": "toolDescription.json"
}
}
{
"tools": [
{
"name": "get_task",
"description": "Gets a task by its identifier.",
"inputSchema": {
"type": "object",
"properties": {
"taskId": {
"type": "string",
"description": "The identifier of the task."
}
},
"required": [
"taskId"
]
}
}
]
}
Mantenga la coherencia de las definiciones empaquetadas con el servidor.
Uso de la detección dinámica de herramientas
La detección dinámica permite a un host capturar la lista de herramientas en tiempo de ejecución, en tools/list lugar de depender de definiciones empaquetadas.
La versión del manifiesto de la aplicación 1.29 o posterior permite omitir mcpToolDescription. Las versiones anteriores requieren el archivo.
Copilot Cowork sigue requiriendo un archivo de descripción de la herramienta, incluso con la versión 1.29 o posterior. Con WIQD, suministre a través de ; consulte Herramientas de desarrollo de --tool-descriptionWork IQ.
Para una experiencia de destino que admita la detección dinámica, omita mcpToolDescription para que pueda recuperar definiciones a través de tools/list. Devuelva los nombres de las herramientas, las descripciones y los esquemas de entrada, y pruebe cómo se actualizan los cambios en el conjunto de herramientas.
Validar y probar el complemento
Valida el paquete antes de la implementación y luego pruébalo en la experiencia de destino:
- Valide el manifiesto completo de la aplicación con respecto a su esquema declarado y use la validación de paquetes de la aplicación en el Portal para desarrolladores.
- Compruebe que el punto de conexión responde a la inicialización de MCP y que el archivo empaquetado o
tools/listproporciona definiciones de herramienta válidas. - Implemente el paquete en el inquilino de prueba a través del proceso compatible de la experiencia de destino. Complete cualquier configuración de acceso o aprobación de administrador requerida. La implementación no reemplaza el inicio de sesión del usuario, el consentimiento ni los permisos del servicio de origen.
- Pruebe indicaciones para las operaciones que expone su servidor, como "Buscar problemas abiertos asignados a mí" o, para un servidor con herramientas de escritura, "Actualizar el estado del ticket número 123".
- Compruebe que las herramientas previstas estén disponibles, que las solicitudes de consentimiento aparezcan cuando sea necesario y que las llamadas a herramientas devuelvan los resultados esperados. Pruebe la actualización del token de OAuth cuando corresponda.
- Compruebe si hay entradas no válidas, servicios no disponibles, errores de autorización y tiempos de espera, incluido el comportamiento de reintento.
- Pruebe entre inquilinos si su escenario requiere compatibilidad con varios inquilinos.
Solución de problemas comunes
| Síntoma | Cheque |
|---|---|
| No se puede conectar al servidor | Accesibilidad de puntos de conexión, HTTPS, compatibilidad con transportes, configuración de firewall e inicialización de MCP. |
| Las herramientas no aparecen | Ruta de acceso al archivo empaquetado y definiciones válidas, o compatibilidad con detección dinámica con mcpToolDescription omitido y un archivo en funcionamiento tools/list. |
| Error de autenticación | Encabezados de autorización de referenceIdsalida, validez, credenciales, permisos, consentimiento y credenciales. |
| Error o tiempo de espera agotado de las llamadas a herramientas | Registros de servidor, validación de entradas, formato de respuesta MCP, simultaneidad, tiempos de espera y reintentos. |
Pasos siguientes
Cuando la integración esté lista, empaqueta el complemento y sigue un método de publicación o uso compartido compatible.