Skip to content

docs: document Slack MCP default + optional scopes#402

Open
leet-c1 wants to merge 3 commits into
mainfrom
leet/slack-mcp-scopes-docs
Open

docs: document Slack MCP default + optional scopes#402
leet-c1 wants to merge 3 commits into
mainfrom
leet/slack-mcp-scopes-docs

Conversation

@leet-c1

@leet-c1 leet-c1 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

What

Updates the Slack MCP server page to document the two scope tiers, matching the reconciled Slack connector:

  • Default scopes (14) — the read set C1 requests automatically: public/private/DM/group-DM read + history, users, user groups, files, pins, and message search.
  • Optional scopes — the write/management/admin scopes an admin adds manually (on Slack's OAuth & Permissions page and in C1's scopes field) to enable posting, channel management, and Enterprise Grid admin tools.
  • Note that scope changes take effect on the next connect (existing users must reconnect to gain a newly added scope).

Why

The default install is read-only. This page is the stopgap and long-term guide for the manual scope opt-in: it tells admins exactly which scopes to add for write/admin tools (the admin UI's scopes field is editable today; a picker that surfaces the optional tier automatically is future work).

Testing

mint broken-links clean for this file; in-page anchor (#slack-scopes) resolves; style checked against the docs-writing guide.

🤖 Generated with Claude Code

Replace the vague scopes step with a two-tier "Slack scopes" section: the 14
default read scopes C1 requests automatically (public/private/DM/group-DM read
+ history, users, usergroups, files, pins, search), and the optional
write/management/admin scopes an admin adds manually to enable those tools.
Note that scope changes apply on the next connect. Wire the register step to
the new section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jul 17, 2026, 7:06 PM

C1 acts as the authorizing user, not a bot. Make the scopes section explicit:
add all scopes under User Token Scopes and leave Bot Token Scopes empty.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…flag)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants