Cargando
Cargando

Ahora que hemos construido nuestro servidor MCP, repasemos las tres primitivas principales del servidor y entendamos cuándo usar cada una. La idea clave es que cada primitiva está controlada por una parte diferente de la pila de tu aplicación.

Comparación de herramientas, recursos e indicaciones: Claude controla las herramientas, nuestra app controla los recursos, el usuario controla las indicaciones.

Herramientas: controladas por el modelo

Las herramientas están controladas completamente por Claude. El modelo de IA decide cuándo llamar a estas funciones, y Claude usa los resultados directamente para lograr las tareas.

Usa herramientas cuando quieras darle a Claude capacidades adicionales. Por ejemplo, si le pides a Claude que calcule la raíz cuadrada de 3 usando JavaScript, Claude decidirá automáticamente usar una herramienta de ejecución de JavaScript para proporcionar la respuesta.

Comparación de las tres primitivas del servidor MCP: Claude controla las herramientas, nuestra app controla los recursos y el usuario controla las indicaciones.

La decisión de usar la herramienta fue 100% controlada por el modelo: Claude reconoció que necesitaba ejecutar código y eligió la herramienta apropiada sin ninguna indicación por parte de la aplicación o el usuario.

Recursos: controlados por la app

Los recursos están controlados por el código de tu aplicación. Tu app decide cuándo obtener los datos del recurso y cómo usarlos, típicamente con fines de interfaz de usuario o para agregar contexto a las conversaciones.

Usa recursos cuando necesites llevar datos a tu app. Ejemplos comunes incluyen:

  • Completar opciones de autocompletado en tu interfaz de usuario
  • Obtener documentos para mostrarlos en un selector de archivos
  • Agregar contexto a los mensajes antes de enviarlos a Claude

En la interfaz web de Claude, la función "Agregar desde Google Drive" demuestra esto perfectamente. La aplicación obtiene una lista de documentos disponibles y los muestra en la interfaz de usuario, y luego inyecta el contenido del documento seleccionado en el contexto del chat.

Indicaciones: controladas por el usuario

Las indicaciones están controladas por los usuarios. Ellos deciden cuándo activar estos flujos de trabajo predefinidos mediante acciones directas como hacer clic en botones, seleccionar opciones de menú o usar comandos de barra diagonal.

Usa indicaciones cuando quieras implementar flujos de trabajo predefinidos a los que los usuarios puedan acceder fácilmente. En la interfaz de Claude, verás botones de flujo de trabajo debajo del campo de entrada del chat que permiten a los usuarios iniciar rápidamente tareas comunes como escribir, aprender o programar.

Elegir la primitiva correcta

Al construir tu servidor MCP, piensa en quién necesita controlar cada parte de la funcionalidad:

  • ¿Necesitas ampliar las capacidades de Claude? Usa herramientas
  • ¿Necesitas llevar datos a la interfaz de usuario de tu app? Usa recursos
  • ¿Necesitas ofrecer a los usuarios flujos de trabajo predefinidos? Usa indicaciones

Estas son pautas generales que te ayudan a elegir la primitiva correcta según tu caso de uso específico. Cada una sirve a una parte diferente de la pila de la aplicación: las herramientas sirven al modelo, los recursos sirven a la app y las indicaciones sirven a los usuarios.