새로운 문서를 작성 중입니다.새 문서로 이동
ClawOps Docs
API Reference

외부 MCP 연결 자격증명 교체

POST
/v1/accounts/{accountId}/mcp-connections/{connectionId}/credential

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

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

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

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*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

application/json

curl -X POST "https://example.com/v1/accounts/string/mcp-connections/string/credential" \  -H "Content-Type: application/json" \  -d '{    "authType": "bearer"  }'
{
  "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"
}