slack-samples · zimeg · Jun 18, 2026 · Jun 16, 2026 · Jun 16, 2026 · Jun 16, 2026
@@ -4,6 +4,18 @@ updates:
     directory: "/"
     schedule:
       interval: "daily"
+  - package-ecosystem: "pip"
+    directory: "ai/slackbot-mcp-client/no-auth"
+    schedule:
+      interval: "daily"
+  - package-ecosystem: "pip"
+    directory: "ai/slackbot-mcp-client/rich-responses/mcp-apps"
+    schedule:
+      interval: "daily"
+  - package-ecosystem: "pip"
+    directory: "ai/slackbot-mcp-client/slack-identity"
+    schedule:
+      interval: "daily"
   - package-ecosystem: "pip"
     directory: "block-kit"
     schedule:

@@ -9,8 +9,12 @@ jobs:
     name: "pytest@python3.14"
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         showcase:
+          - "ai/slackbot-mcp-client/no-auth"
+          - "ai/slackbot-mcp-client/rich-responses/mcp-apps"
+          - "ai/slackbot-mcp-client/slack-identity"
           - "block-kit"
     steps:
       - name: Checkout code

@@ -2,6 +2,7 @@
 
 This collections of examples highlights features of a Slack app in the language of Bolt for Python.
 
-## Available demonstration
+## Available demonstrations
 
+- **[AI in Slack](./ai)**: Agent experiences and MCP features in an interactive conversation interface.
 - **[Block Kit](./block-kit)**: The framework of visual components arranged to create app layouts.
@@ -0,0 +1,9 @@
+# AI in Slack
+
+Agent experiences and MCP features in an interactive conversation interface.
+
+Read the [docs](https://docs.slack.dev/ai/) to learn concepts behind these constructions, or explore implementations of specific features.
+
+## What's on display
+
+- **[Slackbot MCP Client](slackbot-mcp-client/)**: Connect MCP servers to Slackbot with different options for authentication.
@@ -0,0 +1,18 @@
+# Slackbot MCP Client
+
+Connect MCP servers to Slackbot with different options for authentication.
+
+Read the [docs](https://docs.slack.dev/ai/slackbot-mcp-client) to explore more concepts around MCP.
+
+## Included examples
+
+### Authentication methods
+
+- **[Dynamic client registration](https://docs.slack.dev/ai/slackbot-mcp-client#dcr)**: Connect a remote MCP server to the Slackbot MCP client using Dynamic Client Registration (DCR). [Implementation](./dynamic-client-registration/).
+- **[External auth](https://docs.slack.dev/ai/slackbot-mcp-client#manual-oauth)**: Connect a remote MCP server to the Slackbot MCP client with manual OAuth provider configuration. [Implementation](./external-auth/).
+- **[No auth](https://docs.slack.dev/ai/slackbot-mcp-client#no-auth)**: Run an unauthenticated MCP server for the Slackbot MCP client. [Implementation](./no-auth/).
+- **[Slack identity](https://docs.slack.dev/ai/slackbot-mcp-client#slack-identity)**: Run an MCP server for the Slackbot MCP client that authenticates against existing installations. [Implementation](./slack-identity/).
+
+### Rich responses
+
+- **[MCP Apps](https://docs.slack.dev/ai/slackbot-mcp-client/returning-rich-responses#mcp-apps)**: Run an MCP server for the Slackbot MCP client that responds with an interactive UI. [Implementation](./rich-responses/mcp-apps/).
@@ -0,0 +1,2 @@
+apps.dev.json
+cache/
@@ -0,0 +1,6 @@
+{
+  "manifest": {
+    "source": "local"
+  },
+  "project_id": "00000000-0000-0000-0000-000000000000"
+}
@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "get-manifest": "cat manifest.json #"
+  }
+}
@@ -0,0 +1,11 @@
+# Dynamic Client Registration
+
+Connect a remote MCP server to the Slackbot MCP client using [Dynamic Client Registration](https://blog.modelcontextprotocol.io/posts/client_registration/) (DCR).
+
+## Setup
+
+```sh
+$ slack install --environment deployed  # Create Slack app
+```
+
+Ask Slackbot: "Find all active documents in my Notion workspace"
@@ -0,0 +1,28 @@
+{
+  "display_information": {
+    "name": "MCP Client - DCR",
+    "description": "Connects Notion MCP server to Slackbot MCP client using dynamic client registration"
+  },
+  "features": {
+    "bot_user": {
+      "display_name": "MCP Client - DCR",
+      "always_online": true
+    }
+  },
+  "oauth_config": {
+    "scopes": {
+      "bot": ["mcp:connect"]
+    }
+  },
+  "settings": {
+    "org_deploy_enabled": true,
+    "socket_mode_enabled": false,
+    "token_rotation_enabled": false
+  },
+  "mcp_servers": {
+    "Notion": {
+      "url": "https://mcp.notion.com/mcp",
+      "auth_type": "dynamic_client_registration"
+    }
+  }
+}
@@ -0,0 +1,2 @@
+apps.dev.json
+cache/
@@ -0,0 +1,6 @@
+{
+  "manifest": {
+    "source": "local"
+  },
+  "project_id": "00000000-0000-0000-0000-000000000000"
+}
@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "get-manifest": "cat manifest.json #"
+  }
+}
@@ -0,0 +1,16 @@
+# External Auth
+
+Connect a remote MCP server to the Slackbot MCP client with manual OAuth provider configuration.
+
+## Setup
+
+> Callback URL: https://oauth2.slack.com/external/auth/callback
+
+```sh
+$ open https://github.com/settings/developers # Create GitHub app
+$ slack manifest                              # Replace values
+$ slack install --environment deployed        # Create Slack app
+$ slack external-auth add-secret
+```
+
+Ask Slackbot: "Show me my recent GitHub pull requests"
@@ -0,0 +1,51 @@
+{
+  "display_information": {
+    "name": "MCP Client - External Auth",
+    "description": "Connects GitHub MCP server to Slackbot MCP client using an external auth provider"
+  },
+  "features": {
+    "bot_user": {
+      "display_name": "MCP Client - External Auth",
+      "always_online": true
+    }
+  },
+  "oauth_config": {
+    "scopes": {
+      "bot": ["mcp:connect"]
+    }
+  },
+  "settings": {
+    "org_deploy_enabled": true,
+    "socket_mode_enabled": false,
+    "token_rotation_enabled": false
+  },
+  "external_auth_providers": {
+    "oauth2": {
+      "github": {
+        "provider_type": "CUSTOM",
+        "options": {
+          "client_id": "YOUR_GITHUB_CLIENT_ID",
+          "scope": ["repo"],
+          "provider_name": "GitHub",
+          "authorization_url": "https://github.com/login/oauth/authorize",
+          "token_url": "https://github.com/login/oauth/access_token",
+          "identity_config": {
+            "url": "https://api.github.com/user",
+            "account_identifier": "$.login"
+          },
+          "use_pkce": false,
+          "token_url_config": {
+            "use_basic_auth_scheme": false
+          }
+        }
+      }
+    }
+  },
+  "mcp_servers": {
+    "GitHub": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "auth_type": "manual_auth",
+      "auth_provider_key": "github"
+    }
+  }
+}
@@ -0,0 +1,3 @@
+SLACK_BOT_TOKEN=
+SLACK_SIGNING_SECRET=
+PORT=3000
@@ -0,0 +1,4 @@
+__pycache__
+.venv
+.env*
+!.env.example
@@ -0,0 +1,2 @@
+apps.dev.json
+cache/
@@ -0,0 +1,6 @@
+{
+  "manifest": {
+    "source": "local"
+  },
+  "project_id": "00000000-0000-0000-0000-000000000000"
+}
@@ -0,0 +1,5 @@
+{
+  "hooks": {
+    "get-hooks": "python3 -m slack_cli_hooks.hooks.get_hooks"
+  }
+}
@@ -0,0 +1,16 @@
+# No Auth
+
+Run an unauthenticated MCP server for the Slackbot MCP client.
+
+## Setup
+
+```sh
+$ ngrok http 3000 --host-header=rewrite  # Update manifest with new URL
+$ slack manifest                     # Review saved values
+$ slack install --environment local  # Create a new app
+$ slack app settings                 # Gather signing secret
+$ slack env set SLACK_SIGNING_SECRET
+$ slack run
+```
+
+Ask Slackbot: "Roll 2d20"
@@ -0,0 +1,9 @@
+import os
+
+import uvicorn
+
+from src.app import app
+
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", "3000"))
+    uvicorn.run(app, host="0.0.0.0", port=port)
@@ -0,0 +1,28 @@
+{
+  "display_information": {
+    "name": "MCP Client - No Auth",
+    "description": "Connects app MCP server to Slackbot MCP client without authentication"
+  },
+  "features": {
+    "bot_user": {
+      "display_name": "MCP Client - No Auth",
+      "always_online": true
+    }
+  },
+  "oauth_config": {
+    "scopes": {
+      "bot": ["mcp:connect"]
+    }
+  },
+  "settings": {
+    "org_deploy_enabled": true,
+    "socket_mode_enabled": false,
+    "token_rotation_enabled": false
+  },
+  "mcp_servers": {
+    "Dice Game": {
+      "url": "https://1234-56-78-90-0.ngrok-free.app/mcp",
+      "auth_type": "no_auth"
+    }
+  }
+}
@@ -0,0 +1,10 @@
+httpx2==2.4.0
+mcp==1.27.2
+mypy==2.1.0
+pytest==9.1.0
+ruff==0.15.17
+slack_bolt==1.28.0
+slack_cli_hooks==0.3.0
+slack_sdk==3.42.0
+starlette==1.3.1
+uvicorn==0.49.0