MCP 서버 구성 업데이트

PATCH

/v1/convai/mcp-servers/:mcp_server_id

PATCH

/v1/convai/mcp-servers/:mcp_server_id

curl -X PATCH https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "id",
  "config": {
    "url": "url",
    "name": "name",
    "approval_policy": "auto_approve_all",
    "tool_approval_hashes": [
      {
        "tool_name": "tool_name",
        "tool_hash": "tool_hash"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret_id"
    },
    "request_headers": {
      "key": "value"
    },
    "request_meta": {
      "key": "value"
    },
    "auth_connection": {
      "auth_connection_id": "auth_connection_id"
    },
    "description": "description",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 1,
    "tool_config_overrides": [
      {
        "tool_name": "tool_name",
        "assignments": [
          {
            "dynamic_variable": "user_name",
            "value_path": "user.name",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ]
      }
    ],
    "disable_compression": true
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "owner_user_id"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "anonymous_access_level_override": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "id",
      "name": "name",
      "referenced_resource_ids": [
        "referenced_resource_ids"
      ]
    }
  ]
}

MCP 서버의 구성 설정을 업데이트합니다.

경로 매개변수

mcp_server_idstring필수

MCP 서버 ID입니다.

요청

This endpoint expects an object.

approval_policyenum선택 사항기본값 require_approval_all

MCP 서버에 설정할 승인 모드

허용된 값:

pre_tool_speechenum선택 사항기본값 auto

설정하면 이 도구에 대한 서버의 pre_tool_speech 설정을 재정의합니다.

허용된 값:

interruption_modeenum선택 사항기본값 allow

설정하면 이 도구에 대한 서버의 interruption_mode 설정을 재정의합니다.

허용된 값:

tool_call_soundenum선택 사항

이 MCP 서버의 모든 도구 실행 중 재생할 사전 정의된 도구 호출 사운드 유형

허용된 값:

tool_call_sound_behaviorenum선택 사항기본값 auto

이 MCP 서버의 모든 도구에 대해 도구 호출 사운드를 언제 재생할지 결정합니다.

허용된 값:

execution_modeenum선택 사항기본값 immediate

설정하면 이 도구에 대한 서버의 execution_mode 설정을 재정의합니다.

허용된 값:

response_timeout_secsinteger선택 사항5-300

각 MCP 도구 호출이 완료될 때까지 대기하는 최대 시간(초)입니다.

request_headersmap from strings to optional strings or objects선택 사항

MCP 서버 요청에 포함할 헤더

request_metamap from strings to optional strings or integers or doubles or booleans or objects선택 사항

도구 호출 요청의 MCP _meta 필드로 전송되는 항목입니다. 값은 JSON 스칼라이거나 호출별로 확인되는 워크스페이스 시크릿, 동적 변수 또는 환경 변수에 대한 참조일 수 있습니다.

disable_compressionboolean선택 사항

이 MCP 서버의 HTTP 압축을 비활성화할지 여부

secret_tokenobject선택 사항

이 MCP 서버 인증에 사용할 선택적 비밀 토큰입니다.

auth_connectionobject선택 사항

이 MCP 서버 인증에 사용할 선택적 인증 연결입니다.

force_pre_tool_speechboolean선택 사항Deprecated

지원 중단됨: 대신 pre_tool_speech를 사용하세요. 설정하면 이 도구에 대한 서버의 force_pre_tool_speech 설정을 재정의합니다.

disable_interruptionsboolean선택 사항Deprecated

지원 중단됨: 대신 interruption_mode를 사용하세요. 설정하면 이 도구에 대한 서버의 disable_interruptions 설정을 재정의합니다.

응답

성공 응답

idstring

configobject

metadataobject

MCP 서버의 메타데이터입니다.

access_infoobject선택 사항

MCP 서버의 액세스 정보

dependent_agentslist of objects선택 사항

이 MCP 서버에 종속된 에이전트 목록입니다.

오류

422

Mcp Servers Update Request Unprocessable Entity Error