#Connect Slack

This guide covers what to put into the connector form for Slack.

The connector reads past conversations so Heplon can recall them in answers.

#1. Create the Slack app

Go to api.slack.com/apps, select Create New App, then From a manifest, choose your workspace, and paste this:

{
  "display_information": {
    "name": "Heplon"
  },
  "features": {
    "bot_user": {
      "display_name": "Heplon",
      "always_online": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": ["channels:read", "channels:history", "groups:read", "groups:history"]
    }
  },
  "settings": {
    "org_deploy_enabled": false,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}

Select Create, then Install to Workspace and approve the permissions.

#2. Copy the bot token

On OAuth & Permissions, copy the Bot User OAuth Token — it starts with xoxb-.

#3. Invite the bot to the channels you want indexed

In each channel: /invite @Heplon.

Heplon can list a channel it has not joined, but it cannot read it. A selected channel the bot is not in makes the form fail with not_in_channel.

#4. Fill in the form

In Heplon, open Connectors, select Add connector, then Slack.

Select at least one channel.

Slack is now connected to Heplon.

#Notes

• Every channel you select to index is readable by everyone with access to this connector in Heplon. For instance, if Joe has access to this connector in Heplon, then Joe can use the MCP server in Claude Code
• Deselecting a channel drops what Heplon indexed from it on the next run.