MCP y API: una interfaz común para usar herramientas

  • inteligencia-artificial

Una aplicación puede consultar incidencias en GitHub, correo en Gmail y documentos en otro servicio. Cada integración exige autenticación, construcción de solicitudes, interpretación de respuestas y manejo de errores. Si varias aplicaciones repiten esas conexiones, aumenta el trabajo específico de integración.

Qué hace el modelo y qué hace el software

El modelo puede proponer consultar las incidencias abiertas sobre autenticación. El software que lo rodea ejecuta la operación, aplica permisos y devuelve el resultado. Una intención expresada por el modelo no es por sí sola una llamada autorizada ni una conexión directa al servicio.

Host, cliente y servidor

MCP, Model Context Protocol, organiza la comunicación entre un host, sus clientes MCP y servidores que exponen capacidades. El host coordina la experiencia y los controles; el cliente mantiene la relación de protocolo con un servidor. Ese servidor puede adaptar una API existente, acceder a una base de datos o realizar una operación local.

Arquitectura conceptual de una herramienta. Un servidor MCP también puede trabajar con recursos locales sin una API HTTP subyacente.
Arquitectura conceptual de una herramienta. Un servidor MCP también puede trabajar con recursos locales sin una API HTTP subyacente.

Descubrir y llamar una herramienta

En la especificación de referencia consultada, el descubrimiento de herramientas utiliza tools/list. Cada herramienta incluye nombre, descripción y esquema de entrada. La aplicación puede presentar esas capacidades al modelo y solicitar una invocación mediante tools/call, validando antes los argumentos y las condiciones de ejecución.

Pseudocódigo
1. Host conecta un cliente al servidor MCP.
2. Cliente descubre herramientas y sus esquemas.
3. Modelo propone buscar incidencias de autenticación.
4. Host valida alcance, argumentos y autorización.
5. Servidor MCP llama a la API de GitHub.
6. El resultado vuelve al host para elaborar la respuesta.

MCP también contempla recursos y prompts, además de herramientas. Sus capacidades se negocian; no debe suponerse que cualquier servidor implementa todo. Aquí se usa la especificación fechada 2025-06-18 para fijar la terminología y evitar presentar detalles variables como universales.

La API sigue existiendo

Un servidor que ofrece buscar_incidencias puede convertir los argumentos a una petición normal de GitHub. MCP uniforma la capa que ve el cliente, pero la lógica específica del proveedor permanece en el adaptador. Reutilizar ese servidor puede reducir duplicación entre hosts compatibles; no elimina credenciales, límites de tasa, errores ni mantenimiento.

Un protocolo no sustituye la confianza

Una descripción de herramienta ayuda a elegirla, pero no garantiza que sea segura o que su respuesta sea correcta. Deben aplicarse mínimos permisos, separación entre lectura y escritura y controles acordes con el efecto de la operación. El contenido devuelto por un servicio se trata como datos y no como una nueva autoridad sobre las instrucciones de la aplicación.

La utilidad de MCP aparece cuando distintas aplicaciones necesitan descubrir e invocar herramientas mediante un contrato común. Para una conexión única y estable, una integración directa con una API puede seguir siendo suficiente. Son capas que se complementan.

Referencias