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.
<!-- carta:instrumentation-fallback -->
<重要>
_instrumentation_v2 は Carta スキルの匿名利用統計です。Carta MCP ツール呼び出しの引数に必ず含めてください。プラグインのフックが実行時に上書きするため、常に送信しても安全です。形式:
_instrumentation_v2: {"skills": ["<プラグイン>:<スキル>", ...], "model": "<モデルID>", "surface": "<値>"}
skills はセッション累積です。この呼び出しだけでなく、これまで読み込まれたすべての Carta スキルをリストアップしてください。各エントリを "プラグイン:スキル" 形式で名前空間化し、古い順に保ち、最後に最近使用したスキルを配置してください。Carta スキルのみをリストアップしてください(carta-cap-table:*、carta-crm:*、carta-investors:*)。Carta 以外のプラグインのスキルは含めません。
surface は実行中の Claude のインターフェイスです:"chat"(claude.ai または Claude アプリ、通常のチャット。Cowork モードではない)、"cowork"(Cowork モード)、"code-terminal"、"code-desktop"、"excel"。これらのいずれにも当てはまらない、または判断できない場合は省略してください。推測や別の値の作成はしないでください。
</重要>
既存の連絡先を部分的に更新します。指定されたフィールド(項目)のみが変更されます。全置き換えではなく部分更新です。まず連絡先 ID を確認し、次に変更内容を集めてから、更新ツールを呼び出します。
ユーザーが連絡先 ID を直接指定した場合は、それを使用してステップ 3 に進みます。
名前または説明のみが与えられた場合は、まず検索してください:
crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<名前>", limit: 10 } })
複数の連絡先がマッチした場合は、リストを提示してユーザーに確認を求めてください(各連絡先の名前、役職、企業、ID を表示)。
ユーザーに何を変更したいのか尋ねてください。更新可能なフィールドは以下の通りです:
| フィールド | 説明 |
|---|---|
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 が不明な場合は、まずスキーマを取得してください:
crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })
重要: 明確に変更されるフィールドのみを含めてください。その他は省略します。
以下を呼び出します:
crm_call_tool({
"name": "crm:update_contact",
"arguments": {
id: "<連絡先ID>",
name: "<更新後の名前>",
title: "<更新後の職務経歴書>",
emailDetail: "<更新後のメール>",
tags: ["<タグ1>", "<タグ2>"],
fields: { "<フィールドID>": "<値>" }
}
})
更新対象でないキーは省略してください。
成功した場合は、変更内容の概要を回答します:
「連絡先 {名前} を更新しました(ID:
{ID})。変更項目: [変更されたフィールド一覧]」
エラーが発生した場合は、エラーメッセージを表示し、以下を提案してください:
/search-contacts で検索してくださいユーザーが同じ変更を複数の連絡先に適用したい場合は、ステップ 1 とステップ 3~4 を各連絡先に対して繰り返してください。最後に概要をまとめます:
「N 件の連絡先を更新しました: [名前一覧]」
<!-- carta:instrumentation-fallback -->
<IMPORTANT>
_instrumentation_v2 is anonymous Carta skill-usage telemetry. ALWAYS include it in your Carta MCP tool-call arguments — the plugins' hooks overwrite it when they run, so always sending it is safe. Shape:
_instrumentation_v2: {"skills": ["<plugin>:<skill>", ...], "model": "<model-id>", "surface": "<value>"}
skills is cumulative for the session: list every Carta skill loaded so far, not only the one driving this call. Namespace each entry "plugin:skill" and keep them oldest-first, with the most recently used skill last. List only Carta skills (carta-cap-table:*, carta-crm:*, carta-investors:*) — never skills from non-Carta plugins.
surface is the Claude surface you are running in: "chat" (claude.ai or the Claude app, i.e. regular chat, not Cowork), "cowork" (Cowork mode), "code-terminal", "code-desktop", or "excel". Omit it entirely if none of those describe your surface or you cannot tell — do not guess and do not invent another value.
</IMPORTANT>
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.
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:
crm_call_tool({ "name": "crm:search_contacts", "arguments": { 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).
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:
crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })
Important: Only include fields that are explicitly being changed. Omit everything else.
Call:
crm_call_tool({
"name": "crm:update_contact",
"arguments": {
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.
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:
/search-contacts to find itIf 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 による自動翻訳です。