helpdashHelpdash は Model Context Protocol（MCP） のサーバーを提供しています。だから AI アシスタントは、あなたがチケットをチャット画面に貼り付ける代わりに、業務スペースの中で直接 働けます。「今日 SLA を破りそうなチケットはどれ？」や「引き継ぎ用にこのやり取りを要約して」 と頼めば、アシスタントは Helpdash 自身に問い合わせます。
この記事では、コネクタが何を提供するのか、どうつなぐのか、そして — 二度読む価値のある部分 ですが — 何をすることが許されていないのかを扱います。
コネクタが提供するもの
サーバーは 46 のツール、すぐ使える4つのプロンプト、そしてツールが受け付ける列挙値を すべて並べたリソースを備えています。ツールはチケット、ライブチャット、ナレッジベース、 定型文、プロジェクトとメンバー、ダッシュボード、CSAT、自動化ルール、Webhook、設定、 アクティビティログ、請求までを覆います。
読み取りと書き込みは常に別のツールです。method パラメータを持つ何でも屋の
api_request ツールはありません。チケットの検索とチケットの変更は、権限の異なる別々の
ツールなので、読み取り権限を与えられたアシスタントが引数を変えて何かを書き換えることは
できません。
4つのプロンプトは、あらかじめ書いておく価値のある作業の流れです。
- チケットを振り分ける — 優先度、カテゴリ、担当者を提案します。何も変えません。
- 顧客への返信を下書きする — ナレッジベースと定型文を使って文面を作ります。送信はできず、 返信はあなたが確認するために戻ってきます。
- やり取りを要約する — 長いチケットやチャットの記録を、引き継ぎ用に短くまとめます。
- 週次のサポートレポート — 件数、SLA、CSAT、そして注意が要るもの。
クライアントをつなぐ
設定 → AI コネクタ（MCP） を開いてトークンを発行します。あとで見分けられる名前を付け、 最初の一本ではすべての書き込みスイッチを切ったままにして、キーをコピーしてください。表示 されるのはちょうど一度きりです。
次に登録します。Claude Code の場合：
claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
--header "Authorization: Bearer hd_mcp_..."
.mcp.json を読むクライアントの場合：
{
"mcpServers": {
"helpdash": {
"type": "http",
"url": "https://your-workspace.helpdash.io/mcp",
"headers": { "Authorization": "Bearer hd_mcp_..." }
}
}
}
どちらの断片も、あなたの業務スペースのアドレスを埋めた形で、トークンが現れるのと同じ画面に 用意されます。
ブラウザでのサインインを好むクライアントは、静的なトークンの代わりに OAuth 2.1 を使え ます。サーバーは標準的なディスカバリ文書を公開し、PKCE と動的クライアント登録に対応し、 どの範囲が要求されているかを正確に並べた同意画面を表示します。コピーするトークンも、 ディスクに保存する鍵も要りません。
できないこと
コネクタは、二つ目のゆるい API ではありません。どの呼び出しも、人の操作と同じ4つの門を 通ります。
あなたとして動く。 トークンは発行した担当者に結び付きます。その人のロールと権限を正確に 受け継ぐので、あなたがアプリでチケットを開けないなら、あなたのトークンを持つアシスタントも 開けません。そしてひとつの業務スペースに結び付いています。別のテナントのデータに届く引数は 存在しません。
あなたが言わない限り読み取りのみ。 すべてのスイッチを切った新しいトークンは、検索し、 読み、レポートを出せます。それ以上はできません。書き込み権限は領域ごとに与えます — チケットを 変える、ライブチャットで返信する、ナレッジベースを編集する、プロジェクトを管理する、メンバーを 招く、設定を変える、自動化ルールを変える — そのうちあなたが印を付けたものだけです。読み取りは 常に含まれます。書けるのに読めないアシスタントは役に立たないからです。
書き込みのツールはまず尋ねる。 データを変えるツールはすべて破壊的と注記されているので、 行儀のよいクライアントは黙って動く代わりに、呼び出しごとにあなたに確認します。顧客に届く ツールは、それを自らの説明に書いています。ライブチャットのメッセージは即座に届いて取り消せず、 チケットのコメントは既定で社内メモなので、うっかり顧客に届くことがありません。
秘密はサーバー側に留まる。 コネクタ経由で設定を読むと、連携の認証情報は伏せ字で返ります。 それを外す引数はありません。
顧客の書いた文は囲われる。 チケットの説明、コメント、チャットの記録は他の人が書いたもので、 サポートの受信箱はまさに、それを読む AI 向けの指示を仕込もうとする人が現れる場所です。Helpdash はそうした文を明示的な「信頼できない内容」のブロックで包み、サーバー自身の指示の中でモデルに、 その中身は命令ではないと伝えます。
すべて記録される。 どの呼び出しも、担当者・ツール・結果とともに、業務スペースの他の部分と 同じ監査ログに残ります。「アシスタントは火曜日に実際は何をしたのか」に答える必要が出ても、 記録はそこにあります。
取り消しは即時に効く。 設定でトークンを削除すれば、アシスタントの次の要求から止まります。 私たちが保存しているのはキーの SHA-256 ハッシュだけなので、あなたのために復元することは できません。失くしたら、新しいものを発行してください。
トークンをさらに絞る
知っておく価値のある任意の設定が二つあります。トークンには有効期限を持たせられます。 短命な試みが自分で片づくようにする、いちばん簡単な方法です。そしてIP の許可リストも 持たせられるので、あるサーバー用のトークンを他の場所から使うことはできなくなります。どちらも 同じ作成画面にあります。
最初のトークンとして妥当なもの
書き込みの範囲を付けずに一本発行して、アシスタントに読み取りだけの一週間を渡してください。 SLA のリスクを見つけ、騒がしいやり取りを要約し、あなた自身が送る返信の下書きを作らせる。 それでほとんどの価値を得ながら、露出はありません。どの書き込み範囲が本当に欲しいのかわかったら、 それだけを持つ二本目を発行します。既存のトークンを広げることは、意図してできないようにして あります。
上に書いたことはすべて、今日提供されている挙動を説明したものです。コネクタはどの Helpdash 業務スペースでも利用できます。