API Reference
에이전트에 외부 MCP 연결·도구 지정
에이전트가 사용할 도구를 지정합니다(멱등). allowedTools 에 넣은 도구만 모델에 노출되며, 같은 연결이라도 에이전트마다 다른 도구를 허용할 수 있습니다.
도구는 1개 이상이어야 하고, 연결 테스트에서 발견된 도구여야 합니다. 연결은 status=tested 이고 enabled 여야 합니다.
저장 즉시 다음 통화부터 적용됩니다(에이전트 설정 저장과 별개).
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
agentId*string
에이전트 ID
connectionId*string
MCP 연결 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/accounts/string/agents/string/mcp-connections/string" \ -H "Content-Type: application/json" \ -d '{ "allowedTools": [ "get_reservation" ] }'{
"connectionId": "clx0mcp0000000000000001",
"name": "예약 CRM",
"host": "crm.example.com",
"status": "tested",
"enabled": true,
"allowedTools": [
"get_reservation"
],
"failureMode": "continue",
"missingTools": [],
"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"
}