MCPTool interface

패키지:

@azure/ai-projects

모델에 원격 모델 컨텍스트 프로토콜(MCP) 서버를 통해 추가 도구에 대한 접근 권한을 부여합니다. MCP 대해 자세히 알아보세요.

Extends

Tool

속성

allowed_callers	이 도구를 발동할 수 있는 전화 사용자들.
allowed_tools	MCP 서버에서 허용되는 도구 이름 목록입니다.
authorization	원격 MCP 서버와 함께 사용할 수 있는 OAuth 액세스 토큰으로, 사용자 지정 MCP 서버 URL 또는 서비스 커넥터를 사용할 수 있습니다. 애플리케이션이 OAuth 권한 흐름을 처리하고 여기서 토큰을 제공해야 합니다.
connector_id	ChatGPT에서 제공하는 것과 같은 서비스 커넥터의 식별자입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다. 서비스 커넥터에 대해 더 알아보세요. 현재 지원되는 connector_id 값은 다음과 같습니다: 드롭박스: connector_dropbox Gmail: connector_gmail 구글 캘린더: connector_googlecalendar Google 드라이브: connector_googledrive Microsoft Teams:connector_microsoftteams Outlook 달력: connector_outlookcalendar Outlook 이메일: connector_outlookemail Sharepoint: connector_sharepoint
defer_loading	이 MCP 도구가 도구 검색을 통해 발견되는지 여부.
headers	MCP 서버에 대한 요청에 포함할 수 있는 맞춤형 헤더.
project_connection_id	MCP 서버의 project 연결 ID입니다. 연결은 MCP 서버에 연결하는 데 필요한 인증 및 기타 연결 세부 정보를 저장합니다.
require_approval	MCP 도구의 승인 요건입니다.
server_description	MCP 서버에 대한 선택적 설명으로, 더 많은 맥락을 제공하기 위해 사용됩니다.
server_label	이 MCP 서버에 대한 레이블로, 도구 호출에서 이를 식별하는 데 사용됩니다.
server_url	MCP 서버의 URL입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다.
tool_configs	Deprecated. 이 속성은 폐기되었으며 향후 버전에서 삭제될 예정입니다.
tunnel_id	직접 서버 URL 대신 사용할 수 있는 보안 MCP 터널 ID입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다.
type	MCP 도구의 형식입니다. 항상 mcp입니다.

속성 세부 정보

allowed_callers

이 도구를 발동할 수 있는 전화 사용자들.

allowed_callers?: CallableToolAllowedCaller[]

속성 값

CallableToolAllowedCaller[]

allowed_tools

MCP 서버에서 허용되는 도구 이름 목록입니다.

allowed_tools?: string[] | MCPToolFilter

속성 값

string[] | MCPToolFilter

authorization

원격 MCP 서버와 함께 사용할 수 있는 OAuth 액세스 토큰으로, 사용자 지정 MCP 서버 URL 또는 서비스 커넥터를 사용할 수 있습니다. 애플리케이션이 OAuth 권한 흐름을 처리하고 여기서 토큰을 제공해야 합니다.

authorization?: string

속성 값

string

connector_id

ChatGPT에서 제공하는 것과 같은 서비스 커넥터의 식별자입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다. 서비스 커넥터에 대해 더 알아보세요. 현재 지원되는 connector_id 값은 다음과 같습니다:

• 드롭박스: connector_dropbox
• Gmail: connector_gmail
• 구글 캘린더: connector_googlecalendar
• Google 드라이브: connector_googledrive
• Microsoft Teams:connector_microsoftteams
• Outlook 달력: connector_outlookcalendar
• Outlook 이메일: connector_outlookemail
• Sharepoint: connector_sharepoint

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

속성 값

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

defer_loading

이 MCP 도구가 도구 검색을 통해 발견되는지 여부.

defer_loading?: boolean

속성 값

boolean

headers

MCP 서버에 대한 요청에 포함할 수 있는 맞춤형 헤더.

headers?: Record<string, string>

속성 값

Record<string, string>

project_connection_id

MCP 서버의 project 연결 ID입니다. 연결은 MCP 서버에 연결하는 데 필요한 인증 및 기타 연결 세부 정보를 저장합니다.

project_connection_id?: string

속성 값

string

require_approval

MCP 도구의 승인 요건입니다.

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

속성 값

MCPToolRequireApproval | "always" | "never"

server_description

MCP 서버에 대한 선택적 설명으로, 더 많은 맥락을 제공하기 위해 사용됩니다.

server_description?: string

속성 값

string

server_label

이 MCP 서버에 대한 레이블로, 도구 호출에서 이를 식별하는 데 사용됩니다.

server_label: string

속성 값

string

server_url

MCP 서버의 URL입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다.

server_url?: string

속성 값

string

tool_configs

Deprecated. 이 속성은 폐기되었으며 향후 버전에서 삭제될 예정입니다.

tool_configs?: Record<string, ToolConfig>

속성 값

Record<string, ToolConfig>

tunnel_id

직접 서버 URL 대신 사용할 수 있는 보안 MCP 터널 ID입니다. , , server_url 또는 중 하나connector_idtunnel_id가 제공되어야 합니다.

tunnel_id?: string

속성 값

string

type

MCP 도구의 형식입니다. 항상 mcp입니다.

type: "mcp"

속성 값

"mcp"