bbotn ガイド
botn アプリ → KOENJA
連携・MCP連携

MCP連携(外部LLM)

ClaudeやCursorのようなLLMからbotnのデータを直接照会・管理できます。botnはMCP(Model Context Protocol)サーバーを提供します。

何ができるか

連携すると、LLMはこのワークスペースのデータを照会し、営業タスクを実行します。単なる照会を超えて、顧客・取引・タスクはもちろん、リードフォーム・自動フォローアップシーケンス・キャンペーンまで作成し、メールキャンペーン送信のような実際の操作も指示できます。例:「今日連絡すべきホットリードをまとめて」「この顧客に通話完了ノートを残して、明日のフォローアップタスクを作成して」「見積後のシーケンスを作ってこの顧客を登録して」。

使えるツール

botnは55個のツールを提供します — アプリで直接行う主要な操作をほぼそのままLLMで処理できるフルコントロールレベルです。照会ツールは安全にデータを読み、操作ツールは実際にレコードを作成・変更・削除します。

照会 (22)

操作 (33)

操作ツールは実際にデータを変更します。特に削除(連絡先・ディール・タスク・ノート)と送信(シーケンス登録・メールキャンペーン送信)は元に戻しにくい、または外部にメッセージが出ます。LLMには明示的に要求したときのみ実行させ、対象・内容を先に確認してください。すべての送信はマーケティング同意・配信停止ポリシーに自動的に従い、削除はソフト削除(復元可能)で処理されます。

1. トークンの発行

設定 → MCP連携でトークン発行を押すと、botn_pat_…トークンが一度だけ表示されます。コピーしておいてください(再度は表示されません)。トークンは発行したワークスペースにスコープされます。

2. LLMに連携

ほとんどのMCPクライアントはmcp-remoteブリッジでリモートサーバーに接続します。Claude Desktopの場合は設定のMCP構成(JSON)に以下を追加し、botn_pat_여기에_토큰を発行したトークンに置き換えてください。Node.jsがインストールされている必要があります。

{
  "mcpServers": {
    "botn": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://botn.app/mcp",
        "--header", "Authorization: Bearer botn_pat_여기에_토큰"
      ]
    }
  }
}

保存してクライアントを再起動すると、botnツールが表示されます。Cursorやその他のクライアントも同じURL(https://botn.app/mcp)とAuthorization: Bearerヘッダー方式を使います。

セキュリティ

トークンは発行者・ワークスペースの権限のみで動作し、サーバーにはハッシュのみが保存されます。使わなくなったら設定 → MCP連携で失効させてください。失効すると、そのトークンのすべてのアクセスが即座に遮断されます。

トークンはパスワードのように扱ってください。コードリポジトリやチャットに貼り付けず、疑わしい場合は失効させて再発行してください。すべての操作は、トークンが属する1つのワークスペースにのみ適用されます。