ClawOps APIAgents

외부 MCP 연결 등록

View as Markdown

에이전트가 사용할 원격 MCP 서버를 등록합니다. url 은 공개 인터넷에서 접근 가능한 https 주소여야 하며(포트는 443만), 자격증명은 query 가 아닌 인증 설정으로 전달합니다.

등록 직후 상태는 untested 입니다. 에이전트에 연결하려면 먼저 연결 테스트를 통과해야 합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.
namestringRequired<=80 characters
urlstringRequiredformat: "uri"<=2048 characters

https 전용. 포트는 생략하거나 443. 사설/내부 주소는 등록할 수 없습니다.

transportenumOptionalDefaults to streamable_http

sse 는 호환용 legacy 입니다.

Allowed values:
authTypeenumOptionalDefaults to none
Allowed values:
headerNamestringOptional<=64 characters

authType=api_key 일 때만 사용합니다. Authorization·Host·Cookie 등 예약 헤더는 사용할 수 없습니다(Bearer 가 필요하면 authType=bearer 를 쓰세요).

secretstringOptional<=8192 characters

authType 이 none 이 아닐 때 필수. 저장 시 암호화되며 다시 조회할 수 없습니다.

Response

등록 성공(연결 테스트 전이므로 status=untested)

connectionIdstring

연결 ID

namestring
urlstringformat: "uri"
hoststring

url 의 호스트. 목록 화면 표시용.

transportenum
authTypeenum
authHeaderNamestring or null

authType=api_key 일 때의 헤더 이름. bearer 는 Authorization 고정이라 null.

hasSecretboolean

자격증명 설정 여부. 값 자체는 조회할 수 없습니다.

enabledboolean
statusenum

untested 는 연결 테스트를 통과하지 않은 상태입니다. 에이전트에 붙이려면 tested 여야 하며, 통화 중에도 tested 인 연결만 사용됩니다. credential_error 는 마지막 테스트가 인증 실패한 경우입니다.

toolCountinteger>=0
toolslist of objects

마지막 연결 테스트에서 발견된 도구 목록. 표시·선택용 스냅샷입니다.

lastTestedAtdatetime or null
lastErrorCodeenum or null

마지막 연결 실패 사유.

agentCountinteger>=0

이 연결을 사용하는 에이전트 수.

dateCreateddatetime
dateUpdateddatetime

Errors

400
Bad Request Error
401
Unauthorized Error