@jtalk22/slack-mcp 2.0.0 → 3.0.0

package/docs/LAUNCH-OPS.md

@@ -1,18 +1,18 @@
-# Launch Ops Runbook (v2.0.0)
+# Launch Ops Runbook (v3.0.0)
 
-This runbook defines launch-day monitoring, response rules, and reinforcement loops.
+This runbook defines launch-day monitoring and distribution for technical/operator channels (no X/Reddit dependency).
 
-## Same-Day Fanout Order
+## Same-Day Fanout Order (9 Channels)
 
-1. GitHub release publish (`v2.0.0`)
-2. npm publish confirm (`@jtalk22/slack-mcp@2.0.0`)
-3. MCP registry metadata update
-4. Smithery listing metadata parity update
-5. `awesome-mcp-servers` version update PR
-6. Glama listing refresh/update
-7. HN post + first comment
-8. X thread
-9. Reddit technical post
+1. GitHub release page refresh (`v3.0.0` copy + install-proof block)
+2. npm parity confirm (`@jtalk22/slack-mcp@3.0.0`)
+3. MCP registry parity confirm (`3.0.0`)
+4. Smithery listing metadata/parity update (or timestamped propagation note)
+5. `awesome-mcp-servers` listing PR refresh
+6. Glama metadata sync and canonical link verification
+7. HN thread update comment (high-signal install proof + support path)
+8. GitHub Discussions announcement/support threads update
+9. GitHub Pages/docs surface publish + link verification
 
 ## Monitoring Cadence
 
@@ -21,9 +21,10 @@ This runbook defines launch-day monitoring, response rules, and reinforcement lo
 
 Track:
 - install reports and blocker count
-- npm version/install confirmation
-- registry parity status
-- inbound issue volume and severity
+- npm/MCP parity state
+- listing propagation status (Smithery/Glama)
+- inbound issue and discussion severity
+- hosted migration questions (`SLACK_MCP_HTTP_AUTH_TOKEN`, CORS allowlist)
 
 ## Triage Rules
 
@@ -33,29 +34,29 @@ P1 install blocker:
 - add fix to patch queue
 
 Non-blocking request:
-- acknowledge and route to issue template
+- acknowledge and route to issue/discussion template
 - provide timeline as best effort
 
 ## Escalation Triggers
 
 1. If install failures exceed 3 unique reports in 24h:
-- pause outbound posting
+- pause outbound promotion
 - prioritize hotfix
 
 2. If support load exceeds 2 hours/day for 2 days:
-- move to stability-only mode
+- switch to stability-only mode
 - defer non-critical requests
 
 ## 24h / 48h / 72h Follow-Up
 
 24h:
-- publish release-health delta and short technical update
+- publish release-health delta and short technical summary
 
 48h:
-- answer top 5 recurring questions in docs
+- patch docs for top recurring setup questions
 
 72h:
-- publish `v2.0.1` only if launch defects are confirmed
+- ship `v3.0.1` only if launch defects are confirmed
 
 ## Evidence Log
 
@@ -65,6 +66,6 @@ Use:
 Capture:
 - channel
 - UTC timestamp
-- URL
+- URL or command evidence
 - action taken
-- observed result
+- observed result (`success|partial|blocked`)

package/docs/RELEASE-HEALTH.md

@@ -28,6 +28,15 @@ If external registries are still propagating immediately after publish:
 npm run verify:version-parity -- --allow-propagation
 ```
 
+## Prepublish dry run
+
+```bash
+npm run verify:release-dry-run
+```
+
+Output:
+- `docs/release-health/prepublish-dry-run.md`
+
 24-hour loop artifacts:
 - `docs/release-health/24h-start.md`
 - `docs/release-health/24h-end.md`

package/docs/TROUBLESHOOTING.md

@@ -161,6 +161,33 @@ cat /tmp/slack-web-api.log
 cat /tmp/slack-web-api.error.log
 ```
 
+### Hosted HTTP `/mcp` Returns 503 or 401
+
+If you run `node src/server-http.js`, `/mcp` is protected by default.
+
+`503 http_auth_token_missing` means you did not set:
+
+```bash
+SLACK_MCP_HTTP_AUTH_TOKEN=change-this
+```
+
+`401 unauthorized` means your request is missing or using the wrong bearer token.
+
+Example request:
+
+```bash
+curl http://localhost:3000/mcp \
+  -H "Authorization: Bearer $SLACK_MCP_HTTP_AUTH_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'
+```
+
+For local-only testing (not remote exposure), you can opt out:
+
+```bash
+SLACK_MCP_HTTP_INSECURE=1 node src/server-http.js
+```
+
 ---
 
 ## Claude Desktop Issues

package/docs/WEB-API.md

@@ -1,6 +1,15 @@
 # Web API Reference
 
-The Slack Web Server exposes all MCP tools as REST endpoints, accessible from any browser or HTTP client. This is useful for accessing Slack from claude.ai (which doesn't support MCP).
+The Slack Web Server exposes all MCP tools as REST endpoints, accessible from any browser or HTTP client.
+
+Claude web now supports remote MCP connectors on paid plans, so this Web API mode is best used for:
+- local localhost dashboard workflows
+- REST/API integrations
+- fallback operation when you do not want to host a remote MCP endpoint
+
+References:
+- https://support.anthropic.com/en/articles/11995447-connectors-in-claude
+- https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp
 
 ## Starting the Server
 
@@ -269,9 +278,9 @@ The UI auto-connects with the default API key:
 4. Send messages directly from the browser
 
 **Using with claude.ai:**
-1. Open the web UI alongside claude.ai
-2. Browse/search for relevant conversations
-3. Copy-paste message content into claude.ai as needed
+1. Preferred: add a remote MCP connector in Claude settings if you run a remote endpoint.
+2. Fallback: open the web UI alongside claude.ai for local browsing/search.
+3. Copy-paste relevant message content as needed.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Session-based Slack access for Claude - DMs, channels, search, and threads. Local-first with your existing Slack session.",
   "type": "module",
   "main": "src/server.js",
@@ -25,9 +25,11 @@
     "tokens:clear": "node scripts/token-cli.js clear",
     "screenshot": "node scripts/capture-screenshots.js",
     "record-demo": "node scripts/record-demo.js",
+    "cf:browser": "node scripts/cloudflare-browser-tool.js",
     "metrics:release-health": "node scripts/collect-release-health.js",
     "metrics:release-health:delta": "node scripts/build-release-health-delta.js",
-    "verify:version-parity": "node scripts/check-version-parity.js"
+    "verify:version-parity": "node scripts/check-version-parity.js",
+    "verify:release-dry-run": "node scripts/release-preflight.js"
   },
   "keywords": [
     "mcp",
@@ -40,10 +42,10 @@
     "claude",
     "claude-desktop",
     "claude-code",
+    "claude-connectors",
+    "anthropic",
     "cursor",
     "llm",
-    "ai",
-    "ai-assistant",
     "automation",
     "workflow-automation",
     "developer-tools",
@@ -62,6 +64,7 @@
     "mcp-tools",
     "mcp-stdio",
     "mcp-http",
+    "remote-mcp",
     "open-source"
   ],
   "author": "jtalk22",
@@ -86,9 +89,14 @@
     "lib/",
     "public/",
     "scripts/",
-    "docs/",
+    "docs/*.md",
+    "docs/assets/",
+    "docs/images/*.png",
+    "docs/images/*.svg",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "server.json",
+    "smithery.yaml"
   ],
   "devDependencies": {
     "playwright": "^1.57.0"

package/public/demo-claude.html

@@ -19,22 +19,27 @@
   <meta property="og:description" content="Session-based Slack access for Claude with your existing workspace permissions. Search, thread, and messaging workflows.">
   <meta property="og:type" content="website">
   <meta property="og:url" content="https://jtalk22.github.io/slack-mcp-server/public/demo-claude.html">
-  <meta property="og:image" content="https://assets-worker.james-20a.workers.dev/projects/slack-mcp-server/demo-claude.gif">
+  <meta property="og:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-claude.gif">
 
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:title" content="Slack MCP Server - Session-Based Slack Access Demo">
   <meta name="twitter:description" content="Session-based Slack access for Claude with your existing workspace permissions. Search, thread, and messaging workflows.">
-  <meta name="twitter:image" content="https://assets-worker.james-20a.workers.dev/projects/slack-mcp-server/demo-claude.gif">
+  <meta name="twitter:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-claude.gif">
 
   <!-- Theme -->
   <meta name="theme-color" content="#1a1a1a">
   <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>💬</text></svg>">
   <style>
+    @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600&family=Space+Grotesk:wght@500;600;700&display=swap');
+
     /* ═══════════════════════════════════════════════════════════════
        Claude Desktop Color Palette (Dark Mode)
        ═══════════════════════════════════════════════════════════════ */
     :root {
+      --font-heading: "Space Grotesk", "Avenir Next", "Segoe UI", sans-serif;
+      --font-body: "IBM Plex Sans", "Inter", "Segoe UI", sans-serif;
+
       /* Window chrome */
       --window-bg: #1a1a1a;
       --window-chrome: #2d2d2d;
@@ -83,7 +88,7 @@
     }
 
     body {
-      font-family: -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+      font-family: var(--font-body);
       font-size: 15px;
       line-height: 1.5;
       -webkit-font-smoothing: antialiased;
@@ -118,6 +123,8 @@
       align-items: center;
       justify-content: center;
       gap: 12px;
+      font-family: var(--font-heading);
+      letter-spacing: -0.02em;
     }
 
     .page-header p {
@@ -127,11 +134,11 @@
     .cta-strip {
       width: 100%;
       max-width: 960px;
-      margin-bottom: 16px;
+      margin-bottom: 14px;
       background: rgba(15, 52, 96, 0.72);
       border: 1px solid rgba(255, 255, 255, 0.15);
       border-radius: 12px;
-      padding: 10px 14px;
+      padding: 10px 12px;
       display: flex;
       justify-content: space-between;
       align-items: center;
@@ -183,6 +190,7 @@
       margin-bottom: 24px;
       flex-wrap: wrap;
       justify-content: center;
+      width: min(100%, 960px);
     }
 
     .scenario-btn {
@@ -257,6 +265,9 @@
       gap: 12px;
       margin-bottom: 16px;
       align-items: center;
+      flex-wrap: wrap;
+      justify-content: center;
+      width: min(100%, 920px);
     }
 
     .speed-control {
@@ -967,31 +978,93 @@
     /* ═══════════════════════════════════════════════════════════════
        Responsive
        ═══════════════════════════════════════════════════════════════ */
+    @media (max-width: 900px) {
+      body {
+        padding: 14px;
+      }
+
+      .page-header {
+        margin-bottom: 16px;
+      }
+
+      .page-header h1 {
+        font-size: 24px;
+      }
+
+      .scenario-btn {
+        padding: 10px 14px;
+      }
+
+      .controls-bar {
+        gap: 10px;
+      }
+
+      .claude-window {
+        max-width: 100%;
+      }
+    }
+
     @media (max-width: 600px) {
       body {
         padding: 12px;
       }
 
+      .cta-strip {
+        padding: 10px;
+        gap: 8px;
+      }
+
+      .cta-strip .links {
+        width: 100%;
+      }
+
+      .cta-strip .note {
+        font-size: 12px;
+      }
+
       .page-header h1 {
         font-size: 22px;
+        flex-wrap: wrap;
+        gap: 8px;
+      }
+
+      .page-header p {
+        font-size: 14px;
       }
 
       .scenario-bar {
         gap: 8px;
+        margin-bottom: 14px;
       }
 
       .scenario-btn {
-        padding: 10px 14px;
+        padding: 9px 12px;
         font-size: 13px;
+        border-radius: 10px;
       }
 
       .scenario-btn .label {
         display: none;
       }
 
+      .controls-bar {
+        gap: 8px;
+        margin-bottom: 12px;
+      }
+
+      .replay-btn,
+      .share-btn {
+        padding: 8px 12px;
+      }
+
+      .speed-control {
+        width: 100%;
+        justify-content: space-between;
+      }
+
       .chat-container {
-        height: 450px;
-        padding: 16px;
+        height: min(55vh, 450px);
+        padding: 14px;
       }
 
       .tools-dropdown {
@@ -1161,7 +1234,7 @@
   <header class="page-header">
     <h1>
       <span>Slack MCP Server</span>
-      <span class="badge">🔧 MCP Demo v2.0.0</span>
+      <span class="badge">🔧 MCP Demo v3.0.0</span>
     </h1>
     <p>See how Claude uses MCP tools to access your Slack workspace</p>
   </header>
@@ -1233,7 +1306,7 @@
       <div class="title-logo">💬</div>
       <h1>Slack MCP Server</h1>
       <p class="title-tagline">Full Slack access for Claude Desktop</p>
-      <p class="title-version">v2.0.0 • @jtalk22</p>
+      <p class="title-version">v3.0.0 • @jtalk22</p>
     </div>
 
     <!-- Scenario Caption Overlay -->

package/public/demo-video.html

@@ -15,13 +15,20 @@
   <meta name="twitter:description" content="Session-based Slack access for Claude with your existing workspace permissions. Video walkthrough for Slack workflows.">
   <meta name="twitter:image" content="https://raw.githubusercontent.com/jtalk22/slack-mcp-server/main/docs/images/demo-poster.png">
   <style>
+    @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600&family=Space+Grotesk:wght@500;600;700&display=swap');
+
+    :root {
+      --font-heading: "Space Grotesk", "Avenir Next", "Segoe UI", sans-serif;
+      --font-body: "IBM Plex Sans", "Inter", "Segoe UI", sans-serif;
+    }
+
     * {
       margin: 0;
       padding: 0;
       box-sizing: border-box;
     }
     body {
-      font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      font-family: var(--font-body);
       background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
       min-height: 100vh;
       display: flex;
@@ -40,6 +47,8 @@
       font-weight: 600;
       text-align: center;
       margin-bottom: 0.5rem;
+      font-family: var(--font-heading);
+      letter-spacing: -0.02em;
     }
     .subtitle {
       color: #94a3b8;
@@ -137,6 +146,26 @@
     .back-link a:hover {
       color: #ffffff;
     }
+
+    @media (max-width: 640px) {
+      body {
+        padding: 1rem 0.75rem;
+      }
+
+      .cta-strip .links {
+        width: 100%;
+      }
+
+      .controls {
+        gap: 0.75rem;
+      }
+
+      .btn {
+        flex: 1;
+        min-width: 0;
+        padding: 0.72rem 0.95rem;
+      }
+    }
   </style>
 </head>
 <body>
@@ -155,9 +184,9 @@
     </div>
 
     <div class="video-wrapper">
-      <video id="demo" poster="../docs/images/demo-poster.png" playsinline>
-        <source src="../docs/videos/demo-claude-v1.2.webm" type="video/webm">
-        <source src="../docs/images/demo-claude-v1.2.gif" type="image/gif">
+      <video id="demo" poster="https://jtalk22.github.io/slack-mcp-server/docs/images/demo-poster.png" playsinline>
+        <source src="../docs/videos/demo-claude.webm" type="video/webm">
+        <source src="https://jtalk22.github.io/slack-mcp-server/docs/videos/demo-claude.webm" type="video/webm">
         Your browser does not support the video tag.
       </video>
     </div>