ClawOps APIAgents

에이전트에 외부 MCP 연결·도구 지정

View as Markdown
에이전트가 사용할 도구를 지정합니다(멱등). allowedTools 에 넣은 도구만 모델에 노출되며, 같은 연결이라도 에이전트마다 다른 도구를 허용할 수 있습니다. 도구는 1개 이상이어야 하고, 연결 테스트에서 발견된 도구여야 합니다. 연결은 status=tested 이고 enabled 여야 합니다. 저장 즉시 다음 통화부터 적용됩니다(에이전트 설정 저장과 별개).

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

agentIdstringRequired

에이전트 ID

connectionIdstringRequired

MCP 연결 ID

Request

This endpoint expects an object.
allowedToolslist of stringsRequired
failureModeenumOptionalDefaults to continue

continue 는 MCP 서버 장애 시 그 도구만 빼고 통화를 계속합니다. fail_session 은 연결 실패 시 세션 시작을 실패시킵니다.

Allowed values:

Response

지정 성공

connectionIdstring
namestring
hoststring
statusenum
enabledboolean
allowedToolslist of strings

이 에이전트가 호출할 수 있는 도구. 여기 없는 도구는 모델에 노출되지 않습니다.

failureModeenum

continue 는 MCP 서버 장애 시 해당 도구만 빼고 통화를 계속합니다. fail_session 은 연결하지 못하면 세션 시작 자체를 실패시킵니다(외부 시스템이 필수인 경우).

missingToolslist of strings

allowedTools 에 있지만 마지막 연결 테스트 결과에는 없는 도구. 서버가 도구를 없앴거나 이름을 바꾼 경우이며, 통화에서는 호출되지 않습니다.

dateUpdateddatetime

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error