Usando la aplicación como servidor MCP

La aplicación puede consumir un servidor MCP o exponer su propio servidor a un cliente externo. Estas son direcciones opuestas.

Estos pasos se refieren a las características identificadas en el código de la aplicación. Este material no ha sido validado en una instancia en vivo; consulta la documentación y las opciones de tu versión.

Cómo funciona, paso a paso

Anfitrión, cliente y servidor

MCP es un protocolo que conecta aplicaciones de IA con capacidades externas. El anfitrión proporciona la experiencia, el cliente gestiona la conexión y el servidor expone herramientas, recursos o indicaciones según el soporte. Las herramientas ejecutan operaciones; los recursos proporcionan contenido direccionable; Las indicaciones proporcionan plantillas. No todos los servidores implementan los tres. El transporte transporta mensajes, la autenticación identifica a las personas que llaman y la autorización controla el acceso. Verifique la revisión del protocolo y las extensiones admitidas en ambos extremos. La compatibilidad no se puede inferir únicamente de una etiqueta "MCP".

Comprobar el acceso antes de su uso.

Los servidores y la capa de datos deben hacer cumplir los permisos. No permita que el modelo decida si un usuario puede ver un documento. Filtre las fuentes antes de que entren en contexto, no después de generar la respuesta. Utilice credenciales de acceso mínimo, manténgalas alejadas de mensajes, capturas de pantalla y códigos del navegador, y rote las claves expuestas. Una lista de dominios permitidos de widget no reemplaza la autenticación API. La autenticación le identifica; La autorización determina las operaciones y los datos que puede utilizar. Pruebe también el acceso denegado.

El modelo propone, la herramienta ejecuta

La llamada a herramientas produce una solicitud de llamada con un nombre y argumentos. La aplicación valida el esquema, permisos y límites antes de la ejecución. El resultado vuelve al contexto para el siguiente paso. Por ejemplo, get_product_stock toma un SKU y devuelve una cantidad; su descripción debe explicar que no reserva productos. Distinga resultados vacíos, errores de validación, accesos faltantes y tiempos de espera. Un JSON válido no prueba que los argumentos sean correctos ni que la acción esté autorizada. Para efectos externos, considere también la ejecución duplicada.

El esquema explicativo

Siga las flechas sólidas para el flujo principal. Las flechas azules discontinuas proporcionan datos o contexto; Las flechas discontinuas de color rosa muestran comentarios o resultados devueltos. Colores y formas distinguen modelos, tiendas, decisiones y resultados. En pantallas pequeñas, desplázate horizontalmente para seguir todo el esquema.

Un ejemplo completo

El /api/mcp local está protegido por una clave configurada para la implementación. Las herramientas exponen la administración del agente, RAG, flujo de trabajo, widget y servidor MCP; algunos crean o eliminan datos.

Pruébalo tú mismo

1. Configure un cliente de prueba con el secreto proporcionado por el administrador e inspeccione las herramientas antes de las llamadas.
2. Registre la entrada, la fuente y el resultado esperado antes de ejecutar el experimento. Utilice únicamente los datos ficticios del ejemplo.
3. Siga las etapas del diagrama. En cada paso registre qué información se recibe y se produce; No confunda el resultado intermedio con el resultado final.
4. Repita después de eliminar la información necesaria o hacer que la entrada sea ambigua. Compruebe si el sistema aclara, detiene o inventa una respuesta.
5. Comparar con la solución explicada. Conserve la configuración, fecha, resultado y una explicación de las diferencias. Cambie una cosa y vuelva a probar.

Una solución explicada

Comience con descubrimientos y lecturas; verifique los argumentos de la organización/proyecto y no asuma una clave de usuario ordinaria. Un ejercicio exitoso le permite mostrar la conexión entre los aportes, las etapas y el resultado. Cuando falta información, una respuesta cautelosa es más útil que detalles inventados. Compare más que estilo: compruebe también las condiciones, las fuentes y las operaciones.

Cuándo resulta útil y cuáles son sus límites

El servidor local anuncia herramientas; no asuma recursos, indicaciones ni complete OAuth. Elija este enfoque cuando mejore una necesidad medida. Mantenga una línea de base simple y compare los resultados utilizando insumos idénticos. Un ejemplo exitoso no establece confiabilidad en todas las situaciones.

Comprueba lo que has aprendido

¿Un servidor con herramientas ofrece automáticamente recursos e indicaciones?

No. Las capacidades son opcionales y deben descubrirse y comprobarse.

¿Por qué eliminar una fuente privada después de responder es demasiado tarde?

Los datos ya han entrado en el contexto del modelo y pueden divulgarse.

¿Qué resultado debería producir este ejercicio?

Comience con descubrimientos y lecturas; verifique los argumentos de la organización/proyecto y no asuma una clave de usuario ordinaria.

Términos que conviene recordar

• servidor MCP: Un servicio que expone capacidades a través del Protocolo de contexto modelo.
• Autorizar / Autorización: Comprobar el derecho de acceso a una operación o recurso.
• Llamada de herramientas: una solicitud estructurada para utilizar una capacidad externa.

Fuentes y su próximo paso

• Model Context Protocol — especificación
• OWASP — Inyección de instrucciones
• LangGraph — Flujos de trabajo y agentes

Para preparar: M04: creación de un servidor MCP mínimo