スキルOfficialproductivity

📝update-contact

プラグイン: carta-crm
ソース: GitHub で見る ↗

説明

Carta CRM 内の既存の連絡先（個人）レコードを更新します。次のような場合に使用: ユーザーが「連絡先を更新する」「連絡先を編集する」「連絡先の詳細を更新する」「連絡先のメールアドレスを変更する」「担当者の肩書きを更新する」「連絡先の会社を更新する」「連絡先にタグを追加する」または「/update-contact」などと発言した場合。連絡先の ID または名前を受け付けます（ID が指定されない場合は検索を行います）。明示的に指定されたフィールドのみが変更され、それ以外のフィールドはすべてそのまま保持されます。

原文を表示

Updates an existing contact (person) record in the Carta CRM. Use this skill when the user says things like "update a contact", "edit contact", "update contact details", "change contact email", "update person's title", "update contact company", "add a tag to contact", or "/update-contact". Accepts a contact ID or name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

ユースケース

✓連絡先の情報を更新するとき
✓連絡先のメールアドレスを変更するとき
✓担当者の肩書きを更新するとき
✓連絡先にタグを追加するとき
✓連絡先の会社を更新するとき

本文（日本語訳）

概要

既存のコンタクトを部分的に更新します。指定されたフィールドのみが変更され、既存データの完全な置き換えではなく部分更新となります。まずコンタクトIDを特定し、変更内容を収集してから更新ツールを呼び出してください。

ステップ 1 — コンタクトIDの特定

ユーザーがコンタクトIDを直接指定した場合は、そのIDを使用してステップ3へ進みます。

名前や説明のみが提供された場合は、まず検索を行います:

mcp__carta_crm__search_contacts({ query: "<name>", limit: 10 })

複数のコンタクトが一致した場合は、リストを提示してどれを更新するかユーザーに確認します（各コンタクトの名前・役職・会社名・IDを表示してください）。

ステップ 2 — 更新内容の収集

何を変更したいかをユーザーに確認します。更新可能なフィールドは以下のとおりです:

フィールド	説明
`name`	フルネーム
`firstName`, `lastName`, `middleName`	名前の各パーツ
`emailDetail`	メインのメールアドレス。追加メールは Second / Third / Fourth で指定
`phone`	メインの電話番号。`businessPhone` で会社の電話番号を指定
`title`	役職
`headline`	短い自己紹介またはキャッチフレーズ
`location`	勤務地（市区町村・都道府県・国）
`homeLocation`	自宅住所（市区町村・都道府県・国）
`socialLinks`	linkedinUrl, twitterUrl, githubUrl, facebookUrl
`jobs`	職務経歴の配列 — 既存の職歴を完全に置き換えます
`tags`	タグの配列 — 既存のタグを完全に置き換えます
`notes`	自由記述のメモ
`fields`	フィールドIDをキーとするカスタムフィールドの値

カスタムフィールドを更新したいがフィールドIDが不明な場合は、先にスキーマを取得します:

mcp__carta_crm__get_contact_custom_fields()

重要: 明示的に変更するフィールドのみを含めてください。それ以外はすべて省略します。

ステップ 3 — コンタクトの更新

以下を呼び出します:

mcp__carta_crm__update_contact({
  id: "<contact id>",
  name: "<updated name>",
  title: "<updated title>",
  emailDetail: "<updated email>",
  tags: ["<tag1>", "<tag2>"],
  fields: { "<field_id>": "<value>" }
})

更新しないキーはすべて省略してください。

ステップ 4 — 結果の報告

成功した場合は、変更内容のサマリーを返します:

「コンタクト {name}（ID: {id}）を更新しました。変更されたフィールド: [変更フィールドの一覧]」

エラーが発生した場合は、エラーメッセージを表示し、以下を提案します:

コンタクトIDが正しいか確認する — /search-contacts を実行して検索する
カスタムフィールドIDが有効かどうかを確認する

複数コンタクトの一括更新

同じ変更を複数のコンタクトに適用したい場合は、各コンタクトに対してステップ 1 およびステップ 3〜4 を繰り返します。最後に以下のようにまとめて報告します:

「N 件のコンタクトを更新しました: [名前の一覧]」

原文（English）を表示

Overview

Partially update an existing contact. Only fields provided are modified — this is a partial update, not a replacement. First resolve the contact ID, collect what to change, then call the update tool.

Step 1 — Resolve the contact ID

If the user provided a contact ID directly, use it and skip to Step 3.

If only a name or description was given, search first:

mcp__carta_crm__search_contacts({ query: "<name>", limit: 10 })

If multiple contacts match, present the list and ask the user to confirm which one to update (show name, title, company, and ID for each).

Step 2 — Collect what to update

Ask the user what they want to change. Updatable fields include:

Field	Description
`name`	Full name
`firstName`, `lastName`, `middleName`	Name parts
`emailDetail`	Primary email; Second/Third/Fourth for additional emails
`phone`	Primary phone; `businessPhone` for business number
`title`	Job title
`headline`	Short bio or tagline
`location`	Work location (city, state, country)
`homeLocation`	Home location (city, state, country)
`socialLinks`	linkedinUrl, twitterUrl, githubUrl, facebookUrl
`jobs`	Work experience array — fully replaces existing jobs
`tags`	Tags array — fully replaces existing tags
`notes`	Free-text notes
`fields`	Custom field values keyed by field ID

If the user wants to update custom fields but isn't sure of field IDs, fetch the schema first:

mcp__carta_crm__get_contact_custom_fields()

Important: Only include fields that are explicitly being changed. Omit everything else.

Step 3 — Update the contact

Call:

mcp__carta_crm__update_contact({
  id: "<contact id>",
  name: "<updated name>",
  title: "<updated title>",
  emailDetail: "<updated email>",
  tags: ["<tag1>", "<tag2>"],
  fields: { "<field_id>": "<value>" }
})

Omit any key that is not being updated.

Step 4 — Report result

On success, respond with a summary of what changed:

"Contact {name} updated (ID: {id}). Changed: [list of changed fields]"

On error, show the error message and suggest:

Verify the contact ID is correct — run /search-contacts to find it
Check that custom field IDs are valid

Updating multiple contacts

If the user wants to apply the same change to multiple contacts, repeat Steps 1 and 3–4 for each. Summarize at the end:

"Updated N contacts: [list of names]"

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。