문서로 건너뛰기
MCP 서버

연락처

이 메일함이 메일을 보내는 주소록.

연락처 도구

도구하는 일
listContacts이 메일함이 메일을 보내는 사람들이며, 최근에 주고받은 순서입니다. 이름이나 주소로 검색하고, 특정 오디언스로 좁히고, 누군가 직접 추가한 것과 자동으로 기록된 것을 구분할 수 있습니다.
getContact이메일 주소로 연락처 하나를 가져오며, 메모 전문과 그 연락처가 속한 모든 오디언스를 함께 반환합니다.
createContact연락처를 직접 추가합니다. 주소당 연락처는 하나이므로 이미 있는 주소는 두 번 기록되지 않고 거부됩니다. 새 연락처는 기본 오디언스에 들어갑니다.
updateContact연락처의 이름이나 그에 딸린 메모를 변경합니다. null을 전달하면 해당 필드를 비우고, 생략하면 그대로 둡니다.
deleteContact연락처를 영구적으로 삭제합니다. 메모도 함께 사라지고, 속해 있던 모든 오디언스에서도 빠집니다.

연락처는 저장한 사람이 아니라 메일함에 속하므로, 같은 역할을 가진 동료는 같은 주소록을 읽고 씁니다. 연락처는 앱 작성 창에서 어떤 주소로 메시지가 처음 나갈 때 자동으로 기록되며, 어떤 주소에서 메일이 도착하는 것은 아무것도 기록하지 않습니다.

주소가 곧 신원이며 id는 없습니다. 그래서 updateContact로는 주소를 바꿀 수 없고, 누군가를 새 주소로 옮기는 일은 createContactdeleteContact로 합니다. createContactsource를 받지 않습니다. 여기서 만든 것은 모두 manual이며, 발송이 이를 다시 auto로 낮추는 일도 없습니다.

여기 있는 어떤 것도 무언가를 보내거나 누군가를 구독시키지 않으며, deleteContact는 아무의 구독도 해지하지 않습니다. 이 메일함은 구독 상태를 전혀 보관하지 않기 때문입니다. 메일함이 계속 메일을 보내는 주소는 다음 발송 때 메모도 오디언스도 없이 다시 기록됩니다.