MCPToolboxTool interface

Paquete:

@azure/ai-projects

Una herramienta MCP guardada en una caja de herramientas.

Extends

ToolboxTool

Propiedades

allowed_callers	Los llamantes que pueden invocar esta herramienta MCP, ya sea directamente o programáticamente.
allowed_tools	Las herramientas MCP disponibles para su uso, especificadas por nombre o por un filtro de herramienta.
authorization	Un token de acceso OAuth que puede usarse con un servidor MCP remoto, ya sea con una URL personalizada de servidor MCP o un conector de servicio. Tu aplicación debe gestionar el flujo de autorización OAuth y proporcionar el token aquí.
connector_id	Identificador de conectores de servicio, como los disponibles en ChatGPT. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado. Descubre más sobre los conectores de servicio aquí. Los valores admitidos connector_id actualmente son: Dropbox: connector_dropbox Gmail: connector_gmail Google Calendar: connector_googlecalendar Google Drive: connector_googledrive Microsoft Teams:connector_microsoftteams Outlook Calendario: connector_outlookcalendar Outlook Correo electrónico: connector_outlookemail SharePoint:connector_sharepoint
defer_loading	Si esta herramienta MCP se aplaza y se descubre mediante búsqueda de herramientas.
headers	Cabeceras HTTP personalizadas para incluir en las solicitudes al servidor MCP.
project_connection_id	Identificador de conexión del project para el servidor MCP. La conexión almacena la autenticación y otros detalles de conexión necesarios para conectarse al servidor MCP.
require_approval	Si las llamadas a herramientas MCP requieren aprobación, ya sea para todas las herramientas o para herramientas seleccionadas por filtros.
server_description	Descripción opcional del servidor MCP, que se usa para proporcionar más contexto.
server_label	Etiqueta para este servidor MCP, que se usa para identificarlo en las llamadas a herramientas.
server_url	Dirección URL del servidor MCP. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.
tunnel_id	El ID del túnel MCP seguro para usar en lugar de una URL directa del servidor. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.
type	El tipo de herramienta de la caja de herramientas MCP. Siempre mcp.

Propiedades heredadas

description	Descripción opcional definida por el usuario para esta herramienta o configuración.
name	Nombre opcional definido por el usuario para esta herramienta o configuración.
tool_configs	Mapa de configuración por herramienta. Las claves son nombres de herramientas o * (predeterminado caótico). Orden de resolución: la coincidencia exacta con el nombre de la herramienta tiene prioridad sobre *. Los nombres de herramientas desconocidos se ignoran silenciosamente en tiempo de ejecución.

Detalles de las propiedades

allowed_callers

Los llamantes que pueden invocar esta herramienta MCP, ya sea directamente o programáticamente.

allowed_callers?: CallableToolAllowedCaller[]

Valor de propiedad

CallableToolAllowedCaller[]

allowed_tools

Las herramientas MCP disponibles para su uso, especificadas por nombre o por un filtro de herramienta.

allowed_tools?: string[] | MCPToolFilter

Valor de propiedad

string[] | MCPToolFilter

authorization

Un token de acceso OAuth que puede usarse con un servidor MCP remoto, ya sea con una URL personalizada de servidor MCP o un conector de servicio. Tu aplicación debe gestionar el flujo de autorización OAuth y proporcionar el token aquí.

authorization?: string

Valor de propiedad

string

connector_id

Identificador de conectores de servicio, como los disponibles en ChatGPT. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado. Descubre más sobre los conectores de servicio aquí. Los valores admitidos connector_id actualmente son:

• Dropbox: connector_dropbox
• Gmail: connector_gmail
• Google Calendar: connector_googlecalendar
• Google Drive: connector_googledrive
• Microsoft Teams:connector_microsoftteams
• Outlook Calendario: connector_outlookcalendar
• Outlook Correo electrónico: connector_outlookemail
• SharePoint:connector_sharepoint

connector_id?: "connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

Valor de propiedad

"connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

defer_loading

Si esta herramienta MCP se aplaza y se descubre mediante búsqueda de herramientas.

defer_loading?: boolean

Valor de propiedad

boolean

headers

Cabeceras HTTP personalizadas para incluir en las solicitudes al servidor MCP.

headers?: Record<string, string>

Valor de propiedad

Record<string, string>

project_connection_id

Identificador de conexión del project para el servidor MCP. La conexión almacena la autenticación y otros detalles de conexión necesarios para conectarse al servidor MCP.

project_connection_id?: string

Valor de propiedad

string

require_approval

Si las llamadas a herramientas MCP requieren aprobación, ya sea para todas las herramientas o para herramientas seleccionadas por filtros.

require_approval?: MCPToolRequireApproval | "always" | "never"

Valor de propiedad

MCPToolRequireApproval | "always" | "never"

server_description

Descripción opcional del servidor MCP, que se usa para proporcionar más contexto.

server_description?: string

Valor de propiedad

string

server_label

Etiqueta para este servidor MCP, que se usa para identificarlo en las llamadas a herramientas.

server_label: string

Valor de propiedad

string

server_url

Dirección URL del servidor MCP. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.

server_url?: string

Valor de propiedad

string

tunnel_id

El ID del túnel MCP seguro para usar en lugar de una URL directa del servidor. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.

tunnel_id?: string

Valor de propiedad

string

type

El tipo de herramienta de la caja de herramientas MCP. Siempre mcp.

type: "mcp"

Valor de propiedad

"mcp"

Detalles de las propiedades heredadas

description

Descripción opcional definida por el usuario para esta herramienta o configuración.

description?: string

Valor de propiedad

string

Heredado deToolboxTool.description

name

Nombre opcional definido por el usuario para esta herramienta o configuración.

name?: string

Valor de propiedad

string

Heredado deToolboxTool.name

tool_configs

Mapa de configuración por herramienta. Las claves son nombres de herramientas o * (predeterminado caótico). Orden de resolución: la coincidencia exacta con el nombre de la herramienta tiene prioridad sobre *. Los nombres de herramientas desconocidos se ignoran silenciosamente en tiempo de ejecución.

tool_configs?: Record<string, ToolConfig>

Valor de propiedad

Record<string, ToolConfig>

Heredado deToolboxTool.tool_configs