Claude Media
ClaudeとBlackthorn Eventsを連携する方法 — Salesforceのイベント管理を会話で操作

ClaudeとBlackthorn Eventsを連携する方法 — Salesforceのイベント管理を会話で操作

Salesforce上のイベント管理アプリBlackthorn EventsのMCPサーバーをClaudeに接続する手順です。管理者の事前設定、権限の継承、ツール数の表記ゆれ、削除の確認フラグまで扱います。

Claude Blackthorn Events連携とは何か

Blackthorn Events連携は、Salesforce上で動くイベント管理アプリ「Blackthorn Events」のMCPサーバーをClaudeにつなぐ仕組みです。サーバー名はBlackthorn Forge MCPで、イベント・参加者・チケット・セッション・フォーム・メール配信を、エクスポートやコピー&ペーストなしに会話で扱えます。

Connectorsディレクトリでは、開発元Blackthorn.ioの「Anthropic verified」表示付きで掲載されています。カテゴリはEducationとNonprofit、追加は2026年8月、サインインは必須です。接続先のURLは https://forge.blackthorn.io/api/mcp です。

データの置き場は変わりません。ForgeはSalesforceの上に載る操作層で、顧客レコードのコピーは持たず、読み書きは標準のSalesforce APIをサインインしたユーザーとして呼びます。

前提

接続前に押さえる4点

  • 先に管理者の設定が要る

    ForgeとSalesforce組織のOAuth接続が一度も済んでいない組織では、Claudeが読むテナント自体がありません。

  • 権限は本人のSalesforce権限

    項目レベルセキュリティと共有ルールを迂回しません。

  • 削除は確認フラグ付き

    削除ツールは confirm: true が無い呼び出しを拒否します。

  • ツール数の表記が3通りある

    掲載ページごとに数が違います。後述します。

接続の手順 — ディレクトリからか、カスタムコネクタか

先にForge側の準備を確かめます。Forgeの管理画面(Admin → Setup)で、管理者がSalesforce組織を接続し終えている必要があります。最初のOAuth接続でテナントが作られ、MCPはそのテナントに接続するためです。

手順

Claudeからの接続

  1. 1

    ディレクトリで探す

    Claudeのコネクタ一覧で「Blackthorn Beacon」を検索し、追加します。URLの入力は要りません。

  2. 2

    手動で追加する場合

    設定のConnectorsからカスタムコネクタを追加し、サーバーURLに https://forge.blackthorn.io/api/mcp を入れます。

  3. 3

    Salesforceでサインインする

    OAuthを選ぶとSalesforceのログイン画面に移ります。同意の操作はそこだけで、パスワードはClaudeにもForgeにも渡りません。

  4. 4

    動作を試す

    「今後30日のイベントを教えて」のような読み取りから始めます。

検索語が「Blackthorn Beacon」で、掲載ページの名前が「Blackthorn Forge MCP」という違いに注意してください。掲載URLの末尾 blackthorn-beacon-event-management-for-salesforce にも、Blackthornのイベント向けAIアシスタントの名前「Beacon」が使われています。見つからないときは検索語を変えるか、手動追加に切り替えます。

OAuthに対応しないクライアント向けには、ForgeのSettings → API tokensでベアラートークンを発行し、コネクタの認証欄に貼る方法があります。トークンはread / write / deleteの任意の組み合わせで発行できます。OAuthやセッションCookieの接続は、3つとも付与されます。

Claude Codeからは、コネクタ設定とワークフロー用スキルをまとめたプラグインも用意されています。

ツール数はなぜ4・94・109・100超と食い違うのか

掲載情報を突き合わせると、数が一致しません。

出どころ書かれている数
Connectorsディレクトリの「Tools」欄書かれている数4つ(salesforce_soql_query など)
ディレクトリの説明文書かれている数冒頭は「over 100」、本文は「94 tools」
MCPエンドポイントが返す目録書かれている数109ツール、プロンプト11、リソース14

4つの名前は salesforce_sobject_create salesforce_sobject_get salesforce_sobject_update salesforce_soql_query です。一方、Forgeのドキュメントの代表例は planner_get_dashboard や planner_create_event のように planner_ で始まります。

どちらが実際にClaudeへ見えるかは、掲載ページからは判断できません。接続後にClaudeへ「planner_catalogを呼んで、使えるツールをグループ別に出して」と頼むと、そのセッションで使える一覧が得られます。エンドポイントの目録によると、カテゴリ別の内訳は次のとおりです。

  • 一般(general): 35
  • レポート(reporting): 27
  • チケット: 16
  • フォーム: 15
  • セッション: 6
  • データ・スポンサー: 各4
  • スピーカー: 2

記事や社内手順書にツール数を書くなら、数ではなく「接続後に目録を確かめる」と書くほうが安全です。

できること — ドキュメントの代表ツールから

Forgeのドキュメントは、ツールを次の系統で示しています。

系統代表的なツール
レポート代表的なツールplanner_get_dashboard planner_get_event_metrics planner_get_roi planner_get_registration_funnel planner_export_attendees
イベント・セッション・チケット代表的なツールplanner_create_event planner_update_event planner_clone_event planner_create_session
参加者代表的なツールplanner_create_attendee planner_checkin_attendee planner_list_attendees
フォーム代表的なツールplanner_create_form planner_add_form_question planner_create_managed_dropdown
メール・オーディエンス代表的なツールplanner_schedule_email planner_list_segments planner_get_email_template
例外の入口代表的なツールplanner_soql_query(SELECTのみ)planner_describe_object

ディレクトリの説明文には、依頼の例も載っています。登録のファネルと離脱箇所を出す、昨年のユーザー会議を複製して10月開催の新しいイベントにする、登録フォームに食事制限の質問を足す、請求がまだのスポンサーを探す、といったものです。イベントの複製は、先に実行内容を確認するドライランがあると説明されています。

ツールはイベント名からSalesforceのIDを解決します。生のレコードIDを聞かれたり、内部の項目名が会話に出たりしない設計だと書かれています。

権限と安全装置 — 何が止まり、何が通るか

MCPが持つ権限は、サインインしたユーザーのSalesforce権限と同じです。項目レベルセキュリティで見えない項目は返りませんし、共有ルールで見えないレコードも見えません。ValidationルールやApexトリガーは通常の保存と同じく動き、エラーはそのまま返ります。

Forge側の主な安全装置は次のとおりです。

  • スコープ: 全ツールがread / write / deleteのいずれかを持つ。トークンは部分集合で発行できる
  • 削除: planner_delete_event などは confirm: true が無いと、データを変えずに拒否される
  • SOQL: planner_soql_query はSELECTだけを受け、DMLは拒否される
  • レート: テナントごとに毎分60リクエスト
  • 応答サイズ: 80KBを超える応答は切り詰められ、絞り込みかページ送りを促すメッセージが付く
  • ポータル: スポンサーやスピーカーのマジックリンク経由の接続は、読み取り専用で単一イベントに限られる

接続が切れたりSalesforce側でレート制限に当たったりすると、各ツールは再接続リンク付きの構造化エラーを返します。

Claude側で決めておく運用ルール

OAuth接続のまま使うと、読み取りも書き込みも削除も本人の権限いっぱいまで通ります。調査だけに使うなら、読み取り専用のトークンを発行して接続するほうが事故の幅を狭められます。

プロジェクトの指示ファイルに、次のような規約を置く案があります。以下は例示で、Forgeの仕様ではありません。

Blackthorn Events の操作ルール
- イベントを複製するときは、先にドライランの結果を見せて承認を待つ
- 削除ツールは、対象のイベント名と件数を提示してから呼ぶ
- 集計の質問は、まず planner_get_event_metrics か planner_get_registration_funnel を使う
- planner_soql_query は他に手段がないときだけ使い、LIMIT を付ける

最後の行は、SOQLが「逃げ道」の位置づけだからです。専用のレポート系ツールがある集計は、そちらを先に試すほうが、Salesforce側の項目名を推測させずに済みます。

反映が遅れる・読めないときの切り分け

Forgeのドキュメントにあるトラブルは、そのままClaudeの応答にも出ます。

切り分け

データが期待と違うときの順番

  1. Q管理者がSalesforce組織をForgeに接続済みか?
    答えがいいえのとき

    Admin → Setupで接続を完了します。未接続だとMCPが読む先がありません。

    答えがはい
  2. QBlackthornのパッケージを入れたのは接続より前か?
    答えがいいえのとき

    オブジェクトの対応づけは接続時に作られます。パッケージを後から入れたなら、管理画面から組織を再接続します。

    答えがはい
  3. Q空欄の項目は、本人の項目レベルセキュリティで見えるか?
    答えがいいえのとき

    Salesforceが隠している項目はForgeにも出ません。権限セットを見直します。

    答えがはい

それでも古い

Salesforceで直後に編集した内容は、最大2時間キャッシュされることがあります。頻繁に変わるデータは数分、部屋・トラック・寄付などの更新頻度が低いデータは数時間かかることがあります。

なお、組織のロケール・通貨・タイムゾーンの既定値は、Forgeではまだ自動では反映されません。ドキュメントが既知の不足として挙げています。日時を含む作成依頼は、タイムゾーンを明記して頼むと取り違えを避けられます。

隣り合う連携との使い分け

SalesforceそのものをClaudeにつなぐ手順はClaudeとSalesforceの連携方法にあります。営業向けのスキルをまとめた提供はSalesforce in Claudeの解説が扱っています。商談や取引先を調べたいなら前者、Blackthornのイベントオブジェクトを操作したいなら本記事のコネクタ、という分担です。

コネクタ全般の使い分けはClaude営業連携ガイドにあります。接続前の管理者設定が要る点では、DataGrail連携と似た構造です。

まとめ

接続自体はURLの入力とSalesforceのサインインで済みますが、前提はForge側の管理者設定です。ツール数の表記は掲載ページごとに食い違うため、接続後に目録を取って確かめるのが確実です。イベントの複製や削除のような取り消しにくい操作は、ドライランと確認フラグを前提に、指示ファイルで手順を固定しておくと運用が安定します。

この記事を共有:XはてブLinkedIn