ClaudeとClarifyを連携する方法 — 接続手順・認証・使えるツール

ClarifyのConnectorをClaudeにつなぐと、CRMの案件・会社・人物・ミーティングを会話で検索し、タスクやレコードの作成まで頼めます。接続はOAuthで、Claudeの設定画面から数クリックで終わります。

迷いやすいのは接続後です。ディレクトリのページに並ぶツール名と、提供元のヘルプに載るツール名が食い違っています。無人で動かす用途ではOAuthが使えず、Personal API keyが要ります。この記事は、接続手順に加えて、この2点と書き込みツールの扱いを順に説明します。

Clarify Connectorとは — 提供元・接続先・認証方式

ClarifyはCRM(顧客管理システム)です。ClaudeのConnectorsディレクトリには「Anthropic verified」の表示付きで載っており、カテゴリは「Productivity」、提供元はClarify、サインインは必須です。ディレクトリへの追加は2026年2月で、接続先は https://api.clarify.ai/mcp です。

ディレクトリの説明文は「Query your CRM. Create records. Ask anything.」です。次のような作業を会話から頼めるとされています。

• 案件・会社・人物・ミーティングの検索
• 自社のICPに合うリード(見込み客)の検索とインポート
• タスク・リスト・メール配信シーケンスの作成
• Clarify Agentsの作成と設定

ページには「Your Clarify data is retrieved in real-time, and permissions are respected.」とも書かれています。データはその都度Clarifyから取得され、操作はログインしたユーザーの権限で動く、という意味です。

認証は2通りあります。

ClaudeのWebとDesktopで接続する

Clarifyのヘルプが示す手順は3つです。

「追加」と「接続」は別の操作です。追加しただけではログインしておらず、ツールは使えません。一覧に出ているのに繋がらないときは、「Settings」→「Connectors」でClarifyを探し、「Connect」を押してOAuthをやり直します。

Claude Business planでは、手順1を組織の管理者が済ませる必要があります。メンバーの画面にClarifyが出ないときは、管理者に「Settings」→「Connectors」から追加してもらいます。Team・Enterpriseでコネクタを有効にするのはOwnerまたはPrimary Ownerで、有効化してもメンバーが自動で認証されるわけではありません。各自のログインは別に要ります。Ownerが組織側で進める手順の全体像は、ClaudeとLatticeを連携する方法に同じ型の流れがあります。

OAuthの画面が開かないときは、ポップアップブロッカーがリダイレクトを止めている可能性が高いです。ブロッカーをClaudeのドメインで無効にするか、別のブラウザで「Connect」をやり直します。

質問しても、Clarifyを見ずに答えられるとき

ClaudeがConnectorを呼ぶかどうかは、Claude側の判断です。Clarifyが制御できる部分ではありません。質問の文面だけでは、CRMの話だと判断されないことがあります。

Clarifyのヘルプは、確実に呼ばせる方法を3つ挙げています。

1. 会話ごとのConnector設定で、Clarifyがその会話で有効になっているか確かめる(アカウントに追加しただけでは足りません)
2. 最初のメッセージにClarifyの名前を入れる。「in Clarify, which deals moved this week」のような形です
3. プロジェクトを使っているなら、プロジェクトの指示に一行足す

3つ目だけが、毎回の言い直しを省けます。プロジェクトの指示は、次のような文面にできます。

案件・会社・人物・ミーティングに関する質問は、必ずClarifyコネクタで確認してから答える。

これはヘルプの趣旨(「deals, companies, people, or meetingsに関しては、Clarifyコネクタを使うよう指示する」)を日本語に直した一例です。文面そのものはヘルプに載っているわけではありません。

Claude Codeで接続する

Claude Codeでは、ターミナルからHTTPサーバーとして追加します。

claude mcp add --transport http clarify https://api.clarify.ai/mcp

追加したら、Claude Codeの会話で /mcp を入力し、Clarifyのサーバーを選んでOAuthログインを済ませます。同じ型の手順を別のCRMで書いた記事にAttio MCPをClaudeにつないでCRMを検索・更新する手順があり、コールバックURLを手で貼る場合の対処などはそちらが詳しいです。

claude.aiで追加したConnectorとは別に、Claude Code側へ claude mcp add で入れる形です。同じClarifyを両方に入れると経路が二重になるので、使う側を決めておくと切り分けが楽です。

スケジュール実行にはPersonal API keyを使う

OAuthログインは、定期的に再認可が必要です。夜間バッチや定期実行のエージェントが、再認可のところで止まってしまいます。そういう無人の用途のために、Clarifyのヘルプは次のヘッダーでの認証を案内しています。

Authorization: api-key YOUR_API_KEY
X-Clarify-Workspace: your-workspace-slug

注意点は2つあります。

• Personal API keyだけが使える。Workspace keyで繋ぐと、全ツールが「利用可能」と表示されたうえで、すべての呼び出しが失敗します。鍵は「Settings」→「Workspace」→「API Keys」で作ります
• 作るのに管理者権限は要らない。ワークスペースのメンバーなら誰でもPersonal keyを作れます。有効化のスイッチもありません

Clarify APIのドキュメントも同じ条件で、Personal keyのみ受け付け、Workspace keyは拒否されると書いています。パートナー連携はOAuth 2.0でも認証できるとされています。

エージェントにAPIを叩かせる場合の注意が、APIのドキュメントにもあります。多くのエージェントは既定でBearer認証を使うため、Clarifyの api-key 方式であることを伝える必要があります。また、先に読み取り操作だけで試し、正しく読めることを確かめてから、書き込みや削除を許すよう勧めています。

使えるツール — ディレクトリのページと提供元ヘルプの食い違い

ここが、この連携でいちばん混乱しやすい点です。

ClaudeのConnectorsディレクトリのページに並ぶツール名には、create-records・update-records・create-list・update-list・get-campaign・list-campaigns・create-custom-object などがあり、ページ末尾は「Show all 26 tools」です。一方でClarifyのヘルプは、create-record・update-record・create-list の名前は置き換えられ、現在は create-or-update-records と create-or-update-list だと書いています。

つまり、Claudeのディレクトリ上の一覧と、Clarifyが現在公開しているツール名は一致しません。手元のClaudeが古いツール一覧で動いていると、次のエラーになります。

MCP error -32602: Tool ... not found

読み取りのクエリは通るのに、レコードの作成・更新やリスト作成だけが「Tool not found」になる、という出方です。原因はクライアント側が古いツール一覧を持っていることです。ヘルプの対処は、Clarifyのアプリをクライアントから一度外して、追加し直すことです。再接続しただけでは直りません。ツール一覧は、接続ではなくアプリの掲載情報から来るためです。Claude Codeやコマンドラインの直接接続は、常に現在のツール一覧を読み込みます。

読み取りのツール

Clarifyのヘルプが「Reading data」に挙げるのは次のツールです。

get-schema の説明には注意書きがあります。一覧は、読める対象をすべて網羅しているわけではありません。載っていない項目やエンティティは「使えない」ではなく「不明」として扱い、まずクエリを試すように、と書かれています。コメントも query-data で読めます。コメント用のテーブルに対して、エンティティとowner_idで絞ります。

書き込みのツール

「Writing data」に挙がるツールは、レコードの変更だけではありません。

• レコード: create-or-update-records(1回の呼び出しで最大25件)、delete-records、merge-records、add-comment
• リストとカスタムオブジェクト・フィールド: create-or-update-list、delete-list、create-or-update-custom-object、delete-custom-object、create-or-update-fields、delete-fields
• キャンペーン: create-campaign(下書きで作成)、update-campaign、delete-campaign、import-leads
• エージェント: create-or-update-agent、delete-agent
• カレンダーとメール: create-or-update-calendar-event、delete-calendar-event、respond-to-calendar-event、send-email、create-email-draft
• ミーティング: import-meeting-transcript、create-meeting-snippet
• アクセス管理: manage-access(リスト・ミーティング・メッセージの共有先を付与・更新・取り消し)
• フィードバック: submit-feedback

メールは send-email が実際に送信し、create-email-draft はGmailまたはOutlookに下書きを作るだけです。manage-access は、自分がアプリ内で付与できる範囲、かつすでに管理できるオブジェクトに限って動きます。Claudeを使っても、できることが広がるわけではありません。

書き込みを任せる前に決めておくこと

ツールには、取り消しにくい操作が混ざっています。delete-records・delete-fields・delete-custom-object・send-email が代表です。Claude側の承認設定で、種類ごとに扱いを分けられます。

Team・EnterpriseのOwnerは、組織全体でConnectorの操作を絞れます。たとえば読み取りは許し、書き込みは禁止する、といった設定です。権限は種類別に並び、カテゴリごと、または個別に「Always allow」「Needs approval」「Blocked」から選びます。この設定は組織全体に効き、個々のユーザーは上書きできません。設定画面の見方はClaudeのツールアクセス設定にあります。

承認の挙動にも注意が要ります。Claudeなどのクライアントは、ツールごとに承認を求めます。無人のエージェントの呼び出しは、承認が得られず自動で辞退されることがあり、そのときのメッセージが「no approval received」です。これはClarifyではなく、クライアントの承認ステップから出ます。承認を求められたら許可するか、クライアントのツール設定で「always allow」にします。

流れとしては、次の順で広げると安全です。

1. 読み取りだけを許して、query-data で件数や条件が正しく取れるか見る
2. create-email-draft やキャンペーンの下書きのように、送信にならない書き込みを承認制で試す
3. delete-* と send-email は承認制のまま残し、毎回内容を見てから通す

業務での使いどころ

Clarifyのヘルプは、接続後の質問例として次の4つを挙げています。

• 今週フォーカスすべき案件は何か
• 今日のミーティングを一つずつ見て、フォローアップのタスクを作る
• 次のニューヨーク出張で会うべき顧客は誰か
• 直近90日の受注率はいくつか

会話の中で閉じる作業と、Clarifyの中で回し続ける作業が分かれます。1つ目と4つ目のような集計や優先順位づけは、query-data や query-analytics を呼んで会話で完結します。2つ目のようなフォローアップのタスク作成は、create-or-update-records で書き込みます。繰り返す業務は、Clarify Agentsに設定する選択肢もあります。create-or-update-agent があり、Claudeからエージェントの作成・更新ができます。

CRMをClaudeにつなぐ記事は、他のサービスでも同じ構成になります。ClaudeとPipedriveを連携する方法と並べると、サービスごとのツールの粒度の違いが見えます。

CRMの移行には向かない

別のCRMからClarifyへ全レコードを移したい場合、MCP経由は遅くなります。書き込みツールが1回の呼び出しで扱えるのは25件で、AIアシスタント経由だとその単位で順に処理するためです。

ヘルプの勧める手順は、旧CRMから会社・人物・案件をCSVで書き出し、Clarifyのインポーターに取り込む方法です。列の対応づけを行い、1回で取り込み、失敗した行は一覧に出るので、直して再取り込みできます。ミーティングや文字起こしのようにCSVに載らないデータと、取り込み後の整理は、Connectorに任せます。

つまずいたときの切り分け

レコードのリンクを自分のアプリやスクリプトから開きたい場合は、query-data が各行に、get-records が各レコードに、通常のWebアドレスを返します。形は https://app.clarify.ai/workspaces/YOUR-WORKSPACE/objects/ENTITY/records/RECORD-ID です。clarify:// はデスクトップアプリのサインインだけに使われ、レコードを開くカスタムURLスキームはありません。

まとめ

接続そのものは「Add to your team」と「Connect」の2操作で、難所は接続後にあります。ツール名はディレクトリの表示を鵜呑みにせず、書き込みで「Tool not found」が出たらアプリの付け直しを試します。夜間や定期の実行にはPersonal API keyを使い、OAuthとは分けて考えます。

書き込みは、取り消しにくい操作を承認制に残したまま広げる運用が現実的です。大量のレコードを移す用途だけは、MCPではなくCSVのインポーターが向いています。