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.
<IMPORTANT>
_instrumentation_v2 は Carta スキルの匿名利用統計です。Carta MCP ツール呼び出しの引数に必ず含めてください。プラグインのフックが実行時に上書きするため、常に送信しても安全です。形式は以下の通り:
_instrumentation_v2: {"skills": ["<plugin>:<skill>", ...], "model": "<model-id>", "surface": "<value>"}
skills はセッション全体で累積します。これまでに読み込まれた Carta スキルをすべてリストアップしてください(このツール呼び出しを直接駆動するもの以外も含む)。各項目を "plugin:skill" の形式で表記し、古い順から並べて、最後に最後に使用したスキルを置きます。Carta スキルのみをリストアップしてください(carta-cap-table:*、carta-crm:*、carta-investors:* など)。Carta 以外のプラグインのスキルは含めないでください。
surface は実行中の Claude の表示面です:"chat"(claude.ai または Claude アプリ、通常のチャット)、"cowork"(Cowork モード)、"code-terminal"、"code-desktop"、"excel" のいずれかです。どれにも当てはまらない場合や判定できない場合は省略してください。推測や架空の値を入れないでください。
</IMPORTANT>
既存の連絡先情報を部分的に更新します。指定されたフィールドのみが修正され、全体の置き換えではありません。まず連絡先 ID を確認し、変更内容を整理してから、更新ツールを呼び出します。
ユーザーが連絡先 ID を直接指定した場合、それを使用してステップ 3 へ進みます。
名前や説明のみが与えられた場合は、まず検索してください:
crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<name>", 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: "<contact id>",
name: "<updated name>",
title: "<updated title>",
emailDetail: "<updated email>",
tags: ["<tag1>", "<tag2>"],
fields: { "<field_id>": "<value>" }
}
})
更新されないキーは省略してください。
成功時は、変更内容をまとめて報告してください:
「連絡先 {名前} を更新しました(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 による自動翻訳です。