Cargando
Cargando

Ahora que hemos construido nuestro servidor MCP, repasemos los tres primitivos principales y entendamos cuándo usar cada uno. La idea clave es comprender quién controla cada primitivo y qué propósito cumple en tu aplicación.

Comparación de herramientas, recursos e indicaciones: Claude controla las herramientas, nuestra aplicación 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 los resultados son usados directamente por Claude para completar 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 una respuesta precisa.

Recursos: Controlados por la aplicación

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 para fines de interfaz de usuario o para añadir contexto a las conversaciones.

Usa recursos cuando necesites obtener datos para tu app. Algunos ejemplos comunes incluyen:

  • Rellenar opciones de autocompletado en tu interfaz de usuario
  • Añadir contexto a los mensajes antes de enviarlos a Claude
  • Mostrar listas de documentos o archivos disponibles

En nuestro proyecto, usamos recursos para obtener sugerencias de autocompletado y para ampliar las indicaciones con contexto adicional.

Indicaciones: Controladas por el usuario

Las indicaciones se activan mediante acciones del usuario. Los usuarios deciden cuándo ejecutar estos flujos de trabajo predefinidos a través de interacciones en la interfaz, como clics en botones, selecciones de menú o comandos de barra diagonal.

Usa indicaciones para flujos de trabajo que los usuarios deberían poder activar a demanda. Son perfectas para:

  • Iniciadores de conversación predefinidos
  • Plantillas de tareas comunes
  • Flujos de trabajo especializados optimizados para casos de uso específicos

Ejemplos del mundo real

Puedes ver los tres primitivos en acción en la interfaz oficial de Claude. Los botones de inicio de conversación debajo del campo de entrada del chat son ejemplos de indicaciones: flujos de trabajo controlados por el usuario que comienzan interacciones predefinidas.

Campo de entrada del chat de Claude con los botones iniciadores "Career chat" y "Connect apps" y un menú abierto que incluye "Add from Google Drive".

La opción "Add from Google Drive" demuestra recursos en acción. Cuando haces clic en este botón, la aplicación obtiene una lista de tus documentos y los muestra en la interfaz. Este es un comportamiento controlado por la aplicación que sirve a la interfaz.

Cuando le pides a Claude que realice cálculos o ejecute código, estás viendo herramientas en funcionamiento. Claude decide automáticamente usar herramientas disponibles como la ejecución de JavaScript para proporcionar resultados precisos.

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

Eligiendo el primitivo correcto

Aquí tienes una guía rápida de decisión:

  • ¿Necesitas ampliar las capacidades de Claude? Usa herramientas
  • ¿Necesitas datos para la interfaz o el contexto de tu app? Usa recursos
  • ¿Quieres ofrecer flujos de trabajo predefinidos a los usuarios? Usa indicaciones

Recuerda, estas son pautas de alto nivel para ayudarte a elegir el enfoque correcto para tus necesidades específicas. Cada primitivo sirve a una parte diferente del ecosistema de tu aplicación: las herramientas sirven al modelo, los recursos sirven a tu app y las indicaciones sirven a tus usuarios.