API Reference
외부 MCP 연결 등록
에이전트가 사용할 원격 MCP 서버를 등록합니다. url 은 공개 인터넷에서 접근 가능한 https 주소여야 하며(포트는 443만), 자격증명은 query 가 아닌 인증 설정으로 전달합니다.
등록 직후 상태는 untested 입니다. 에이전트에 연결하려면 먼저 연결 테스트를 통과해야 합니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/string/mcp-connections" \ -H "Content-Type: application/json" \ -d '{ "name": "예약 CRM", "url": "https://crm.example.com/mcp" }'{
"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"
}