Comprender los roles de integración
La arquitectura oficial MCP distingue el host de la aplicación, sus clientes y los servidores que exponen capacidades como herramientas y recursos. MCP define cómo se intercambia el contexto. La aplicación aún determina los flujos de trabajo comerciales y las reglas de autorización.
Enumere las tareas específicas a exponer, como leer un documento autorizado o consultar un agregado en particular. El acceso a una conexión de propósito general no confiere permiso para cada conjunto de datos y acción.
Crear un inventario de herramientas
| Atributo de herramienta | Que documentar |
|---|---|
| Propósito | La tarea empresarial a la que sirve la herramienta y cuándo utilizarla |
| Entrada | Estructura, restricciones, valores predeterminados y campos sensibles. |
| Identidad | La identidad del usuario o servicio bajo el cual se ejecuta |
| Tipo de operación | Sólo lectura, escritura u otra acción con efecto externo |
| Salida | Resultados, fuentes, estados de falla y límites de tamaño. |
| Auditoría | Cómo asociar la operación a una solicitud específica |
Validar primero una herramienta de solo lectura
- Confirme las versiones de protocolo, los transportes y las configuraciones de autenticación admitidas por la implementación y el cliente.
- Verifique las herramientas realmente expuestas y habilite solo aquellas necesarias para la tarea.
- Utilice entradas sintéticas para probar el éxito, los permisos insuficientes, el tiempo de espera y la falta de resultados por separado.
- Vuelva a verificar el acceso a fuentes y archivos en la salida, luego verifique el comportamiento después de la revocación.
Distinguir las descripciones de herramientas del permiso de ejecución
Los textos, documentos y páginas web devueltos por una herramienta pueden incluir instrucciones de terceros. Trátelos como contenido empresarial dentro de los permisos existentes del usuario. Para escrituras, envíos externos y otras acciones comerciales, siga las reglas de auditoría y confirmación de la aplicación.
La compatibilidad varía según el cliente MCP y la versión del producto. Valide las definiciones de herramientas publicadas, el mapeo de identidades y las notas de compatibilidad para la integración que está entregando.
