외부 MCP 연결 자격증명 교체

POST

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

POST

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

$ curl -X POST https://api.claw-ops.com/v1/accounts/accountId/mcp-connections/connectionId/credential \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "authType": "bearer"
> }'

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 }

자격증명을 교체합니다. 기본 동작은 검증 후 교체입니다 — 새 자격증명으로 실제 연결에 성공한 뒤에야 저장하므로, 잘못된 값으로 정상 연결을 덮어써 통화가 망가지는 일이 없습니다.

러너에 접근할 수 없는 등 검증이 불가능한 상황에서는 force=true 로 검증 없이 저장할 수 있습니다. 이 경우 status 가 untested 가 되어 통화에서는 사용되지 않으며, 이후 연결 테스트를 통과해야 다시 사용됩니다.

응답에는 자격증명이 포함되지 않습니다.

자격증명을 교체합니다. 기본 동작은 **검증 후 교체**입니다 — 새 자격증명으로 실제 연결에 성공한 뒤에야 저장하므로, 잘못된 값으로 정상 연결을 덮어써 통화가 망가지는 일이 없습니다. 러너에 접근할 수 없는 등 검증이 불가능한 상황에서는 force=true 로 검증 없이 저장할 수 있습니다. 이 경우 status 가 untested 가 되어 **통화에서는 사용되지 않으며**, 이후 연결 테스트를 통과해야 다시 사용됩니다. 응답에는 자격증명이 포함되지 않습니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

connectionIdstringRequired

MCP 연결 ID

Request

This endpoint expects an object.

authTypeenumRequired

none 으로 바꾸면 저장된 자격증명이 제거됩니다.

Allowed values:

headerNamestringOptional<=64 characters

authType=api_key 일 때만 사용합니다.

secretstringOptional<=8192 characters

authType 이 none 이 아닐 때 필수. 저장 후 다시 조회할 수 없습니다.

forcebooleanOptionalDefaults to false

true 면 연결 검증 없이 저장합니다(복구용). status 가 untested 가 되어 통화에서 사용되지 않습니다.

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

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

502

Bad Gateway Error

503

Service Unavailable Error