MCP 서버
오디언스
연락처를 묶어 두는 이름 있는 목록.
오디언스 도구
| 도구 | 하는 일 |
|---|---|
| listAudiences | 이 메일함이 연락처를 묶어 둔 목록들이며, 기본 목록이 맨 앞에 옵니다. 오디언스는 묶음일 뿐 그 이상이 아닙니다. |
| getAudience | 오디언스 하나의 전체 정보: 이름, 용도, 포함된 연락처 수, 기본 오디언스인지 여부. |
| createAudience | 이름 있는 목록을 만듭니다. 비어 있는 상태로 생성되고 두 오디언스가 같은 이름을 쓰는 것을 막지 않으므로, 먼저 목록을 읽어 보세요. |
| updateAudience | 오디언스의 이름을 바꾸거나 용도 설명을 변경합니다. 기본 오디언스도 다른 것과 똑같이 이름을 바꿀 수 있고, 이름이 무엇이든 계속 기본으로 남습니다. |
| deleteAudience | 오디언스를 삭제합니다. 소속 관계는 사라지지만 그 안에 있던 연락처는 모두 남습니다. 기본 오디언스는 삭제할 수 없습니다. |
| listAudienceContacts | 오디언스 하나에 누가 들어 있는지 보여 줍니다. 기본 오디언스를 요청하면 메일함의 모든 연락처가 나열됩니다. |
| addContactToAudience | 기존 연락처를 오디언스에 넣습니다. 연락처를 새로 만들지는 않는데, 잘못 입력한 주소가 아무도 원하지 않은 영구적인 행이 되어 버리기 때문입니다. |
| removeContactFromAudience | 연락처를 오디언스에서 뺍니다. 메모와 다른 오디언스는 그대로 둔 채 연락처로 남습니다. |
모든 메일함에는 모든 연락처를 담은 기본 오디언스가 있으며, 여기서 유일하게 삭제하거나 덜어 낼 수 없는 것이 이것입니다. 거기서 누군가를 빼면 listContacts에는 보이는데 listAudienceContacts에는 보이지 않는 연락처가 생기고, 이는 스스로 어긋나는 주소록입니다. 메일함에서 누군가를 완전히 지우는 것은 deleteContact입니다.
여기 있는 어떤 것도 오디언스로 메일을 보내지 않으며, 그렇게 하는 도구도 없습니다. 오디언스는 연락처를 묶는 방법이지 구독 목록이 아니고, 누군가를 오디언스에 넣어도 메일은 전혀 나가지 않습니다.
연락처를 목록에 추가하는 것은 연락처가 아니라 목록에 쓰는 일이므로 contacts:write가 아니라 audiences:write로 제한됩니다. 오디언스에 들어 있는 주소를 읽는 데는 audiences:read만 있으면 됩니다.