외부 MCP 연결 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/mcp-connections/:connectionId

GET

/v1/accounts/:accountId/mcp-connections/:connectionId

$ curl https://api.claw-ops.com/v1/accounts/accountId/mcp-connections/connectionId \
>      -H "Authorization: Bearer <token>"

1 {
2   "connectionId": "clx0mcp0000000000000001",
3   "name": "예약 CRM",
4   "url": "https://crm.example.com/mcp",
5   "host": "crm.example.com",
6   "transport": "streamable_http",
7   "authType": "bearer",
8   "authHeaderName": null,
9   "hasSecret": true,
10   "enabled": true,
11   "status": "tested",
12   "toolCount": 3,
13   "tools": [
14     {
15       "name": "get_reservation",
16       "description": "예약 번호로 예약 정보를 조회합니다.",
17       "inputSchema": {}
18     }
19   ],
20   "lastTestedAt": "2024-01-15T09:30:00Z",
21   "lastErrorCode": null,
22   "agentCount": 1,
23   "dateCreated": "2024-01-15T09:30:00Z",
24   "dateUpdated": "2024-01-15T09:30:00Z"
25 }

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