MCPサーバー

連絡先

このメールボックスが書き送る相手のアドレス帳。

連絡先のツール

ツール	機能
listContacts	このメールボックスが書き送る相手を、やり取りの新しい順に並べる。名前やアドレスで検索する、1 つのオーディエンスに絞り込む、誰かが追加したものと自動で記録されたものを分ける、といったことができる。
getContact	メールアドレスで 1 件の連絡先を取得する。メモは全文で、所属するすべてのオーディエンスも含む。
createContact	連絡先を手で追加する。1 アドレスにつき 1 連絡先なので、すでにあるアドレスは二重に書き込まれず拒否される。新しい連絡先は既定のオーディエンスに入る。
updateContact	連絡先の名前や、そこに残してあるメモを変更する。null を渡すとフィールドが消去され、渡さなければそのまま残る。
deleteContact	連絡先を恒久的に削除する。メモも一緒に消え、所属していたすべてのオーディエンスからも消える。

連絡先は保存した人ではなくメールボックスに属するので、同じロールを持つ同僚は同じ帳簿を読み書きする。アプリのコンポーザーからあるアドレスへ初めてメッセージが出ていったとき、連絡先は自動的に記録される。あるアドレスからメールが届いても、何も書き込まれない。

アドレスが識別子であり、id は存在しない。したがって updateContact ではアドレスを変更できず、誰かを新しいアドレスへ移すには createContact と deleteContact を行うことになる。createContact は source を取らない。ここで作られたものはすべて manual であり、送信によって auto に引き下げられることはない。

ここにあるものは何も送信せず、誰かを何かに購読させることもない。deleteContact も誰の購読も解除しない。このメールボックスは購読状態をまったく保持していないからだ。メールボックスが書き続けているアドレスは、次の送信でふたたび記録される。そのときメモもオーディエンスも付かない。