외부 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>"

{
  "connectionId": "clx0mcp0000000000000001",
  "name": "예약 CRM",
  "url": "https://crm.example.com/mcp",
  "host": "crm.example.com",
  "transport": "streamable_http",
  "authType": "bearer",
  "authHeaderName": null,
  "hasSecret": true,
  "enabled": true,
  "status": "tested",
  "toolCount": 3,
  "tools": [
    {
      "name": "get_reservation",
      "description": "예약 번호로 예약 정보를 조회합니다.",
      "inputSchema": {}
    }
  ],
  "lastTestedAt": "2024-01-15T09:30:00Z",
  "lastErrorCode": null,
  "agentCount": 1,
  "dateCreated": "2024-01-15T09:30:00Z",
  "dateUpdated": "2024-01-15T09:30:00Z"
}

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

connectionIdstringRequired

MCP 연결 ID

Response

조회 성공

connectionIdstring

연결 ID

namestring

urlstringformat: "uri"

hoststring

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

transportenum

Allowed values:

authTypeenum

Allowed values:

authHeaderNamestring or null

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

hasSecretboolean

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

enabledboolean

statusenum

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

Allowed values:

toolCountinteger>=0

toolslist of objects

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

lastTestedAtdatetime or null

lastErrorCodeenum or null

마지막 연결 실패 사유.

agentCountinteger>=0

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

dateCreateddatetime

dateUpdateddatetime

Errors

401

Unauthorized Error

404

Not Found Error