docs: streamline slack id setups

Author: zimeg

ai/mcp-client/README.md

@@ -11,4 +11,4 @@ Read the [docs](https://docs.slack.dev/ai/slack-mcp-client) to explore more conc
 - **[Dynamic client registration](./dynamic-client-registration/)**: Connect a remote MCP server with standard OAuth discovery. [Implementation](./dynamic-client-registration/).
 - **[External auth](./external-auth/)**: Connect a remote MCP server with manual OAuth provider configuration. [Implementation](./external-auth/).
 - **[No auth](./no-auth/)**: Run an MCP server that responds with an interactive UI without authentication. [Implementation](./no-auth/).
-- **[Slack identity](./slack-identity/)**: Perform tool calls using Slack identity auth and an OAuth install flow. [Implementation](./slack-identity/).
+- **[Slack identity](./slack-identity/)**: Run an MCP server that responds with Block Kit and authenticates with existing installations. [Implementation](./slack-identity/).

ai/mcp-client/slack-identity/.env.example

@@ -2,5 +2,5 @@ SLACK_CLIENT_ID=
 SLACK_CLIENT_SECRET=
 SLACK_SIGNING_SECRET=
 SLACK_STATE_SECRET=
-BASE_URL=https://your-ngrok-url.ngrok-free.app
+BASE_URL=https://1234-56-78-90-0.ngrok-free.app
 PORT=3000

ai/mcp-client/slack-identity/README.md

@@ -1,53 +1,17 @@
-# MCP Server: Slack Identity Auth
+# Slack Identity
 
-Demonstrates Slack identity-based authentication for MCP servers. Exposes a `search_notes` tool that returns personal and team notes scoped to the requesting user.
-
-Slack sends signed requests with `user_id` and `team_id` in `_meta.slack`. Your server verifies the signature and uses the identity to scope results — no separate OAuth flow needed.
-
-## How it works
-
-1. Your app declares an MCP server with `"auth_type": "slack_identity_auth"`
-2. Slackbot sends requests signed with your app's signing secret
-3. The server verifies the signature, reads `user_id`/`team_id` from the request
-4. Notes are looked up from `notes/TEAMID-USERID.md` (personal) and `notes/TEAMID.md` (shared)
+Run an MCP server that responds with Block Kit and authenticates with existing installations.
 
 ## Setup
 
-```bash
-npm install
-ngrok http 3000
-```
-
-Update `manifest.json` with your ngrok URL, create the app at [api.slack.com/apps](https://api.slack.com/apps), then:
-
-```bash
-cp .env.sample .env
-# Fill in SLACK_SIGNING_SECRET, SLACK_CLIENT_ID, SLACK_CLIENT_SECRET
-npm start
-```
-
-### Add your notes
-
-Create notes files using your real team and user IDs:
-
-```bash
-cp notes/T0000000000-U0123456789.md notes/YOUR_TEAM_ID-YOUR_USER_ID.md
-cp notes/T0000000000.md notes/YOUR_TEAM_ID.md
-```
-
-## Try it
-
-Ask Slackbot: _"What are my current projects?"_
-
-## Manifest
-
-```json
-"mcp_servers": {
-  "notes": {
-    "url": "https://YOUR_URL/mcp",
-    "auth_type": "slack_identity_auth"
-  }
-}
+```sh
+$ ngrok http 3000
+$ slack install --app local  # Create a new app
+$ slack app settings
+$ slack env init  # Update defaults
+$ slack manifest  # Validate fields
+$ slack run
+$ open https://1234-56-78-90-0.ngrok-free.app/slack/install  # Install the app
 ```
 
-The `auth_type: "slack_identity_auth"` tells Slack to send signed requests with user context.
+Ask Slackbot: "Make me a profile card using the latest MCP tools"