Carta CRM ホーム（営業管理システムの情報表示画面）を表示します。件数、対応待ちのタスク、営業段階ごとのパイプライン（進行中の案件）、今週の予定、そしてこのプラグインが対応しているプロンプト（質問命令）の一覧を表示する画面となります。 次のような場合に使用: ユーザーが「carta crm home」「crm ホームを表示」「crm ダッシュボード」「今日のパイプラインは」「crm ランディングページ」「/home」といった言葉を話した場合 閲覧専用です。特定のレコード（データ）を検索するために使用しないでください。代わりにレコードの名前を指定すれば、Claude が自動的に適切な検索機能を選択します。
Renders the Carta CRM Home: a landing view with counts, open tasks, pipeline by stage, this week's meetings, and a directory of the prompts the plugin supports. Use this skill when the user says things like "carta crm home", "show my crm home", "my crm dashboard", "what's in my pipeline today", "crm landing page", or "/home". Read-only. Do NOT use it to look up a specific record — name the record instead and Claude picks the right search skill.
<!-- 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"。これらのいずれにも該当しない場合、または判断できない場合は省略する。推測や造語は避けること。</重要>
ホームはマニフェスト（設定情報）用ツール 1 つと表示用ツール 1 つで構成されています。サーバーが組織に表示可能なカード（情報パネル）を決定し、表示用ツールが各カードを個別に取得します。あなたの役割はマニフェストを読み込み、新規ユーザーをチュートリアルに案内し、ホームをレンダリング（画面に表示）することです。
まず表示ではなくデータとして呼び出します:
crm_call_tool({ "name": "crm:get_crm_home", "arguments": {} })
何をレンダリングする前に、データとしてマニフェストを読んでください。ステップ 2 でユーザーが別の場所に移動する可能性があります。ホームを表示してから取り下げるのは、初めから表示しないより悪いです。
ホームはロールアウトフラグ（段階的公開の制御）の背後にあります。フラグがオフの場合、サーバーは get_crm_home を登録しないため、呼び出しが「不明なツール」エラーで失敗します。これは失敗ではなく、そのロールアウト対象外の組織に対する正常な応答です。
以降の対応はユーザーの質問内容によって異なります。
| ユーザーの質問内容 | 対応 |
|---|---|
ホーム自体、ダッシュボード、または /home |
そのホームが組織で有効になっていないと伝え、代わりに何が利用可能かを提示する |
| 「今週のパイプラインに何があるか」など、カードに表示されるような具体的な質問 | そのスキル（ここでは search-deals）を通じて質問に答える。ホームについて触れない |
2 行目が重要です。「今週のパイプラインに何があるか」という質問は、すでにプラグインが回答できる実際の質問なので、「ホームが無効」と言って放置するのは、かつてユーザーが得ていた回答を失わせてしまいます。
代替ホームを自分で組み立てないこと。 search_deals、search_tasks、list_calendar_events などを呼び出してカードセットを模倣しないでください。質問をそのスキルに渡すのは問題ありません。スキルは独自のアクセス制御を実行するからです。ホーム風のパネルを自分で構築すると、カードゲーティング（表示権限管理）が実行されないため、組織に見る権限がない情報を表示する可能性があります。
マニフェストには firstTimeUser というフラグが含まれています。これが true の場合、ユーザーは CRM MCP が初めてか、しばらく使用していません。
ホームをレンダリングする代わりに tutorial スキルを実行してください。 リダイレクトが誤りに見えないよう、まず 1 行テキストを表示します:
まずプラグインの使い方をご説明します。その後、あなたのホームが待っています。
チュートリアルの終了時にホームがレンダリングされるため、ユーザーはホームにアクセスできなくなることはありません。ホームを自分で別途レンダリングしないでください。
firstTimeUser が false または存在しない場合、ステップ 3 に進みます。
crm_view_tool({ "name": "crm:get_crm_home", "arguments": {} })
表示用ツールはシェル（枠組み）をレンダリングしてから、すべての利用可能なカードを並行して個別に取得します。各カードにはそれぞれタイムアウトがあります。ここでカード用ツール自体を呼び出さないこと。 カード用ツールは get_crm_home_counts、get_crm_home_tasks、get_crm_home_pipeline、get_crm_home_meetings で、ここから呼び出すと表示用ツールが既に実行している取得処理が重複します。
crm_view_tool が「このツールには表示機能がない」と応答する場合、この組織では MCP アプリバンドルがオフです。ステップ 1 で既に保持しているマニフェストを要約して、インタラクティブなホームを使用するには CRM UI を有効にする必要があることを伝えてください。
| カード | 表示内容 | 非表示の場合 |
|---|---|---|
| 件数（Counts） | テナント全体のオブジェクト数 | — |
| 未完了タスク（Open tasks） | ユーザー本人の未完了タスク | — |
| ステージ別パイプライン（Pipeline by stage） | ステージごとにグループ化された未成立案件 | そのテナントで案件管理モジュールがオフ |
| 今週のミーティング（Meetings this week） | ユーザーの次 7 日間のスケジュール | インタラクション追跡がそのテナントでオフ |
| 利用可能な質問（What you can ask） | プラグインがサポートするプロンプト集 | なし。常に表示される静的コンテンツ |
マニフェストが利用不可と示しているカードには reason（理由）が含まれています。ユーザーがカードが無い理由を聞いた場合、理由を報告してください。有効にするよう勧めないこと。これはテナント権限であり、ユーザー設定ではありません。
ホームには 2 つの出口があります。適切な方を案内してください:
ユーザーがプロンプトを選んだ場合、通常のスキルルーティングに任せてください。ホームのペイロード（データ）から答えようとしないこと。
テナント（組織）データを常にラベル付きで表示すること。 マニフェストには組織名が含まれており、表示用ツールは各カードにスタンプを付けます。realOrganization が存在する場合、ユーザーは Carta スタッフが別のテナントを閲覧しており、表示用ツールがバナーを表示します。どちらの信号も削除したり要約して削除したりしないこと。
ホームは読み取り専用です。 書き込み機能はありません。ユーザーがここからレコードを変更するよう求めた場合、対応する追加または更新用スキルに委譲してください。
<!-- 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>
The Home is one manifest tool plus one view. The server decides which cards this organization may see, and the view fetches each card itself. Your job is to read the manifest, route a new user to the tutorial, and render the view.
Call it for data first, not for the view:
crm_call_tool({ "name": "crm:get_crm_home", "arguments": {} })
Read it for data before you render anything. Step 2 can send the user elsewhere, and a Home that renders and is then retracted is worse than one that never rendered.
The Home is behind a rollout flag. When it is off the server does not register
get_crm_home at all, and the call fails with an unknown-tool error. That is a normal
answer for an organization outside the rollout, not a failure.
What you do next depends on what the user asked for.
| The user asked for | Do this |
|---|---|
The Home itself, a dashboard, or /home |
Say the Home is not switched on for their organization, and offer what they can ask for instead |
| Something a card would have shown, such as "what's in my pipeline today" | Answer the question through the skill that owns it, here search-deals. Do not mention the Home |
The second row is the important one. A phrase like "what's in my pipeline today" is a real question that the plugin already answers, so leaving the user with "the Home is off" would take away an answer they used to get.
Never assemble a substitute Home. Do not call search_deals, search_tasks,
list_calendar_events and the rest to imitate the card set. Handing one question to the
skill that owns it is fine, because that skill runs its own access checks. Building a
Home-shaped panel yourself runs none of the card gating, so it can show an organization
something it is not entitled to see.
The manifest carries firstTimeUser. When it is true, the user is new to the CRM MCP
or has not used it for a while.
Invoke the tutorial skill instead of rendering the Home. Say one line first, so the
redirect does not read as a mistake:
Let me walk you through the plugin first. Your Home is waiting at the end.
The tutorial ends by rendering the Home, so nobody is denied it. Do not render the Home yourself as well.
When firstTimeUser is false or absent, continue to Step 3.
crm_view_tool({ "name": "crm:get_crm_home", "arguments": {} })
The view renders the shell and then fetches every available card itself, in parallel,
each with its own timeout. Do not call the card tools yourself. They are
get_crm_home_counts, get_crm_home_tasks, get_crm_home_pipeline and
get_crm_home_meetings, and calling them here duplicates every fetch the view is
already making.
If crm_view_tool answers that the tool has no view, the MCP App bundle is off for this
organization. Fall back to summarising the manifest you already hold from Step 1, and say
the interactive Home needs the CRM UI enabled.
| Card | Shows | When it is missing |
|---|---|---|
| Counts | Object counts across the tenant | — |
| Open tasks | The user's own open tasks | — |
| Pipeline by stage | Open deals grouped by stage | The deals module is off for this tenant |
| Meetings this week | The user's next seven days | Interaction tracking is off for this tenant |
| What you can ask | Prompts the plugin supports | Never. It is static and always renders |
A card the manifest marks unavailable carries a reason. Report the reason if the user
asks why a card is absent. Do not offer to enable it: these are tenant permissions, not
user settings.
The Home has two exits. Point at whichever fits:
If the user picks a prompt, let the normal skill routing handle it. Do not try to answer from the Home's payload.
Never render tenant data unlabelled. The manifest names the organization, and the
view stamps it on every card. When realOrganization is present the user is Carta staff
viewing another tenant, and the view shows a banner. Do not remove or summarise away
either signal.
The Home is read-only. It never writes. If the user asks to change a record from here, hand off to the matching add or update skill.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。