What the app serves
- Chat: messages, mentions, slash commands and buttons reach your agents, as with KAOP’s app. Needs the app’s bot token and app-level token.
- Slack MCP: agents call Slack’s own tools as one Slack user. Needs the app’s User OAuth Token.
- Both, from one app.
Create the app and connect it
1
Choose your own app and what it is for
Open Connect Slack from any Slack connect button. Choose Your own Slack app, then
Chat, Slack MCP or Both.
2
Copy the manifest
Copy or download the manifest the dialog shows. It is built for what the app is for.
3
Create the app in Slack
For the Slack MCP, first sign in to Slack as the user it should act as (see
Who the Slack MCP acts as). Open
api.slack.com/apps and choose Create New App, then
From a manifest. Pick where to create it, paste the manifest, and choose Create.
4
Install the app
Open Install App, install the app, and approve it. For the Slack MCP, a Slack admin must also
approve the app: Slack serves its MCP only to internal apps and apps published in the Slack
Marketplace.
5
Paste its values
The dialog asks only for the values the use needs:
- App ID: Basic Information.
- App-level token (chat): on Basic Information, choose Generate Token and Scopes and add
the
connections:writescope. - Bot User OAuth Token (chat): OAuth & Permissions.
- User OAuth Token (Slack MCP): OAuth & Permissions.
6
Connect
Choose Connect. KAOP checks every token with Slack before saving anything. If Slack refuses
one, the dialog shows Slack’s own reason and keeps what you typed.
Type the tokens into the dialog yourself. The co-pilot can open the dialog and choose the app, the use
and the App ID, but it never asks for or handles a token.
Set up the Slack MCP
Choose Set up the Slack MCP on the result, or Add server on the connection’s row in Integrations. The MCP setup opens on Expose tools with this connection chosen. Test and discover tools adds the server and tests it; nothing is added before that.Who the Slack MCP acts as
Replace tokens
On the channel’s page, choose Replace tokens and paste any of the three tokens. Leave the others blank to keep them. The app reconnects within about 10 seconds. A channel that shows a connection error is fixed this way. An app that serves only the Slack MCP has no channel: replace its User OAuth Token from Integrations, on its row’s menu.Disconnect
On the channel’s page, choose Disconnect. For an app that serves both, choose The whole app, Chat only or The Slack MCP only. When chat stops (The whole app or Chat only), the channel stops as if the app were uninstalled, and its routing rules are kept for 14 days. When the Slack MCP stops (The whole app or The Slack MCP only), KAOP first lists the MCP servers that use the connection. They stay set up and stop working. Connecting the same app again brings back the same connection: within those 14 days its routing rules come back, and its MCP servers work again. After disconnecting the whole app, agents the connection was attached to do not get it back: attach it to them again. Connect again, on the channel’s page or on the app’s row in Integrations, opens the dialog on your own app with its App ID and what it served filled in. In Integrations, Disconnect on the app’s row does the same, and is how you disconnect an app that serves only the Slack MCP. On an app that is already disconnected, it removes the connection for good.Move chat from KAOP’s app
Chat runs through one app at a time. For the Slack MCP alone there is nothing to move: connect your own app for Slack MCP and keep chat on KAOP’s app. To move chat from KAOP’s app to your own:- In Integrations, disconnect KAOP’s Slack app. Its channel keeps its routing rules, and agents the connection was attached to lose it.
- Within 14 days, connect your own app for Chat or Both, installed in the same Slack. The channel comes back with its rules, now on your app.
- Invite your app to every Slack channel it should read or post in. It is a new Slack user, so it is in none of them yet, and Channel and Keyword rules match nothing in a channel it is not in.
- Attach your app’s connection to the agents that had KAOP’s.
Next steps
Channels
Route Slack messages to agents and workflows, and compare the two Slack apps.
Built-in integrations
Where the Slack MCP connection sits, and how a provider’s tools are exposed.