Carta CRMから顧客情報記録(注記データ)を検索して取得します。 次のような場合に使用: ユーザーが「ノートを探して」「ノートを検索して」「ノートを調べて」「[トピック]に関するノートを見せて」「ノートを一覧表示して」「[キーワード]が含まれるノートを探して」または「/search-notes」と言った場合 ID、タイトル、テキスト内容など、ノートの詳細情報を返します。
Searches for and retrieves note records from the Carta CRM. Use this skill when the user says things like "find a note", "search notes", "look up a note", "show me notes about [topic]", "list notes", "find notes mentioning [keyword]", or "/search-notes". Returns note details including ID, title, and text content.
<!-- carta:instrumentation-fallback -->
<重要>
_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"(Cowork モード)、"code-terminal"、"code-desktop"、または "excel" のいずれかです。これらに当てはまらない場合や判断できない場合は省略してください。推測や架空の値は使用しないでください。
</重要>
search_notes を使用して Carta CRM 内のメモをキーワードで検索します。
検索結果を読みやすいサマリー形式で返します。
ユーザーがキーワードやテーマを提供した場合は、それをそのまま使用します。 検索キーワードが提供されていない場合は、ユーザーに入力を求めます。
crm_view_tool を使用して、ユーザーが並べ替えたりクリックして内容を確認できるインタラクティブなテーブルとして結果を表示します。crm_call_tool と同じ name と arguments を使用します。
crm_view_tool({
"name": "crm:search_notes",
"arguments": {
query: "<検索キーワード>",
limit: 20
}
})
ユーザーがより多くの結果を見たいと要求した場合は limit を増やします。remainingCount > 0 の場合は offset を使用してページネーション(複数ページの表示)を行います。
CRM ビューは組織ごとに有効化されるため、上記の呼び出しが次のように応答する場合があります。
CRM tool 'search_notes' has no view — call it with crm_call_tool instead.
これは異常ではなく正常な応答です。その組織では CRM ビューが有効化されていません。同じ呼び出しを crm_call_tool を通じて再度実行し、結果をテキストでステップ 3 の形式で表示します。crm_view_tool を再試行しないでください。また、このメッセージをユーザーに報告しないでください。
ビューが正常に表示された場合、ユーザーは既にすべてのメモをテーブル形式で画面に見ています。タイトルを改めてリストアップしたり、メモのテキストを再度印字しないでください。テーブルが重複してしまいます。代わりに、ユーザーが実際に求めていた質問に答えるか、1 行で確認してください(例:「料金について言及しているメモは 11 件です」)。
crm_call_tool へのフォールバックが必要だった場合、各メモのタイトル、テキスト(長い場合は約 200 字に短縮)、作成日時、作成者(利用できる場合)を表示します。
ユーザーがテーブルだけでは答えられないことを質問した場合(複数のメモを横断したテーマなど、どのメモが関連しているのか)は、内容を読んで直接答えます。
メモが見つからない場合:
「検索と一致するメモが見つかりません。別のキーワードをお試しください。」
総件数を示し、remainingCount > 0 の場合はページネーション対応を申し出ます。
<!-- 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>
Search for notes in the Carta CRM by keyword using search_notes.
Return results in a readable summary.
If the user provided a keyword or topic, use it directly. If no search term was given, ask for one.
Use crm_view_tool so the result renders as an interactive table the user can sort and
click through. It takes exactly the same name and arguments as crm_call_tool.
crm_view_tool({
"name": "crm:search_notes",
"arguments": {
query: "<search term>",
limit: 20
}
})
Increase limit if the user asks to see more results. Use offset to paginate
when remainingCount > 0.
CRM views are enabled per organisation, so the call above may answer with:
CRM tool 'search_notes' has no view — call it with crm_call_tool instead.
That is a normal response, not a failure — this organisation does not have CRM views
enabled. Retry the call verbatim through crm_call_tool and present the result as text
per Step 3. Do not retry crm_view_tool, and do not report the message to the user.
When the view rendered, the user already sees every note on screen. Do NOT re-list the titles or re-print the note text — that duplicates the table. Answer the question they actually asked, or acknowledge in one line (e.g. "11 notes mention pricing.").
When you fell back to crm_call_tool, display each note's title, text (truncated to
~200 chars if long), and creation date and owner where available.
If the user asked something the table doesn't answer on its own — a theme across the notes, or which one is relevant — read the content and answer that directly.
If no notes are found:
"No notes found matching your search. Try a different keyword."
Note the total count and offer to paginate if remainingCount > 0.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。