Corebee Customer Support

Corebee プラグイン

AI エージェントから Corebee のサポート受信トレイを操作できます。会話の振り分け、返信の送信、顧客情報の検索、ナレッジベースの最新状態の維持、サポートレポートの取得が可能です。

Cursor · Grok Bot · Grok Build · Claude Code

このプラグインは、エージェントをCorebeeのホスト型MCPサーバーに接続し、安全な使い方をエージェントに伝える6つのスキルを追加します。OAuthでサインインします。貼り付けるAPIキーはありません。

クイックスタート

1. クライアントにプラグインをインストールします（インストールを参照）。
2. クライアントから求められたらサインインします。サーバーに接続すると、ツールが実行される前に、ブラウザーでCorebeeのサインインと同意のページが開きます。表示される場所はクライアントによって異なります。
   • Cursor： マーケットプレイスの掲載ページにあるインストールボタンを使うか、/add-plugin corebeeを実行します。Cursorがプラグインをインストールし、Corebeeのサインインページを開きます。ブラウザーが開かなかった場合は、サイドバーのカスタマイズでcorebeeを探し、そこから接続してください。ここでCursorのMCPサーバーを管理できます。
   • Grok Bot： プラグインを追加し、Grok Botから求められたら接続を承認して、ブラウザーでサインインを完了します。サインインウィンドウが早く閉じすぎた場合は、プラグインの項目から再度開いてください。その後、プラグインはインストール済みプラグインに表示されます。
   • Grok Build： /pluginsでCorebeeを有効にし、Grokから求められたらブラウザーでサインインを完了します。
   • Claude Code： /mcpを実行してcorebeeを選び、認証を選択するか、シェルからclaude mcp login corebeeを実行します。Claude CodeにCorebeeのツールが表示されるのは、その後です。
3. 承認したら、Corebeeの受信トレイについてエージェントに質問し、変更を加える前にエージェントの提案を確認してください。

質問できること

質問	スキル
「Corebeeで未解決の会話を確認して、優先順位と担当者を提案して。」	corebee-inbox-triage
「ナレッジベースをもとにDanaの最新の会話への返信を下書きして。送信前に見せて。」	corebee-reply-drafting
「電話の前に、[email protected]について分かっていることを教えて。」	corebee-customer-lookup
「ナレッジベースでこの5つの質問に回答できますか？できなければ、新しい返品ページを追加して。」	corebee-knowledge-base
「CSATと過去30日間の傾向を含む、今月のサポートレポートを作成して。」	corebee-support-report
「チャットウィジェットをブランドカラーに変更して、左側に移動して。」	corebee-widget-setup

「Corebeeで対応待ちの会話を一覧表示して」や「今週、各エージェントが解決した会話はいくつ？」のように、単一のツールを指定して依頼することもできます。

インストール

Corebeeアカウントが必要です（サインアップ）。クライアントがサーバーに接続すると、ツールが実行される前に、ブラウザーでCorebeeのサインインと同意のページが開きます。

Cursor

• コミュニティディレクトリ（現在利用可能）： cursor.directoryのCorebeeを開き、Cursorに追加を選択します。これにより、MCPサーバー、6つのスキル、ルールを含むプラグイン全体がインストールされます。
• Cursorマーケットプレイス： 掲載は審査中です。公開後は、マーケットプレイスまたはカスタマイズからインストールできるようになります。
• MCPサーバーのみ： CursorにCorebee MCPを追加。スキルとルールを含めずにサーバーを追加します。
• ローカルテスト： このリポジトリを~/.cursor/plugins/local/corebeeにコピーし、Developer: Reload Windowを実行してから、カスタマイズを確認します。

Grok Bot

Pluginsを開き、Corebeeを検索してAdd to Grok Botを選択します。Grok BotではCursor Marketplaceの掲載情報を使用するため、ほかにインストールするものはありません。Cursorへの掲載が開始されると、Corebeeが表示されます。

Grok Build

xAIのカタログから：/pluginsを開き、MarketplaceタブからCorebeeをインストールします。xAIがカタログへの掲載項目を審査するため、Corebeeがまだ掲載されていない場合は、このリポジトリからインストールしてください。

このリポジトリから：v1.0.0タグ（またはレビュー済みのコミット）をチェックアウトして~/.grok/plugins/corebeeにクローンするか、--plugin-dir <path to the clone>を指定してGrokを起動します。その後、/pluginsを開き、Corebeeを有効にします。Grokは./.grok/plugins/、~/.grok/plugins/、および任意の--plugin-dirパスからプラグインを読み込みます。このプラグインにはMCPサーバーが1つと6つのスキルが含まれており、フックやスクリプトはありません。そのため、有効にしてもマシン上で実行されるものはありません。

Claude Code

/plugin marketplace add Corebee-AI/corebee-plugin
/plugin install corebee@corebee

MCPサーバーのみ：

claude mcp add --transport http corebee https://corebee.ai/api/v1/mcp/stream

どちらの場合も、/mcpを実行してcorebeeを選び、Authenticateを選択してサインインするか、シェルからclaude mcp login corebeeを実行します。その後にのみ、Claude CodeにCorebeeのツールが表示されます。

その他のMCPクライアント

ストリーミング可能なHTTPとOAuthに対応しているクライアントであれば、コールバックがhttps、またはループバックホスト（localhost、127.0.0.1、[::1]のいずれか。ポートは任意）のプレーンなhttpである限り動作します。Corebeeが受け付ける唯一のプライベートなアプリスキームは、Cursor独自のデスクトップコールバックcursor://anysphere.cursor-mcp/oauth/callbackです。これは、プラグインにmcp.jsonおよび.mcp.jsonとして同梱されているものと同じファイルです。

{
  "mcpServers": {
    "corebee": {
      "type": "http",
      "url": "https://corebee.ai/api/v1/mcp/stream"
    }
  }
}

含まれるもの

コンポーネント	パス	ホスト
Corebee MCPサーバー（ホスト型、OAuth）	mcp.json、.mcp.json	すべて
スキル：受信トレイのトリアージ、返信の下書き、顧客の検索、ナレッジベース、サポートレポート、ウィジェットの設定	skills/	すべて
ルール：Corebeeツールの安全な使用（タスクにCorebeeが関係する場合に適用）	rules/corebee.mdc	Cursor
マニフェスト	.cursor-plugin/、.grok-plugin/、.claude-plugin/	ホストごとに1つ

フック、スクリプト、バイナリ、テレメトリーはありません。scripts/validate.mjsはCIでのみ実行され、ホストによって読み込まれることはありません。

サインインと権限

• PKCE と動的クライアント登録に対応した OAuth 2.1 です。クライアントがサインイン情報を自動的に検出し、トークンを保持します。プラグインは認証情報を保存しません。
• 接続は、サインイン時に選択した Corebee ワークスペースで、あなたに代わって動作します。別のワークスペースに接続するには、先に Corebee でワークスペースを切り替えてください。
• アクセストークンの有効期間は 1 時間です。リフレッシュトークンの有効期間は 30 日で、使用するたびにローテーションされます。
• アクセス権はあなたのロールに従います。 クライアントがどのスコープを要求しても、接続に付与される権限が現在のロールで許可される範囲を超えることはありません。また、Corebee はリクエストを受け取るたびにあなたのロールとメンバーシップを再確認します（各サーバーでの結果のキャッシュ期間は最大 30 秒です）。ロールが引き下げられると、約 30 秒以内に接続が新しいロールの権限に制限されます。ワークスペースを退会すると、約 30 秒以内に接続が機能しなくなります。昇格しても既存の接続の権限は拡大されません。追加のアクセス権を得るには、再接続してください。

ロール	接続に付与できるスコープ
Owner	11 個すべてのスコープ
Agent	会話、連絡先、ナレッジの読み取りと書き込みに加え、metrics:read と settings:read。削除および設定変更はできません。
Viewer	読み取り専用：conversations:read、contacts:read、knowledge:read、metrics:read、settings:read

ロールが admin と表示されるメンバー（list_team_members が引き続き返すことがあるレガシーロール）には、Agent のスコープが付与されます。

スコープ	許可される操作
conversations:read	会話の一覧表示、読み取り、エクスポート
conversations:write	返信、内部メモの追加、割り当て、クローズ、優先度の設定、ラベル付け、スヌーズ、タグ付け
contacts:read / contacts:write	連絡先の検索と読み取り／作成、更新、メモの追加
contacts:delete	連絡先の削除（連絡先を削除しても、関連する会話、メッセージ、CSAT 回答、通話記録などのレコードは保持されます）
knowledge:read / knowledge:write	ソースの一覧表示、読み取り、検索、アシスタントツールの使用／ウェブページソースの追加と更新
knowledge:delete	ナレッジソースの削除
metrics:read	メトリクス、トレンド、レポート
settings:read / settings:write	ウィジェット、チーム、ワークスペースの設定の読み取り／ウィジェット設定の変更

同意画面には、付与されるスコープと、ロールで許可されないスコープが表示されます。選択肢は アクセスを許可 または キャンセル です。スコープを送信しないクライアント（このプラグインの mcp.json はスコープを要求せず、多くのクライアントもスコープを送信しません）には、ロールで許可されるすべての権限が付与されます。同意画面には、そのスコープの一覧が正確に表示されます。Corebee が認識しないスコープだけを要求するクライアントには、読み取りアクセスのみが付与されます。

接続済みアプリの管理

Corebee で 設定 > ログインとセキュリティ > 接続済みアプリ（corebee.ai/settings/security）を開きます。すべてのロールで利用できます。自分が接続したアプリを確認して、取り消すことができます。Owner はここで、すべてのメンバーのアプリを確認して取り消すこともできます。また、設定 > ChatGPT と Claude に接続からも操作できます。取り消すと、現在のアクセストークンも含めて、約 30 秒以内にアプリがサインアウトされます。クライアントからサーバーを削除すると、トークンのコピーは破棄されますが、接続自体は有効期限が切れるか、設定 > ログインとセキュリティ > 接続済みアプリで取り消すまで維持されます。

読み取り専用の接続を希望する Owner には、2 つの方法があります。読み取りスコープのみを要求できるクライアントから接続するか、Viewer ロールのメンバーとして接続してください。

ツール

ホスト型サーバーは、クライアントの接続時にすべてのツールを一覧表示します（検索手順のないフラットな検出）。2026-10-12 時点のスナップショット：44 個のツール（読み取り専用 22 個、書き込み 19 個、破壊的操作 3 個）。パラメーターを含む同じ一覧は scripts/tools.json にあり、CI でこの表と一致していることを確認します。

会話

ツール	スコープ	内容
list_conversations	conversations:read	ステータスまたは担当者（assignee_id。list_team_members の member_id）で、ページあたり最大50件の最近の会話を取得します
get_conversation	conversations:read	最新のメッセージを最大50件（ページ内では古い順）含む会話を1件取得します。has_more が true の場合は、before に next_before を渡すと、その前の50件のメッセージを取得できます
bulk_export_conversations	conversations:read	最大25件の会話を含むCSVを取得します
reply_to_conversation	conversations:write	会話のチャネルで返信を送信するか、内部メモとして保存します（詳細）
assign_conversation	conversations:write	チームメンバーに割り当てるか、割り当てを解除します
close_conversation	conversations:write	解決済みとしてマークします
reopen_conversation	conversations:write	解決済みまたはスヌーズ中だった会話などのステータスを、オープンに戻します。顧客には何も送信されません
add_conversation_note	conversations:write	チームが受信トレイで確認できる内部メモを追加します。顧客には表示されず、どのチャネルにも何も送信されません
set_priority	conversations:write	優先度を低、中、高、緊急に設定します
add_label	conversations:write	IDでラベルを追加します。ラベルを一覧表示するツールはないため、ラベルIDが必要です
bulk_close_conversations	conversations:write	最大25件を解決済みにします
bulk_snooze_conversations	conversations:write	最大25件を指定した時刻までスヌーズします
bulk_tag_with_sentiment	conversations:write	最大25件にセンチメントのタグを付けます
bulk_add_note	conversations:write	最大25件に同じ内部メモを追加します

連絡先

ツール	スコープ	内容
list_contacts	contacts:read	ページあたり50件です。検索では、入力した名前またはメールアドレスの一部に一致します。ただし、* は任意の1文字に一致します
get_contact	contacts:read	詳細、カスタム属性、最新のメモ、最近の会話を取得します
create_contact	contacts:write	連絡先を作成します（メールアドレス、電話番号、名前のいずれかが必須です。同じメールアドレスまたは電話番号がある場合、作成は拒否されます）
update_contact	contacts:write	渡されたフィールドのみを変更します
add_contact_note	contacts:write	連絡先に内部メモを追加します
delete_contact	contacts:delete	破壊的な操作です。連絡先とそのメモを削除します。会話、メッセージ、CSAT回答、通話記録、その他の関連レコード（NPS回答など）は保持され、リンクが解除されます（2段階）
bulk_delete_contacts	contacts:delete	破壊的な操作です。最大25件の連絡先とそのメモを削除します。会話、メッセージ、CSAT回答、通話記録、その他の関連レコードは保持され、リンクが解除されます

ナレッジベース

ツール	スコープ	内容
list_knowledge_sources	knowledge:read	ステータスとチャンク数を含む最大50件のソースを取得します
get_knowledge_source	knowledge:read	処理ステータスを含むソースを1件取得します
search_knowledge	knowledge:read	インデックス化されたコンテンツをテキスト検索します（セマンティック検索ではありません）
add_knowledge_url	knowledge:write	ウェブページを追加します。インデックス作成はバックグラウンドで実行されます
update_knowledge_source	knowledge:write	ソース名またはURLを変更します
delete_knowledge_source	knowledge:delete	破壊的な操作です。ソースと、そこからインデックス化されたすべてのデータを削除します。そのソースを参照していたナレッジギャップは保持され、リンクが解除されます（2段階）

メトリクスとレポート

ツール	スコープ	内容
get_metrics	metrics:read	会話、連絡先、メッセージ、ナレッジの件数、CSAT、平均初回応答時間
get_agent_performance	metrics:read	チームメンバーごとの割り当て件数、解決件数、解決率
get_channel_analytics	metrics:read	チャネルごとの会話数とメッセージ数
get_trends	metrics:read	日別または週別の7日、30日、90日分の推移
export_report	metrics:read	件数のみ（summary）、または連絡先の詳細を含む最大100行（json）
export_report_task	metrics:read	バックグラウンドのMCPタスクとして実行する、件数のみのレポート

ウィジェットとワークスペースの設定

ツール	スコープ	内容
list_widgets	settings:read	widget_id付きのチャットウィジェット一覧
get_widget_settings	settings:read	ウィジェットの外観と動作
list_team_members	settings:read	最大50名のメンバー。役割とmember_idを含む
get_organization_settings	settings:read	プラン、ステータス、AI設定
update_widget_settings	settings:write	色、ウェルカムタイトル、返信時間、チャット前フォーム
configure_widget_appearance	settings:write	色、ウェルカムタイトル、ロゴ、位置
configure_widget_behavior	settings:write	返信時間、チャット前フォーム

アシスタント

読み取り専用のヘルパーです。それぞれtask_description（任意のcontextとhistoryも指定可能）を受け取り、answered、response、confidence、提案するactionsを返します。実行や書き込みは行いません。4つのうち3つはAIモデルを使わず、固定されたキーワードルールを使用します。

ツール	スコープ	内容
a2a_knowledge_agent	knowledge:read	ナレッジエージェント（AIモデルを実行する唯一のエージェント）：関連性の高いインデックス済みの文章を最大5件見つけ、それらのみを基に出典を明記した短い回答を作成します。モデルを利用できない場合は、最適な文章の抜粋をconfidenceを下げて返すため、回答を信頼する前にconfidenceと出典を確認してください。関連情報が見つからない場合や検索を実行できなかった場合はansweredがfalseになるため、search_knowledgeで確認してください。ワークスペースあたり毎分30回までに制限されています
a2a_escalation_agent	knowledge:read	エスカレーションエージェント：渡されたテキストにある担当者への依頼、不満、問題の繰り返しをキーワードルールで検出し、優先度付きの引き継ぎを提案します。引き継ぎや通知は行いません
a2a_diagnostic_agent	knowledge:read	診断エージェント：6つの領域（サインイン、パフォーマンス、チャットウィジェット、メール、請求、データ欠落）を対象にしたキーワードルールにより、一般的な原因の可能性と対処手順を返します。アカウントやデータは参照しません
a2a_action_agent	knowledge:read	アクションエージェント：詳細を入力せずに実行できる受信トレイのアクション（割り当て、クローズ、優先度設定、ラベル付け、スヌーズ、メモ、移動）を、キーワードルールで提案します。詳細を補完し、対応するツールを使って実行してください

プロンプト： summarize_conversationとdraft_reply。リソース： conversations://open、metrics://dashboard、knowledge://sources、conversation://{id}。

返信

reply_to_conversationは、Corebeeの受信トレイと同じ送信経路を使用します。

• メール、SMS、WhatsApp、Slack、Messenger、Instagram、Telegram、Microsoft Teams、Discordへの返信は、そのチャネルから送信されます。ウェブチャットへの返信は、顧客のチャットウィンドウに表示されます。
• プロバイダーが返信を受け付けた場合、またはチャットウィンドウへの送信が行われた場合、結果はdelivered: trueを示します。その後に発生したバウンスは反映されません。
• delivered: falseの場合は理由が示されます。電話の会話や送信手段のないチャネルでは、返信は会話に保存されますが、送信されません。
• private: trueを指定すると、顧客には表示されない内部メモが保存されます。
• 再試行を安全に行うには、idempotency_keyを渡してください。返信の送信を取り消すことはできません。
• 返信はあなたとして送信されます。担当者に引き継がれた会話では、人間による応答として扱われるため、CorebeeのAIはその会話での回答を停止します。

削除

削除は2回の呼び出しで行います。最初の呼び出しでは何も削除されず、プレビューとconfirm_tokenが返されます。5分以内に同じ呼び出しをそのトークンとともに繰り返すと、削除が実行されます。トークンは1回のみ、同じ項目に対してのみ使用できます。2回目の呼び出しに対するクライアントの承認プロンプトが人による確認となるため、承認する前にプレビューを確認してください。削除できるのはオーナーのみです。

• delete_contactとbulk_delete_contactsは、連絡先とそのメモ、チャネル ID、保存された AI メモリを削除します。連絡先の会話とすべてのメッセージは、連絡先へのリンクを解除した状態で受信トレイに残ります。また、CSAT の回答、通話記録、その他の関連レコード（NPS の回答など）も同様に保持されます。プレビューでは、保持される会話の数がlinked_conversations_keptとして報告されます（conversations_to_deleteは同じ値を持つ非推奨の別名で、次のリリースで削除されます）。サーバーが関連レコードのリンクを解除できない場合、呼び出しは「何も削除されませんでした。」というメッセージとともに失敗し、連絡先は変更されません。リンクを解除した後に削除自体が失敗した場合も連絡先は残りますが、CSAT の回答と通話記録のリンクはすでに解除されています。
• delete_knowledge_sourceは、ソースとそのインデックス化されたチャンク、スキャン履歴、タグ、バージョン履歴、引用レコードを削除します。そのソースを参照していたナレッジギャップは、リンクを解除した状態で保持されます。失敗する可能性がある箇所は同じ2か所です。ナレッジギャップのリンク解除に失敗すると何も削除されず、削除自体に失敗するとソースは残りますが、ナレッジギャップのリンクはすでに解除されています。

安全性

• すべてのスキルは、顧客からのメッセージ、連絡先のフィールド、ナレッジベースのテキストを信頼できないデータとして扱い、その中の指示には決して従いません。
• スキルはまず情報を読み取り、見つかった内容を提示してから、変更のたびに確認を求めます。正確な文面を確認し、「送信」と指示した後にのみ返信が送信されます。
• すべてのツールには読み取り専用かどうかが注記され、削除には破壊的操作であることが明記されるため、承認を求めるクライアントは読み取りと変更を区別できます。
• ワークスペースごとの上限は、すべて上限を超えた場合に処理を拒否する方式です。返信は1分あたり30件、単一削除はツールごとに1分あたり10件、一括呼び出しは1分あたり5回（各回最大25項目）、a2a_knowledge_agentの呼び出しは1分あたり30回です。削除の2つの手順はどちらも回数に数えられます。

顧客のテキストを読むあらゆるエージェントには、プロンプトインジェクションのリスクがあります。承認する前に、エージェントが提案する内容を確認してください。

データとプライバシー

• 会話や連絡先の詳細を含むツールの結果は、AI クライアントとそのモデルプロバイダーに送信され、それぞれの規約に従って取り扱われます。
• Corebee は、ワークスペースのデータをプライバシーポリシー、利用規約、データ処理契約に従って取り扱います。
• format: jsonを指定したexport_reportは、連絡先の氏名、メールアドレス、電話番号を返します。デフォルトのsummary形式では件数のみが返されます。
• これらのツールで連絡先を削除しても、その連絡先の会話、メッセージ、CSAT の回答、通話記録、その他の関連レコード（NPS の回答など）は消去されません。顧客のデータを完全に削除するには、[email protected]にお問い合わせください。
• プラグイン自体は何も収集しません。PRIVACY.mdをご覧ください。
• AI クライアントが通信するのはcorebee.aiのみです。MCP エンドポイントhttps://corebee.ai/api/v1/mcp/streamと、同じホスト上にあるCorebeeのOAuthエンドポイントおよびディスカバリーメタデータが対象です。サインインページと同意ページはブラウザーで開く通常のCorebeeウェブページであり、同意のうえで読み込まれる分析ツールを含め、CorebeeのプライバシーポリシーおよびCookieポリシーの適用対象です。

トラブルシューティング

問題	対処方法
サインイン後、Cursor に戻らない	Cursor デスクトップは cursor://anysphere.cursor-mcp/oauth/callback に戻るため、ブラウザーから Cursor を開けるようにしてください。
"redirect_uri must be https, or http on loopback only"	クライアントがリモートホスト上の通常の http コールバックを登録しています。https またはループバックのコールバックを使用するクライアントをお使いください。
"no supported redirect_uri; use https or http loopback"	クライアントが独自アプリのコールバック（プライベートスキーム）のみを提示しています。Corebee では、Cursor 独自のデスクトップコールバックを除き、これを受け付けません。https またはループバックのコールバックを使用するクライアントをお使いください。
401 または "needs login"	サーバーを再接続して、もう一度サインインしてください。アプリを取り消した直後（Settings > Login & security > Connected apps）や、ワークスペースから退出した場合にも発生します。
"Insufficient permissions. Required scope: ..."	ご自身のロールでは許可されていないか、クライアントが読み取りスコープのみを要求しています。オーナーに依頼するか、再接続してクライアントに書き込みスコープを要求させてください（またはスコープを指定しないでください。その場合、ご自身のロールで許可されているすべての操作が可能になります）。
"This workspace has N widgets; pass widget_id."	list_widgets を呼び出し、使用する widget_id を渡してください。
削除時に confirmation_required が返される	想定どおりの動作です。プレビューを確認してから、confirm_token を使って2回目の呼び出しを承認してください。
"confirm_token is invalid, expired, already used..."	トークンを指定せずに削除を再実行し、新しいプレビューを取得してください。
確認後に "Error deleting contact"（一括ツールの場合は "Error deleting contacts"）または "Error deleting knowledge source" が表示される	何も削除されていません。サーバーが項目に紐づくレコードをクリアできなかったか、紐づきをクリアした後に削除自体が失敗しています。後者の場合、コンタクト（またはソース）は残っていますが、CSAT の回答と通話記録（またはナレッジの不足項目）との紐づきは解除されています。プレビューからやり直してください。再度失敗する場合は、[email protected] にお問い合わせください。
set_priority、add_label または assign_conversation が値の不足で失敗する	値を明示的に渡してください。ホスト型サーバーでは値を尋ねることができません。
返信で delivered: false が返される	reason を確認してください。電話での会話の場合は、Corebee の受信トレイでフォローアップしてください。
レート制限エラー	1分待ってから、もう一度お試しください。
add_knowledge_url が pending を表示する	インデックス作成はバックグラウンドで実行されます。list_knowledge_sources で再度確認してください。

サポート

• メール：[email protected]
• ヘルプセンター：https://corebee.ai/help
• プラグインのバグ：GitHub の課題
• 料金：プラグインは無料のオープンソースですが、Corebee アカウントが必要です（料金）

セキュリティ

脆弱性は [email protected] へのメール、または GitHub の非公開脆弱性報告 から非公開で報告してください。SECURITY.md をご覧ください。

ライセンス

MIT。Corebee の名称とロゴは COREBEE CHAT LTD の商標であり、MIT ライセンスの対象ではありません。