Herramientas personalizadas y MCP

Los Custom Tools conectan el asistente con endpoints HTTP individuales; MCP lo conecta con un servidor de tools. Los esquemas de autenticación compatibles son Bearer, API Key, OAuth2 y HMAC.

Consulta los tools disponibles con GET /catalog/tools y los asignados al asistente con GET /catalog/assistants/{assistantId}/tools. Aplica los bindings runtime con PATCH /assistants/{assistantId}/runtime/tools:

{
  "tools": [{
    "toolName": "crm_lookup",
    "subscriptionName": null
  }]
}

tools añade tools con nombre al estado actual; deleteTools los elimina. Para un custom_tool clásico, subscriptionName debe ser null. Para plugin_tool y custom_mcp_tool, reutiliza el instanceName devuelto por el catálogo.

Usa credenciales con privilegios mínimos y mantén limitadas las respuestas de los tools para que sigan siendo útiles para el modelo.