Una herramienta es una interfaz para consultar información o ejecutar una acción. Puede buscar un documento, leer un registro, calcular un total o guardar un cambio. El modelo puede proponer cómo usarla, pero el servicio controla la operación real. Tener acceso a una herramienta no significa acceso a cualquier recurso.
Una API permite intercambiar solicitudes y respuestas estructuradas. Un conector acerca esa capacidad a una aplicación. MCP es un protocolo para exponer herramientas y recursos a clientes compatibles; no garantiza por sí mismo exactitud, permisos ni calidad de una integración. Para un usuario de negocio, importa qué operación está disponible y cómo se verifica.
Recuperar información relevante
La recuperación de documentos entrega material al modelo para una tarea; suele llamarse RAG cuando se combina con generación. Recuperar no es entrenar el modelo con esos archivos. Tampoco garantiza que encuentre el fragmento correcto o respete toda su condición.
Comprueba identidad del documento, versión, fragmentos y permisos. Una búsqueda de «descuento permitido» puede devolver una política antigua o una excepción de otro cliente. El resultado debe incluir evidencia suficiente para comprobar su pertinencia.
Un contrato para cada operación
Describe entrada, salida, permisos y errores. Para leer: ID exacto, alcance y fecha de actualización. Para escribir: objeto, cambio solicitado, validaciones previas y confirmación. Define qué ocurre si el objeto no existe o si cambió desde la lectura.
Evita operaciones ambiguas como «actualiza el cliente importante». Resuelve la identidad antes de escribir. Cuando haya dos cuentas con nombres similares, pide o busca el identificador; no elijas por semejanza.
Escrituras que pueden fallar a medias
Si una solicitud expira, la operación puede haber ocurrido. Consulta el estado antes de repetir. Un mecanismo de idempotencia, cuando la integración lo soporta, permite reconocer intentos de una misma acción y reducir duplicaciones. No basta con pedir al modelo que recuerde no duplicar.
Prueba primero con lectura y con un entorno controlado para cambios. El responsable técnico implementa controles; el dueño del proceso define qué significa una actualización válida. Para aprobar la integración, ambos necesitan ver resultados, fallos y recuperación.
Caso resuelto
Andina Equipos tiene dos clientes llamados Transporte Norte. Una herramienta recibe sólo el nombre y actualiza el contacto incorrecto: el fallo comenzó en la identidad. Una operación bien definida exige ID, lectura del registro y confirmación del cambio propuesto.
Si guardar devuelve un error de tiempo, el sistema consulta el estado y verifica si la actualización está presente. Sólo reintenta si el resultado permite hacerlo sin duplicar ni sobrescribir un cambio posterior.
Instrucciones para practicar
Antes de proponer una escritura, identifica el objeto por ID y consulta su estado.
Presenta campo actual, cambio solicitado y fuente de autorización.
Después, comprueba la confirmación y vuelve a leer cuando sea necesario.
Si el resultado es ambiguo, detén el reintento y solicita verificación.
Ahora te toca
Define el contrato de una herramienta que lee una oportunidad y otra que registra una próxima acción. Incluye datos obligatorios, permisos, errores y tratamiento de una respuesta ambigua.
Ver solución comentada
La lectura usa ID y devuelve estado, versión y fuente. La escritura exige ID de oportunidad, ID único de acción, contenido, responsable, autorización y versión esperada si se soporta. El servicio valida permisos y devuelve confirmación. Ante ambigüedad se consulta el ID de acción; no se crea otra acción sin verificar.