Help · bots

Connect a bot to the hub

Connect a bot to the hub

Every bot gets its own key on its page under Bots. The key reaches that bot's member and nothing else.

  1. Open the bot, press Create key, copy it once.
  2. Give the bot the MCP address /api/mcp with the header Authorization: Bearer ibb_…, or call the REST twins under /api/v1/… with the same header.
  3. On start, the bot calls get_structure and get_rules and keeps the copy. Pass ifVersion next time and the hub answers "unchanged" when nothing moved.
  4. As it works, it sends heartbeat, log_event, and when a thread ends a short thread_note saying which rule it applied.
  5. When its prompt changes it sends backup_prompt with the hash first; the hub only asks for the body when the hash is new.

The hub is never in the bot's hot path. If the hub is down the bot keeps its last copy and carries on.

Still stuck? Contact us.