MCPToolboxTool interface
Uma ferramenta MCP armazenada em uma caixa de ferramentas.
- Extends
Propriedades
| allowed_callers | Os chamadores que podem invocar essa ferramenta MCP, seja diretamente ou programaticamente. |
| allowed_tools | As ferramentas MCP disponíveis para uso, especificadas pelo nome ou por um filtro de ferramentas. |
| authorization | Um token de acesso OAuth que pode ser usado com um servidor MCP remoto, seja com uma URL personalizada de servidor MCP ou um conector de serviço. Sua aplicação deve lidar com o fluxo de autorização do OAuth e fornecer o token aqui. |
| connector_id | Identificador para conectores de serviço, como aqueles disponíveis no ChatGPT. Um de
|
| defer_loading | Se essa ferramenta MCP é adiada e descoberta por meio de busca de ferramentas. |
| headers | Cabeçalhos HTTP personalizados para incluir nas requisições ao servidor MCP. |
| project_connection_id | A ID da conexão no project para o servidor MCP. A conexão armazena a autenticação e outros detalhes de conexão necessários para se conectar ao servidor MCP. |
| require_approval | Se as chamadas de ferramentas MCP requerem aprovação, seja para todas as ferramentas ou para ferramentas selecionadas por filtros. |
| server_description | Descrição opcional do servidor MCP, usada para fornecer mais contexto. |
| server_label | Um rótulo para esse servidor MCP, usado para identificá-lo em chamadas de ferramenta. |
| server_url | A URL do servidor MCP. Um de |
| tunnel_id | O ID do Túnel MCP Seguro para usar em vez de uma URL direta do servidor. Um de |
| type | O tipo da ferramenta da caixa de ferramentas MCP. Sempre |
Propriedades herdadas
| description | Descrição opcional definida pelo usuário para esta ferramenta ou configuração. |
| name | Nome opcional definido pelo usuário para essa ferramenta ou configuração. |
| tool_configs | Mapa de configuração por ferramenta. Chaves são nomes de ferramentas ou |
Detalhes da propriedade
allowed_callers
Os chamadores que podem invocar essa ferramenta MCP, seja diretamente ou programaticamente.
allowed_callers?: CallableToolAllowedCaller[]
Valor da propriedade
allowed_tools
As ferramentas MCP disponíveis para uso, especificadas pelo nome ou por um filtro de ferramentas.
allowed_tools?: string[] | MCPToolFilter
Valor da propriedade
string[] | MCPToolFilter
authorization
Um token de acesso OAuth que pode ser usado com um servidor MCP remoto, seja com uma URL personalizada de servidor MCP ou um conector de serviço. Sua aplicação deve lidar com o fluxo de autorização do OAuth e fornecer o token aqui.
authorization?: string
Valor da propriedade
string
connector_id
Identificador para conectores de serviço, como aqueles disponíveis no ChatGPT. Um de server_url, connector_id, ou tunnel_id deve ser fornecido. Saiba mais sobre conectores de serviço aqui.
Os valores com connector_id suporte no momento são:
- Dropbox:
connector_dropbox - Gmail:
connector_gmail - Google Calendário:
connector_googlecalendar - Google Drive:
connector_googledrive - Microsoft Teams:
connector_microsoftteams - Outlook Calendário:
connector_outlookcalendar - Outlook E-mail:
connector_outlookemail - Sharepoint:
connector_sharepoint
connector_id?: "connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"
Valor da propriedade
"connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"
defer_loading
Se essa ferramenta MCP é adiada e descoberta por meio de busca de ferramentas.
defer_loading?: boolean
Valor da propriedade
boolean
headers
Cabeçalhos HTTP personalizados para incluir nas requisições ao servidor MCP.
headers?: Record<string, string>
Valor da propriedade
Record<string, string>
project_connection_id
A ID da conexão no project para o servidor MCP. A conexão armazena a autenticação e outros detalhes de conexão necessários para se conectar ao servidor MCP.
project_connection_id?: string
Valor da propriedade
string
require_approval
Se as chamadas de ferramentas MCP requerem aprovação, seja para todas as ferramentas ou para ferramentas selecionadas por filtros.
require_approval?: MCPToolRequireApproval | "always" | "never"
Valor da propriedade
MCPToolRequireApproval | "always" | "never"
server_description
Descrição opcional do servidor MCP, usada para fornecer mais contexto.
server_description?: string
Valor da propriedade
string
server_label
Um rótulo para esse servidor MCP, usado para identificá-lo em chamadas de ferramenta.
server_label: string
Valor da propriedade
string
server_url
A URL do servidor MCP. Um de server_url, connector_id, ou tunnel_id deve ser fornecido.
server_url?: string
Valor da propriedade
string
tunnel_id
O ID do Túnel MCP Seguro para usar em vez de uma URL direta do servidor. Um de server_url, connector_id, ou tunnel_id deve ser fornecido.
tunnel_id?: string
Valor da propriedade
string
type
O tipo da ferramenta da caixa de ferramentas MCP. Sempre mcp.
type: "mcp"
Valor da propriedade
"mcp"
Detalhes das propriedades herdadas
description
Descrição opcional definida pelo usuário para esta ferramenta ou configuração.
description?: string
Valor da propriedade
string
Herdado deToolboxTool.description
name
Nome opcional definido pelo usuário para essa ferramenta ou configuração.
name?: string
Valor da propriedade
string
Herdado deToolboxTool.name
tool_configs
Mapa de configuração por ferramenta. Chaves são nomes de ferramentas ou * (padrão abrangente).
Ordem de resolução: a correspondência exata do nome da ferramenta tem prioridade sobre *.
Nomes de ferramentas desconhecidos são silenciosamente ignorados durante a execução.
tool_configs?: Record<string, ToolConfig>
Valor da propriedade
Record<string, ToolConfig>
Herdado deToolboxTool.tool_configs