Follow Up Boss Mcp Server

不動産業者のために作られた Follow Up Boss MCP サーバー

Claude AI（またはMCP互換ツール）から、自然な英語でFollow Up Boss CRMに話しかけられます。公式APIを100％カバーする160個のツールに加え、about／helpメタツールも利用できます。開発会社ではなく、現役の不動産ブローカーが作りました。

Ed Neuhaus が開発 — テキサス州オースティンの Neuhaus Realty Group のブローカー兼オーナーです。 2009年から不動産ブローカーとして認可を受け、業界歴は19年以上です。自分のFUBアカウントに自然な英語で話しかけたかったため、これを作りました。Elastic License 2.0のもと、セルフホストでの利用は無料です。

現在取り組んでいるその他のプロジェクト

• EdNeuhaus.com — 開発者プロフィールと、このプロジェクトの構築方法について詳しく紹介しています：edneuhaus.com/projects/fub-mcp/
• NeuhausRE.com — AIを活用した住宅検索を備えた、私の不動産会社のサイト
• StaySTRA.com — 短期賃貸投資の分析ツール
• Austin MLS MCP — ホスト型MLS MCPサーバー（Claude、ChatGPT、PerplexityなどでリアルタイムのMLSデータを利用できます）
• Kendall Creek Properties — 姉妹不動産会社

謝礼をお考えですか？

1. 不動産の紹介案件はありますか？ テキサス州への転居、またはテキサス州からの転居を検討しているお客様について、どの州のライセンスを持つエージェントからの紹介もお受けしています。neuhausre.com/contact からご連絡ください。
2. 紹介記事を書く。 ブログ記事、LinkedIn、X などで、私にタグ付けし、neuhausre.com へのリンクを掲載してください。
3. バグを見つけた場合や、便利なものを作った場合は、issue または PR を作成してください。

警告：このツールは、Follow Up Boss アカウントへの読み取りおよび書き込みの全権限を持っています。 CRM 内の連絡先、取引、タスク、メモなどのデータを作成、更新、削除できます。強く推奨：よく分かっている場合を除き、このツールを使い始める前に FUB データをバックアップしてください。 本番データへの変更を確定する前に、AI が提案したアクションを必ず確認してください。FUB アカウントで発生したデータ損失や意図しない変更について、作者は責任を負いません。

⚠️ FUB_SYSTEM / FUB_SYSTEM_KEY を設定する前にお読みください — 利用規約違反のリスク

FUB API の複数のエンドポイントには 「制限付き — 登録済みシステム専用」 と記載されており、X-System + X-System-Key ヘッダーが必要です（この MCP では、これらを FUB_SYSTEM + FUB_SYSTEM_KEY 環境変数として公開しています）。対象となるエンドポイントには、ウェブフック、受信トレイアプリ、自動化（2.0）、テキストメッセージの記録、人物／取引への添付ファイルが含まれます。

これらの認証情報は、FUB の承認を受けたサードパーティ統合パートナーに FUB が発行するものであり、FUB のエンドユーザーには発行されません。 これらの環境変数を設定するのは、FUB に実際のサードパーティアプリを登録し、専用の X-System 名とキーを受け取った開発者を想定しています。

次のことは絶対にしないでください：

• オンラインで見つけた他のアプリや統合機能の X-System 認証情報を再利用する。
• FUB が受け入れることを期待して、システム名をでっち上げる。
• パートナーの認証情報を借りる。

上記のいずれかを行って制限付きエンドポイントにアクセスすると、Follow Up Boss の利用規約に違反するおそれがあり、事前通知なしに FUB アカウントが一時停止または禁止される可能性があります。 FUB のレート制限と識別ポリシーについては、https://docs.followupboss.com/reference#identification に記載されています。

正規に登録されたシステム用の認証情報をお持ちでない場合は、これらの環境変数を設定しないでください。制限付きツールを使うたびに、「X-System + X-System-Key が必要です…」という明確で対応方法の分かるエラーが表示されるため、ゲートを黙って回避することはありません。制限のない 130 以上のツールは、通常の FUB API キーで問題なく動作します。

ご自身の責任でご利用ください。制限付きエンドポイントの使用に起因する利用規約違反、アカウントの一時停止や禁止、データ損失について、本プロジェクトの作者は責任を負いません。

ライセンスに関する注意： このプロジェクトは v1.1.2 で MIT から Elastic License 2.0 に移行しました。ご自身のビジネス向けであれば、無料で利用、変更、セルフホストできます。ただし、第三者にホスト型／マネージドサービスとして提供することはできません。商用ホスティングの権利については、neuhausre.com/contact からお問い合わせください。v1.1.1 以前のバージョンは引き続き MIT ライセンスです。

これは何をするものですか

このサーバーは、Follow Up Boss アカウントと Claude などの AI ツールをつなぐブリッジとして機能します。接続すると、自然な英語で Claude に話しかけるだけで、FUB のデータを直接読み取り、新規作成、更新、管理できます。

できること：

• 連絡先と人物 -- 連絡先の検索、新しい見込み客の作成、ステージの更新、タグの管理、重複の確認、関係性の表示
• 取引とパイプライン -- 取引の作成と管理、パイプラインのステージ間の移動、金額とクロージング日の追跡
• タスクと予定 -- フォローアップタスクの作成、予定のスケジュール、リマインダーの設定、結果の追跡
• コミュニケーション -- 通話ログとテキストメッセージの履歴の表示。注：API の「テキストメッセージ作成」エンドポイントはログ記録専用です（FUB は API 経由で SMS を配信しません）。また、これは登録済みシステム専用のエンドポイントです。上記の警告を参照してください。
• メールテンプレート -- 連絡先データを使ったメールテンプレートの作成、編集、差し込み
• スマートリストとアクションプラン -- スマートリストの表示、人物へのアクションプランと自動化の割り当て
• カスタムフィールド -- 連絡先と取引用のカスタムフィールドの作成と管理
• チーム、グループ、ポンド -- チーム構成、ラウンドロビングループ、見込み客ポンドの管理
• ウェブフック -- ウェブフック連携の設定と管理
• その他 -- 受信トレイアプリ、リアクション、スレッド形式の返信、メールマーケティングキャンペーン、期間

必要なもの

1. API アクセス権のある Follow Up Boss アカウント（多くの有料プランに含まれています）
2. Claude Desktop、Claude Code、または MCP 対応の AI ツール
3. Node.js 18 以降 -- JavaScript を実行する無料ツールです。お持ちでない場合は、nodejs.org からダウンロードしてください（LTS バージョンを選択してください）。

セットアップ（5 分）

ステップ 1：FUB API キーを取得する

API キーは、このサーバーが FUB アカウントにアクセスするためのパスワードのようなものです。

1. Follow Up Boss にログインします
2. 上部メニューから Admin > API を開きます
3. API キーをコピーします（英数字が並んだ長い文字列です）

ステップ 2：ダウンロードしてインストールする

git を使える場合：

git clone https://github.com/mindwear-capitian/followupboss-mcp-server.git
cd followupboss-mcp-server
npm install

git を使えない場合：

1. このページ上部にある緑色の "Code" ボタンをクリックします
2. "Download ZIP" を選択します
3. ダウンロードしたファイルを解凍します
4. ターミナル（Mac）またはコマンドプロンプト（Windows）を開きます
5. 解凍したフォルダーに移動します：

   cd path/to/followupboss-mcp-server
   

6. 依存関係をインストールします：

   npm install
   

ステップ 3：セットアップを実行する

npm run setup

以下の処理が行われます：

• API キーの入力を求められます
• 接続が正常に動作するかテストされます
• セーフモードとフルアクセスのどちらを使うか選択します
• 設定がローカルの .env ファイルに保存されます
• Claude への接続方法が具体的に表示されます

セーフモードとフルアクセスの違い

	セーフモード（デフォルト）	フルアクセス
データの読み取り（連絡先、取引など）	はい	はい
新しいレコードの作成	はい	はい
既存レコードの更新	はい	はい
レコードの削除	いいえ	はい
利用可能なツール	136	160

セーフモードがデフォルトであり、ほとんどのユーザーにおすすめです。受信トレイアプリの無効化を含む、HTTP DELETE リクエストを送信する 24 個のツールが無効になります。作成、更新、一括更新のツールは引き続き利用でき、重要な変更を行う場合があります。.env ファイルまたは AI ツールの設定で FUB_SAFE_MODE を変更すれば、いつでもモードを切り替えられます。

動作確認（任意）

Claude に接続する前に、すべてが正しく動作するか確認できます：

npm test

次のように表示されます：

  PASS  Server starts and MCP handshake succeeds
  PASS  Lists 136 tools
  PASS  Read-only API call works (account: ok)

3 passed, 0 failed

3 項目すべてに合格すれば準備完了です。失敗した場合は、.env ファイルの API キーをもう一度確認してください。

ステップ 4：AI ツールに接続する

以下から使用するツールを選んでください。どのツールも設定ファイルを少し編集する必要があります。セットアップウィザード（npm run setup）には、お使いのコンピューターに合わせた正確なファイルパスと JSON が表示されますが、各ツールの手動設定方法も以下に記載しています。

設定ファイルとは？ AI ツールにこのサーバーの場所を伝える設定ファイルです。短いテキストをコピーして貼り付けるだけです。

---

Claude Desktop

1. Finder（Mac）またはエクスプローラー（Windows）を開きます
2. 次のファイルに移動します：
   • Mac： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
3. ファイルが存在しない場合は、作成します
4. 次の内容を貼り付けます（2つのプレースホルダーを自分の値に置き換えてください）：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. /full/path/to/ を、このプロジェクトをダウンロードした場所に置き換えます
6. your_api_key_here を自分の FUB API キーに置き換えます
7. Claude Desktop を再起動します（完全に終了してから、再度開きます）

---

Claude Code (CLI)

ターミナルで次のコマンドを実行します（パスを置き換えてください）：

claude mcp add followupboss -- node /full/path/to/followupboss-mcp-server/index.js

次に、Claude Code を再起動します。

---

Cursor

1. Cursor を開きます
2. Settings > Developer > "Edit Config" をクリックします（~/.cursor/mcp.json が開きます）
3. 次の内容を貼り付けます：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. パスと API キーを自分の値に置き換えます
5. Cursor を再起動します

---

Windsurf

1. Windsurf を開きます
2. Settings > Cascade > MCP Servers に移動します
3. または、次のファイルを手動で編集します：
   • Mac： ~/.codeium/windsurf/mcp_config.json
   • Windows： %USERPROFILE%\.codeium\windsurf\mcp_config.json
4. 次の内容を貼り付けます：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. パスと API キーを自分の値に置き換えます
6. Windsurf を完全に終了して再起動します

---

GitHub Copilot を使用する VS Code

VS Code 1.99 以降と GitHub Copilot 拡張機能が必要です。

1. VS Code を開きます
2. Cmd+Shift+P（Mac）または Ctrl+Shift+P（Windows）を押します
3. "MCP: Open User Configuration" と入力して選択します
4. 次の内容を貼り付けます：

{
  "servers": {
    "followupboss": {
      "type": "stdio",
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. パスと API キーを自分の値に置き換えます
6. Copilot の Agent mode でツールを使用します

Note： VS Code では "servers" を使用し、"type": "stdio" が必要です。他のツールとは少し異なります。

---

Cline（VS Code 拡張機能）

1. Cline をインストールした VS Code を開きます
2. Cline のサイドバーにある MCP Servers アイコンをクリックします
3. "Configure MCP Servers" をクリックします
4. 次の内容を貼り付けます：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. パスと API キーを自分の値に置き換えます

---

Gemini CLI（Google）

これは Google の Gemini CLI ツールで動作します。Gemini のウェブサイトでは動作しません。

1. 次のファイルを編集（または作成）します：
   • Mac： ~/.gemini/settings.json
   • Windows： %USERPROFILE%\.gemini\settings.json
2. 次の内容を貼り付けます：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. パスと API キーを自分の値に置き換えます

---

Continue.dev（VS Code 拡張機能）

1. プロジェクト内に .continue/mcpServers/ フォルダーがない場合は作成します
2. その中に followupboss.json というファイルを作成します
3. 次の内容を貼り付けます：

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. パスと API キーを自分の値に置き換えます
5. Continue の Agent mode でツールを使用します

---

ChatGPT、OpenAI API、Grok

これらのツールは、ローカルの MCP サーバーではなく、リモートの MCP サーバー（インターネット上でホストされているもの）のみをサポートします。そのため、設定はより高度になり、HTTPS 対応のクラウドサービスでこのサーバーをホストする必要があります。

十分な関心が寄せられた場合は、将来的にホスト版を追加する可能性があります。現時点では、ローカルの MCP サーバーに対応している上記のツールのいずれかを使用することをおすすめします。

使用例

接続したら、普段どおり AI ツールに話しかけるだけです。次のようなことを尋ねられます：

「今週のリードをすべて表示して」

「明日の午後2時に John Smith にフォローアップするタスクを作成して」

「パイプラインに50万ドルを超える取引はありますか？」

「Jane Doe のプロフィールにメモを追加して：電話で話せてよかった。Oak Park の物件に興味がある」

「今週の今後の予定をすべて一覧表示して」

「まだ連絡していないリードは誰ですか？」

「Smith の取引を『契約締結中』のステージに移動して」

「『有望なリード』のタグが付いた連絡先をすべて表示して」

「『オープンハウス後のフォローアップ』という新しいメールテンプレートを作成して」

「どのアクションプランを設定していますか？」

利用可能な160個すべてのツール

クリックしてツールの一覧をすべて表示

イベント（3個のツール）

ツール	説明
listEvents	人物、種類、物件で絞り込んでイベントを一覧表示
createEvent	新しいイベントを作成（リードイベント、物件への問い合わせなど）
getEvent	ID を指定して単一のイベントを取得

人物／連絡先（8 個のツール）

ツール	説明
listPeople	連絡先を幅広く検索、絞り込みます
createPerson	新しい連絡先を作成します
getPerson	ID で連絡先を取得します
updatePerson	連絡先の詳細、ステージ、タグなどを更新します
deletePerson	連絡先を削除（ゴミ箱に移動）します
checkDuplicate	メールアドレスまたは電話番号で連絡先が存在するか確認します
listUnclaimed	ポンド内の未割り当てリードを一覧表示します
claimPerson	未割り当てリードを割り当てます

人物の添付ファイル（4 個のツール）

ツール	説明
createPersonAttachment	ファイルを連絡先に添付します
getPersonAttachment	ID で添付ファイルを取得します
updatePersonAttachment	添付ファイルを更新します
deletePersonAttachment	添付ファイルを削除します

関係（5 個のツール）

ツール	説明
listRelationships	連絡先の関係を一覧表示します
createRelationship	2 件の連絡先間に関係を作成します
getRelationship	ID で関係を取得します
updateRelationship	関係を更新します
deleteRelationship	関係を削除します

ID 情報（2 個のツール）

ツール	説明
getIdentity	API キーのアカウント情報を取得します
getCurrentUser	現在認証されているユーザーを取得します

メモ（5 個のツール）

ツール	説明
listNotes	メモを一覧表示します。personId で絞り込むこともできます
createNote	連絡先にメモを作成します
getNote	ID でメモを取得します
updateNote	メモを更新します
deleteNote	メモを削除します

通話（4 個のツール）

ツール	説明
listCalls	通話記録を一覧表示します
createCall	通話を記録します
getCall	ID で通話を取得します
updateCall	通話記録を更新します

テキストメッセージ（3 個のツール）

ツール	説明
listTextMessages	テキストメッセージを一覧表示します
createTextMessage	テキストメッセージを送信します
getTextMessage	ID でテキストメッセージを取得します

ユーザー（3 個のツール）

ツール	説明
listUsers	すべてのユーザー／エージェントを一覧表示します
getUser	ID でユーザーを取得します
deleteUser	ユーザーを削除します

スマートリスト（2 個のツール）

ツール	説明
listSmartLists	すべてのスマートリストを一覧表示します
getSmartList	ID でスマートリストを取得します

アクションプラン（4 個のツール）

ツール	説明
listActionPlans	すべてのアクションプランを一覧表示します
listActionPlansPeople	アクションプラン内の人物を一覧表示します
addPersonToActionPlan	連絡先をアクションプランに追加します
updateActionPlanPerson	連絡先のアクションプランのステータスを更新します

自動化（6 個のツール）

ツール	説明
listAutomations	すべての自動化を一覧表示します
getAutomation	ID で自動化を取得します
listAutomationsPeople	自動化内の人物を一覧表示します
getAutomationPerson	自動化と人物のエントリを取得します
addPersonToAutomation	連絡先を自動化に追加します
updateAutomationPerson	連絡先の自動化ステータスを更新します

メールテンプレート（6 個のツール）

ツール	説明
listTemplates	メールテンプレートを一覧表示します
createTemplate	メールテンプレートを作成します
getTemplate	ID でテンプレートを取得します
updateTemplate	テンプレートを更新します
mergeTemplate	テンプレートに連絡先データを差し込みます（メールマージ）
deleteTemplate	テンプレートを削除します

テキストメッセージテンプレート（6 個のツール）

ツール	説明
listTextMessageTemplates	テキストメッセージテンプレートを一覧表示します
createTextMessageTemplate	テキストメッセージテンプレートを作成します
getTextMessageTemplate	ID でテンプレートを取得します
updateTextMessageTemplate	テンプレートを更新します
mergeTextMessageTemplate	テンプレートに連絡先データを差し込みます
deleteTextMessageTemplate	テンプレートを削除します

メールマーケティング（5 ツール）

ツール	説明
listEmEvents	メールマーケティングのイベントを一覧表示します
createEmEvent	メールマーケティングのイベントを作成します
listEmCampaigns	メールマーケティングのキャンペーンを一覧表示します
createEmCampaign	キャンペーンを作成します
updateEmCampaign	キャンペーンを更新します

カスタムフィールド（5 ツール）

ツール	説明
listCustomFields	すべてのカスタムフィールドを一覧表示します
createCustomField	カスタムフィールドを作成します
getCustomField	ID でカスタムフィールドを取得します
updateCustomField	カスタムフィールドを更新します
deleteCustomField	カスタムフィールドを削除します

ステージ（5 ツール）

ツール	説明
listStages	すべてのパイプラインステージを一覧表示します
createStage	ステージを作成します
getStage	ID でステージを取得します
updateStage	ステージを更新します
deleteStage	ステージを削除します

タスク（5 ツール）

ツール	説明
listTasks	タスクを一覧表示します
createTask	タスクを作成します
getTask	ID でタスクを取得します
updateTask	タスクを更新します
deleteTask	タスクを削除します

予約（5 ツール）

ツール	説明
listAppointments	予約を一覧表示します
createAppointment	予約を作成します
getAppointment	ID で予約を取得します
updateAppointment	予約を更新します
deleteAppointment	予約を削除します

予約タイプ（5 ツール）

ツール	説明
listAppointmentTypes	予約タイプを一覧表示します
createAppointmentType	タイプを作成します
getAppointmentType	ID でタイプを取得します
updateAppointmentType	タイプを更新します
deleteAppointmentType	タイプを削除します

予約結果（5 ツール）

ツール	説明
listAppointmentOutcomes	結果を一覧表示します
createAppointmentOutcome	結果を作成します
getAppointmentOutcome	ID で結果を取得します
updateAppointmentOutcome	結果を更新します
deleteAppointmentOutcome	結果を削除します

Webhook（6 ツール）

ツール	説明
listWebhooks	すべての Webhook を一覧表示します
createWebhook	Webhook を作成します
getWebhook	ID で Webhook を取得します
updateWebhook	Webhook を更新します
deleteWebhook	Webhook を削除します
getWebhookEvents	Webhook のイベントを取得します

パイプライン（5 ツール）

ツール	説明
listPipelines	すべてのパイプラインを一覧表示します
createPipeline	パイプラインを作成します
getPipeline	ID でパイプラインを取得します
updatePipeline	パイプラインを更新します
deletePipeline	パイプラインを削除します

取引（5 ツール）

ツール	説明
listDeals	フィルタリングして取引を一覧表示します
createDeal	取引を作成します
getDeal	ID で取引を取得します
updateDeal	取引を更新します
deleteDeal	取引を削除します

取引の添付ファイル（4 ツール）

ツール	説明
createDealAttachment	ファイルを取引に添付します
getDealAttachment	ID で添付ファイルを取得します
updateDealAttachment	添付ファイルを更新します
deleteDealAttachment	添付ファイルを削除します

取引のカスタムフィールド（5 ツール）

ツール	説明
listDealCustomFields	取引のカスタムフィールドを一覧表示します
createDealCustomField	取引のカスタムフィールドを作成します
getDealCustomField	ID でフィールドを取得します
updateDealCustomField	フィールドを更新します
deleteDealCustomField	フィールドを削除します

グループ（6 ツール）

ツール	説明
listGroups	すべてのグループを一覧表示します
listRoundRobinGroups	ラウンドロビングループを一覧表示します
createGroup	グループを作成します
getGroup	ID でグループを取得します
updateGroup	グループを更新します
deleteGroup	グループを削除します

Teams（5 ツール）

Tool	Description
listTeams	すべてのチームを一覧表示
createTeam	チームを作成
getTeam	ID でチームを取得
updateTeam	チームを更新
deleteTeam	チームを削除

Team Inboxes（1 ツール）

Tool	Description
listTeamInboxes	すべてのチーム受信トレイを一覧表示

Ponds（5 ツール）

Tool	Description
listPonds	すべてのポンドを一覧表示
createPond	ポンドを作成
getPond	ID でポンドを取得
updatePond	ポンドを更新
deletePond	ポンドを削除

Timeframes（1 ツール）

Tool	Description
listTimeframes	すべての期間を一覧表示

Inbox Apps（10 ツール）

Tool	Description
inboxAppAddMessage	会話にメッセージを追加
inboxAppUpdateMessage	メッセージを更新
inboxAppAddNote	会話にメモを追加
inboxAppUpdateConversation	会話のステータスを更新
inboxAppGetParticipants	会話の参加者を取得
inboxAppCreateParticipant	参加者を追加
inboxAppDeleteParticipant	参加者を削除
inboxAppInstall	受信トレイアプリをインストール
inboxAppDeactivate	受信トレイアプリを無効化
listInboxAppInstallations	インストール一覧を表示

Reactions（3 ツール）

Tool	Description
getReactions	アイテムへのリアクションを取得
createReaction	リアクションを追加
deleteReaction	リアクションを削除

Threaded Replies（1 ツール）

Tool	Description
getThreadedReplies	アイテムへのスレッド形式の返信を取得

便利なツール

Tool	Description
removeTagFromPerson	他のタグに影響を与えずに単一のタグを削除します（読み取り・変更・書き込みを内部で処理）
getPersonByEmail	メールアドレスで人物を検索します。一致する連絡先が複数ある場合、黙って選択せず、候補の ID とともに曖昧であることを通知します
searchPeopleByTag	特定のタグが付いた人物をすべて検索します（カンマ区切り、OR ロジック）
bulkUpdatePeople	レート制限を自動的に適用して、複数の人物を一度に更新します
listAvailableTags	連絡先をスキャンして、アカウント内のすべてのタグを確認します

メタツール（2 ツール、v1.1.2 で追加）

Tool	Description
about	作者のプロフィール、関連プロジェクト、貢献者、「感謝を伝える方法」
help	使い方のヒント、ツールの一般的な使用例、バグ報告リンク

レート制限

FUB のレート制限に達した場合（HTTP 429）、サーバーはリクエストを自動的に再試行します。Retry-After ヘッダーを読み取り、待機時間を段階的に延長しながら、リクエストごとに最大 3 回再試行します。FUB の制限は次のとおりです。

• 全体： 10 秒あたり 250 リクエスト
• 人物の更新： 10 秒あたり 25 リクエスト
• メモ： 10 秒あたり 10 リクエスト

bulkUpdatePeople ツールは、PUT の制限を超えないよう、20 件の操作ごとに組み込みの一時停止も行います。

トラブルシューティング

「接続できません」または「接続が拒否されました」

• Node.js がインストールされていることを確認します。ターミナルで node --version を実行してください（v18 以降が表示されるはずです）
• プロジェクトフォルダーで npm install を実行したことを確認します
• Claude の設定に記載されているファイルパスを再確認します

「API キーが無効です」または「401 Unauthorized」

• FUB の API キーを再確認します：Admin > API
• コピー＆ペースト時に余分なスペースが入っていないことを確認します
• npm run setup を再度実行して、キーをテストします

Claude で「ツールが見つかりません」

• サーバー設定を追加した後、Claude Desktop を再起動します
• 設定ファイル内の JSON が有効であること（カンマや括弧の不足がないこと）を確認します

Claude が FUB について認識していないようです

• 設定内のサーバー名が完全に一致していることを確認します
• Claude Desktop の開発者コンソールでエラーメッセージを確認します
• Claude に「利用できる MCP ツールを教えてください」と尋ねてみます

FAQ

データは安全ですか？

はい。このサーバーはすべてお使いのコンピューター上で実行されます。API キーはお使いのマシン上のローカルファイルに保存され、Follow Up Boss の公式 API に直接送信される場合を除き、どこにも送信されません。サードパーティのサーバーを経由するデータはありません。

費用はかかりますか？

このサーバーは無料のオープンソースです。API アクセスが可能な Follow Up Boss アカウント（ほとんどの有料プランに含まれます）があれば利用できます。

Claude は FUB のデータを変更できますか？

はい。Claude は FUB アカウントのレコードを作成、更新、削除できます。Claude は通常、変更を加える前に確認します。特に削除の場合は確認します。読み取り専用アクセスにしたい場合は、FUB で制限付き API キーを作成できます。

通話録音の URL はどこにありますか？

どこにもありません。また、このサーバーが隠しているわけでもありません。Follow Up Boss はすべてのインテグレーションに対して、API レベルで recordingUrl をマスキングしています。使用するヘッダーや権限にかかわらず、未加工の API は * Recording URL is hidden for privacy reasons * を返します。また、FUB は録音 URL が API 経由で公開されることはないと、直接確認しています。recordingUrl を書き込んでも何も起こりません（読み取り時に FUB が再びマスキングします）。そのため、通話ツールでは受け付けなくなりました。通話音声が必要な場合は、ダイヤラー側で取得してください。updateCall（note フィールド）を使って、通話に文字起こしを保存できます。詳しくはissue #2をご覧ください。

MCP とは何ですか？

MCP（Model Context Protocol）は Anthropic が作成したオープン標準で、Claude などの AI ツールが外部サービスに接続できるようにします。Claude がアプリとやり取りするための共通プラグのようなものです。MCP の詳細をご覧ください。

このプロジェクトを作ったのは誰ですか？

Neuhaus Realty Group のブローカーであり、StaySTRA のクリエイターでもある Ed Neuhaus が、どちらもテキサス州オースティンで開発しました。私たちは毎日 Follow Up Boss を使っており、自分たちのワークフローを効率化するためにこれを作りました。

コントリビューション

コントリビューションを歓迎します。手順は以下のとおりです。

1. このリポジトリをフォークします
2. フィーチャーブランチを作成します：git checkout -b my-feature
3. 変更を加えます
4. テストします：node -c index.js（構文チェック）
5. コミットします：git commit -m "Add my feature"
6. プッシュします：git push origin my-feature
7. プルリクエストを作成します

コードスタイルを統一し、160 個すべてのツールが引き続き動作することを確認してください。

ライセンス

Elastic License 2.0 -- セルフホストは無料、SaaS としての再販は禁止です。v1.1.1 以下のバージョンは引き続き MIT ライセンスの対象です。これらのバージョンの既存のフォークには影響しません。利用条件と帰属表示の全文については、LICENSE および NOTICE をご覧ください。

---

Ed Neuhaus が開発