ClawOps APIAgents

외부 MCP 연결 테스트

View as Markdown
실제 통화를 처리하는 런타임에서 MCP 서버에 접속해 도구 목록을 가져옵니다. 브라우저나 API 서버가 아니라 통화 런타임이 직접 연결하므로, 테스트 성공은 실제 통화에서도 같은 경로로 연결된다는 뜻입니다. 성공하면 status 가 tested 가 되고 발견된 도구 목록이 저장됩니다. 에이전트에 연결하려면 이 테스트를 먼저 통과해야 합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

connectionIdstringRequired

MCP 연결 ID

Response

연결 성공(도구 목록 갱신됨)

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

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
502
Bad Gateway Error
503
Service Unavailable Error