MCPToolboxTool interface
Una herramienta MCP guardada en una caja de herramientas.
- Extends
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
|
| 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 |
| tunnel_id | El ID del túnel MCP seguro para usar en lugar de una URL directa del servidor. Uno de |
| type | El tipo de herramienta de la caja de herramientas MCP. Siempre |
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 |
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
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