Forbiz

forbiz-mcp

Forbiz向けのMCP サーバーです。AI エージェントのためのCRMです。 AIが変わっても、ビジネスは続きます。

エージェントが、何を約束したか、どのような反応を期待しているか、どのような証拠を確認したか、そして最終的にどうなったかを記録できる場所を用意します。これにより、次のセッションや別のエージェントが、前のセッションの続きから対応できます。

• アカウントを作成せずに始められます。 エージェントはforbiz_startを使って、自分で仮ワークスペースを開きます。所有者は後からリンクを使って引き継ぎます。
• 再開できるコミットメントです。 各コミットメントにはcommitmentKeyが付いています。同じものを2回開こうとすると拒否され、未完了のコミットメントが返されます。これにより、新しいセッションで続きを行えます。
• 証拠は真実ではありません。 エージェントが書き込んだ内容は、追記専用の履歴として残ります。矛盾する内容があっても、元の記録は消去されません。また、人間が確認するまで、ワークスペースの確定情報にはなりません。
• 誰が何をしたかが記録されます。 書き込みはすべて、それを行ったエージェントに帰属します。forbiz_agentsでは各エージェントの実績を確認できます。

インストール

Node 18以降が必要です。

Claude Code

claude mcp add forbiz -- npx -y forbiz-mcp

Claude Desktop（claude_desktop_config.json）またはCursor（.cursor/mcp.json）

{
  "mcpServers": {
    "forbiz": {
      "command": "npx",
      "args": ["-y", "forbiz-mcp"]
    }
  }
}

これだけで準備完了です。エージェントが初回にforbiz_startを呼び出すと、認証情報が~/.forbiz-mcp/credential.jsonに保存されます。

Forbizの認証情報をすでにお持ちですか？ 代わりに、サーバーの環境変数に追加してください。

"env": { "FORBIZ_API_KEY": "<your credential>" }

fbzr_で始まる認証情報は、自動的に短期間有効なトークンに交換されます。

ツール

ツール	機能
forbiz_start	アカウントなしで仮ワークスペースを開きます。認証情報をローカルに保存し、表示することはありません
forbiz_me	ワークスペース、ID、機能、プラン、制限を確認します。最初に呼び出してください
forbiz_next	次に対応が必要なことを1つだけ表示します
forbiz_prompts	保留中の項目をグループ化し、現在実行可能なコマンドとともにすべて表示します
forbiz_state	ワークスペースの概要を表示します
forbiz_commit	期待する反応と日付を含めて、コミットメントを記録します
forbiz_mark_executed	アクションが実際に行われたことを記録します
forbiz_check_signal	反応をどこでいつ確認したかを記録します
forbiz_record_signal	実際に返ってきた反応を記録します
forbiz_postpone	反応の予定日を変更します
forbiz_close / forbiz_close_without_signal	一連の対応を終了します
forbiz_get_action / forbiz_action_history	1つのアクションと、それを変更した人を確認します
forbiz_add_evidence / forbiz_find_evidence	証拠を追記し、取得します
forbiz_search	アクション、証拠、人物、プロジェクトを横断して検索します
forbiz_agents	ワークスペースのエージェントと実績を表示します
forbiz_claim_link	所有者が引き継ぐために開くリンクを取得します
forbiz_request	Agent APIのその他のルートを呼び出します

最初のサイクル

1. forbiz_start → ワークスペースとトライアルの制限を確認します。
2. forbiz_add_evidence → 観察した内容を記録します（kind: statement、epistemicStatus: observed）。
3. forbiz_commit → commitmentKey、expectedSignal、expectedSignalAtとともに、実行する内容を記録します。
4. 実行後にforbiz_mark_executedを呼び出し、その後forbiz_record_signalまたはforbiz_check_signalを呼び出します。
5. forbiz_claim_link → リンクを所有者に渡します。

プラン

トライアル：無料、エージェント1つ、アクション30件、証拠レコード100件です。上限に達した後も、ワークスペースは引き続き読み取りとエクスポートが可能で、データは削除されません。Continuity：月額29米ドル。現在のカタログはforbiz_meで返される内容が正式なものです。

仕組み

Forbiz Agent APIの公開仕様をMCPツールに変換する薄いレイヤーです。独自のルールは追加しません。重複、機能、制限はForbizが適用し、拒否された場合は、その拒否が次に何をすべきかを示すため、Forbizが記述した内容のままエージェントに返されます。ツールの結果からは、モデルに渡す前に認証情報が除去されます。

設定：FORBIZ_API_KEY（任意の認証情報）、FORBIZ_API_BASE（デフォルトはhttps://forbiz.io/api/public/agent）、FORBIZ_MCP_HOME（デフォルトは~/.forbiz-mcp）。

リンク

• Forbiz：https://forbiz.io
• Agent API：https://forbiz.io/openapi.json · https://forbiz.io/llms.txt
• 引き継ぎテスト（初めて使うエージェントがコミットメントを引き継げるか）：https://github.com/tbernabo/handoff-test

MIT License.