API Reference
외부 MCP 연결 테스트
실제 통화를 처리하는 런타임에서 MCP 서버에 접속해 도구 목록을 가져옵니다. 브라우저나 API 서버가 아니라 통화 런타임이 직접 연결하므로, 테스트 성공은 실제 통화에서도 같은 경로로 연결된다는 뜻입니다.
성공하면 status 가 tested 가 되고 발견된 도구 목록이 저장됩니다. 에이전트에 연결하려면 이 테스트를 먼저 통과해야 합니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
connectionId*string
MCP 연결 ID
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/string/mcp-connections/string/test"{
"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": "2019-08-24T14:15:22Z",
"lastErrorCode": null,
"agentCount": 1,
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}