MCP 도구 구성 재정의 생성

POST

/v1/convai/mcp-servers/:mcp_server_id/tool-configs

POST

/v1/convai/mcp-servers/:mcp_server_id/tool-configs

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

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "request_meta": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "string",
        "pre_tool_speech": "auto",
        "interruption_mode": "allow",
        "tool_call_sound": "typing",
        "tool_call_sound_behavior": "auto",
        "execution_mode": "immediate",
        "response_timeout_secs": 1,
        "assignments": [
          {
            "dynamic_variable": "string",
            "value_path": "string",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "string",
            "parameter_conditions": [
              {
                "eval": {
                  "description": "string",
                  "type": "string"
                },
                "path": "string"
              }
            ],
            "is_error": false
          }
        ],
        "force_pre_tool_speech": true,
        "disable_interruptions": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false,
    "disable_interruptions": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

특정 MCP 도구의 구성 재정의 항목을 생성합니다.

경로 매개변수

mcp_server_idstring필수

MCP 서버 ID입니다.

쿼리 매개변수

environmentstring선택 사항기본값 production

MCP 서버 URL, 헤더 또는 인증 연결에서 환경 변수를 참조할 때 값을 사용할 환경입니다. 대화가 실행되는 환경을 반영하며, 기본값은 production입니다.

요청

This endpoint expects an object.

tool_namestring필수

MCP 도구 이름입니다.

pre_tool_speechenum or null선택 사항기본값 auto

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

허용된 값:

interruption_modeenum or null선택 사항기본값 allow

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

허용된 값:

tool_call_soundenum or "off" or null선택 사항

이 도구에 대해 서버의 tool_call_sound 설정을 재정의합니다. 사운드 이름을 지정하면 해당 사운드가 재생되고, ‘off’는 소리 없음(무음)으로 재정의하며, null은 재정의하지 않음(서버 기본값 상속)을 의미합니다.

tool_call_sound_behaviorenum or null선택 사항기본값 auto

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

허용된 값:

execution_modeenum or null선택 사항기본값 immediate

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

허용된 값:

response_timeout_secsinteger or null선택 사항5-300

설정하면 이 MCP 도구에 대한 서버의 응답 시간 제한을 재정의합니다.

assignmentslist of objects or null선택 사항

이 MCP 도구의 동적 변수 할당

input_overridesmap from strings to objects or null선택 사항

JSON 경로와 입력 재정의 구성의 매핑

response_mockslist of objects or null선택 사항

선택적 파라미터 조건이 있는 모의 응답입니다. 위에서 아래 순서로 평가하며, 처음 일치하는 항목이 적용됩니다.

force_pre_tool_speechboolean or null선택 사항Deprecated

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

disable_interruptionsboolean or null선택 사항Deprecated

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

응답

성공 응답

idstring

configobject

metadataobject

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

access_infoobject or null선택 사항

MCP 서버의 액세스 정보

dependent_agentslist of objects선택 사항

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

오류

409

Conflict Error

422

Unprocessable Entity Error