Guía de Uso

Herramientas (MCP Tools)

Conecta tus agentes de IA con el mundo real. Las herramientas son funciones que permiten a tus modelos llamar APIs, acceder a bases de datos y reutilizar templates mediante el protocolo MCP (Model Context Protocol).

¿Qué son las Herramientas?

Las herramientas son funciones que se conectan a tus agentes de IA mediante el protocolo MCP (Model Context Protocol). Permiten que tu modelo acceda a APIs externas, bases de datos y servicios sin que necesites modificar el modelo en sí. Hay tres tipos:

Function Tool

Ejecuta una acción HTTP cuando el agente la invoca. Se conecta a APIs externas, webhooks o servicios REST y devuelve el resultado al modelo.

Prompt

Template de texto reutilizable con variables interpoladas. Permite estandarizar instrucciones y reutilizarlas en múltiples agentes sin duplicar código.

Resource

Fuente de datos estática que el agente puede leer. Ideal para documentos de referencia, guías de estilo, bases de conocimiento o datos que no cambian frecuentemente.

Cuando un agente recibe un prompt, el LLM evalúa las herramientas disponibles y decide cuál invocar según sus descripciones. Por eso la descripción de cada herramienta es crítica: el modelo la usa como guía de selección.

Prompt de usuario

LLM selecciona herramienta

Resultado al agente

Crear una Herramienta — Wizard de 5 Pasos

AstrApp incluye un wizard guiado para crear herramientas paso a paso. Accede desde Herramientas → Nueva Herramienta.

Seleccionar Tipo

Elige entre Function Tool, Prompt o Resource según lo que necesitas.
Function Tool: para llamar a APIs y ejecutar acciones externas.
Prompt: para crear templates de texto reutilizables con variables.
Resource: para adjuntar documentos o datos estáticos al contexto del agente.

Información Básica

Escribe un nombre claro y descriptivo (sin espacios; usa guiones o camelCase).
Agrega una descripción que explique qué hace la herramienta — el agente la usa para decidir cuándo invocarla.
Asigna etiquetas para organizar tus herramientas por proyecto o dominio.

Configuración HTTP

Solo aplica para Function Tool.
Define la URL del endpoint y el método HTTP (GET, POST, PUT, DELETE, PATCH).
Agrega headers personalizados (Content-Type, Accept, etc.).
Configura el body template con variables dinámicas usando la sintaxis {{variable}}.

Autenticación

None: para endpoints públicos sin autenticación.
API Key: envía una clave en un header o query param configurado por ti.
Bearer Token: agrega un token JWT o de acceso en el header Authorization.
OAuth 2.0: flujo de autorización completo con client ID, secret y token endpoint.

Revisión y Creación

Revisa el resumen completo de la configuración antes de crear.
Verifica la URL, headers, parámetros y autenticación.
Haz clic en "Crear Herramienta" para guardarla en tu organización.
La herramienta queda disponible inmediatamente para asignarla a agentes y MCP servers.

Consejo: La descripción de la herramienta (Paso 2) es lo que el LLM lee para decidir si invocarla. Sé específico: indica qué hace, cuándo usarla y qué datos devuelve. Una buena descripción mejora significativamente la precisión del agente.

Parámetros con JSON Schema

AstrApp incluye un builder visual de JSON Schema para definir los parámetros que recibe tu herramienta. El agente los usará para llamar la función con los valores correctos.

Tipos de Parámetros

stringTexto libre o con validaciones de patrón regex

numberNúmero entero o decimal con min/max opcional

booleanValor verdadero o falso

arrayLista de valores del mismo tipo

objectObjeto anidado con propiedades propias

Validaciones Disponibles

min / maxRango de valores numéricos
minLength / maxLengthLongitud de strings
enumLista de valores permitidos
patternExpresión regular para validar formato
requiredMarca el parámetro como obligatorio

Preview del Schema Generado

A medida que defines los parámetros en el builder visual, AstrApp muestra en tiempo real el JSON Schema resultante. Esto te permite verificar que la definición es correcta antes de guardar la herramienta.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Texto a buscar",
      "minLength": 1
    },
    "limit": {
      "type": "number",
      "description": "Número de resultados",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": ["query"]
}

Tabla de Herramientas

La vista principal de Herramientas muestra todas las herramientas de tu organización en una tabla con filtros y acciones rápidas.

Columna	Descripción
Nombre	Identificador único de la herramienta
Tipo	Function Tool, Prompt o Resource
Estado	Activa, inactiva o en error
Última ejecución	Timestamp de la última vez que fue invocada

Filtros Disponibles

Por tipo

Function Tool, Prompt o Resource

Por etiqueta

Filtra por las etiquetas que asignaste

Búsqueda por nombre

Búsqueda en tiempo real sobre el nombre de la herramienta

Acciones por Herramienta

Editar: Modifica cualquier campo de la herramienta.

Duplicar: Crea una copia con todos los parámetros para iterar rápidamente.

Test rápido: Ejecuta la herramienta con parámetros de prueba sin salir de la tabla.

Eliminar: Elimina la herramienta permanentemente (no se puede deshacer).

Inspector de Herramientas

Haz clic en cualquier herramienta de la tabla para abrir el panel lateral del Inspector. Tiene tres pestañas con información y acciones distintas.

Detalles

Vista visual completa de toda la configuración: tipo, URL, método, headers, autenticación y parámetros definidos en el schema.

JSON

Schema MCP completo en formato JSON exportable. Úsalo para integrar la herramienta en clientes MCP externos o revisión técnica.

Test

Formulario para ingresar parámetros de prueba y ejecutar la herramienta en tiempo real. Muestra la respuesta cruda del endpoint.

Consejo: Usa la pestaña Test del Inspector para verificar que la herramienta responde correctamente antes de agregarla a un agente o MCP server. Puedes ver la respuesta cruda del endpoint y el tiempo de ejecución.

Simulador MCP Interactivo

El Simulador recrea el flujo completo de cómo un agente LLM invocaría tu herramienta. Ideal para depuración y validación antes de llevar la herramienta a producción.

Flujo Simulado

Prompt

Ingresa un mensaje de usuario como si lo enviara a tu agente.

Tool Call

El simulador muestra qué herramienta seleccionaría el LLM y con qué parámetros.

Response

Ejecuta la herramienta real y muestra la respuesta del endpoint.

Final Answer

Genera la respuesta final que el agente le daría al usuario con el resultado integrado.

Para Depuración

Si el agente no invoca la herramienta cuando debería, el simulador te muestra exactamente por qué: tal vez la descripción no es suficientemente clara o los parámetros no coinciden con la intención del usuario.

Para Validación

Prueba distintos prompts de usuario para asegurarte de que la herramienta se invoca en los escenarios correctos y no en los incorrectos (falsos positivos).

MCP Server Builder

El MCP Server Builder agrupa tus herramientas en un servidor MCP desplegado automáticamente por AstrApp. Cualquier cliente compatible con MCP (Claude Desktop, Cursor, VS Code, etc.) puede conectarse a él. Accede desde Herramientas → MCP Server Builder.

Selecciona Herramientas

Elige una o más herramientas de tu organización para incluir en el servidor.
Puedes mezclar Function Tools, Prompts y Resources en un mismo servidor.
El nombre del servidor MCP se genera automáticamente o lo defines tú.

Security Scan

AstrApp revisa automáticamente las herramientas seleccionadas antes de generar el servidor.
Detecta API keys o tokens hardcodeados en URLs, headers o body templates.
Si encuentra problemas, te muestra exactamente qué herramienta y campo tiene el riesgo.
No puedes continuar hasta resolver los problemas de seguridad detectados.

Code Preview

Previsualiza el código del servidor MCP generado antes de desplegarlo.
El código es TypeScript usando el SDK oficial de MCP.
Puedes descargarlo para revisión o deployment manual en tu propia infraestructura.

Deploy

Haz clic en "Desplegar" para que AstrApp aloje el servidor MCP automáticamente.
El proceso tarda menos de 30 segundos.
El servidor queda activo con una URL única para tu organización.

Connection Info

URL del servidor MCP lista para usar.
Headers de autenticación necesarios para conectarte.
JSON de configuración listo para pegar en clientes MCP (Claude Desktop, Cursor, etc.).
Copia la configuración con un clic y conéctala a tu cliente preferido.

Seguridad del Servidor MCP

Cada servidor MCP generado incluye autenticación por token de acceso. AstrApp gestiona la rotación de tokens y los logs de acceso. Puedes revocar un servidor en cualquier momento desde el panel de administración.

Límites

Ten en cuenta los siguientes límites al diseñar tus herramientas:

Máximo 20 herramientas por organización. Contacta a soporte si necesitas más para tu plan.
Timeout de ejecución: 30 segundos. Si tu endpoint tarda más, la herramienta devuelve error de timeout.
Rate limit: 100 ejecuciones/minuto por herramienta. Las llamadas que superen el límite se rechazan con error 429.

Plan Free

• Hasta 5 herramientas
• 30 ejecuciones/minuto
• Sin MCP Server Builder

Plan Starter

• Hasta 10 herramientas
• 60 ejecuciones/minuto
• 1 MCP server activo

Plan Professional+

• Hasta 20 herramientas
• 100 ejecuciones/minuto
• MCP servers ilimitados

Entrenamiento Microagentes