Hecher CRM

Hecher MCP サーバー

Grow Gelt による、Chabad shluchim 向けのマルチテナント CRM Hecher の公式 Model Context Protocol（MCP） サーバーです。

Claude Desktop、ChatGPT、Cursor、その他の MCP 対応 AI アシスタントを Hecher アカウントに接続すると、すべての組織（mosad）にわたって、寄付者の検索、寄付の記録、レポートの実行、タスクの管理を行えます。

ご注意： このリポジトリは、Hecher MCP サーバーの公開リスティングとドキュメントです。サーバー自体は、https://api.hecher.app/mcp でマネージド型のリモートサービスとして稼働するため、インストールやセルフホストは不要です。

---

クイックスタート

1. MCP 対応クライアント（Claude Desktop、ChatGPT、Cursor など）で、次の URL を指定して新しい リモート MCP サーバー を追加します。

   https://api.hecher.app/mcp
   

2. 初めて使用するときはブラウザーが開き、Hecher にサインインして接続を承認するよう求められます。

3. 承認すると、アシスタントがアカウントで操作できるようになります。

Hecher 内の Settings → AI Connections から、接続済みのアシスタントをいつでも確認し、接続を取り消せます。

---

できること

このサーバーは、Hecher API を利用する 20 個のツールを公開します。すべての呼び出しは、アクティブとして選択した Mosad であなたとして実行されます。RLS、課金制限、監査ログは、ウェブアプリと同じように適用されます。

組織（Mosad）

• list_tenants — アクセス可能な Mosad の一覧を表示
• set_active_tenant — 以降の呼び出しで操作する Mosad を選択
• get_active_tenant — 現在アクティブな Mosad を表示

寄付者

• search_donors — 名前、メールアドレス、電話番号、タグ、またはステータスで検索
• get_donor — 統計情報と連絡先を含む詳細プロフィールを取得
• create_donor / update_donor / delete_donor
• add_donor_tag / remove_donor_tag / bulk_tag_donors

寄付

• list_donations — 寄付者または日付で絞り込むことも可能
• create_donation / update_donation / delete_donation

アクティビティとタスク

• list_activities — 寄付者、ステータス、または担当者で絞り込むことも可能
• create_activity — タスク、電話、面談、またはメモを作成
• complete_activity

レポート

• get_dashboard_stats — アクティブな Mosad の KPI を取得
• run_report — 保存済みレポートを実行

---

認証

サーバーは動的クライアント登録に対応した OAuth 2.1 を使用しているため、準拠する MCP クライアントであれば、手動で API キーを設定せずに接続できます。

エンドポイント	URL
ディスカバリー	https://api.hecher.app/.well-known/oauth-authorization-server
認可	https://api.hecher.app/oauth/authorize
トークン	https://api.hecher.app/oauth/token
動的登録	https://api.hecher.app/oauth/register

認可ごとに、ユーザーアカウントと、同意フロー中に選択した Mosad に紐付いたアクセストークンが発行されます。トークンは Settings → AI Connections からいつでも取り消せます。

---

権限と制限

• ツールは、アクティブな Mosad でサインイン中のユーザーが持つ権限で動作します。権限の昇格はありません。
• すべての書き込み操作に、Hecher の課金制限と監査ログが適用されます。
• Hecher API ゲートウェイによるユーザーごとのレート制限が適用されます。
• 一括変更（例：bulk_tag_donors）は、ウェブ UI と同様に、Hecher のバックグラウンド処理キューを通じて実行されます。

---

対応クライアント

OAuth 2.1 を使用し、Streamable HTTP 経由のリモートサーバーに対応する MCP クライアント。以下が含まれます。

• Claude Desktop
• ChatGPT
• Cursor
• Cline
• Continue
• MCP SDKs を使用して構築されたカスタムクライアント

---

サポート

• 製品： hecher.app
• このリスティングまたは MCP サーバーに関する問題：このリポジトリで issue を作成してください
• Hecher 全般のサポート：アプリ内のフィードバックボタンからお問い合わせください

---

ライセンス

MIT © Grow Gelt Solutions