MCP 서버
키와 웹훅
이 워크스페이스가 발급한 자격 증명과 엔드포인트.
키와 웹훅 도구
| 도구 | 하는 일 |
|---|---|
| listApiKeys | 이 워크스페이스가 발급한 모든 API 키와 각 키가 할 수 있는 일, 어떤 주소로 보낼 수 있는지를 두 키를 구분할 수 있을 만큼만 마스킹한 형태로 보여 줍니다. |
| rotateApiKey | 키에 새 시크릿을 부여하고 id, 이름, 스코프, 역할, 발송 범위는 유지합니다. 겹치는 유예 기간은 없고, 새 시크릿은 한 번만 표시됩니다. |
| setApiKeyEnabled | 키를 끄거나 다시 켭니다. 되돌릴 수 있는 쪽입니다. 키는 시크릿, 스코프, 역할, 발송 범위를 그대로 유지합니다. |
| revokeApiKey | 키를 영구적으로 폐기합니다. 폐기된 키는 다시 켜거나 회전하거나 변경할 수 없습니다. |
| setApiKeySendScope | 키가 어떤 주소로 보낼 수 있는지를 서로 독립적인 두 목록으로 지정합니다. 전달한 내용이 키에 있던 설정을 대체합니다. |
| listWebhooks | 이 워크스페이스의 모든 웹훅 엔드포인트와 어디로 전송하는지, 활성화되어 있는지, 어떤 이벤트를 요청했는지 보여 줍니다. 서명 시크릿은 절대 표시되지 않습니다. |
| listWebhookEvents | 엔드포인트가 구독할 수 있는 모든 이벤트를 계열별로 묶어, 각각이 언제 발생하는지 한 줄로 설명합니다. |
시크릿은 키를 만들거나 회전할 때 한 번만 표시되며, 그 뒤에는 어떤 방법으로도 복구할 수 없습니다. 여기서 시크릿을 반환하는 도구는 rotateApiKey뿐이므로, 기존 시크릿을 갖고 있는 쪽에는 다음 실행 전에 새 시크릿을 전달해야 합니다.
revokeApiKey보다 setApiKeyEnabled를 먼저 쓰세요. 키를 끄는 것은 되돌릴 수 있고 아직 무언가가 그 키에 의존하는지 알려 주지만, 폐기는 영구적이며 그 뒤에 남는 길은 새 키와 새 시크릿뿐입니다.
여기에는 createApiKey도 createWebhook도 없는데, createRole이 없는 것과 같은 이유입니다. 채팅 창 안에서 자격 증명을 발급하는 것은 조용하면서도 광범위한 변경이고 나중에 아무도 보지 못합니다. 둘 다 설정에 있으며, 거기서는 발급하는 사람이 자신이 무엇을 내주는지 볼 수 있습니다.