@jtalk22/slack-mcp 1.2.4 → 3.0.0

package/docs/LAUNCH-OPS.md

@@ -0,0 +1,71 @@
+# Launch Ops Runbook (v3.0.0)
+
+This runbook defines launch-day monitoring and distribution for technical/operator channels (no X/Reddit dependency).
+
+## Same-Day Fanout Order (9 Channels)
+
+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
+
+- First 4 hours: every 30 minutes
+- Up to 24 hours: every 60 minutes
+
+Track:
+- install reports and blocker count
+- 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
+
+P1 install blocker:
+- acknowledge within 30-60 minutes
+- provide immediate workaround
+- add fix to patch queue
+
+Non-blocking request:
+- 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 promotion
+- prioritize hotfix
+
+2. If support load exceeds 2 hours/day for 2 days:
+- switch to stability-only mode
+- defer non-critical requests
+
+## 24h / 48h / 72h Follow-Up
+
+24h:
+- publish release-health delta and short technical summary
+
+48h:
+- patch docs for top recurring setup questions
+
+72h:
+- ship `v3.0.1` only if launch defects are confirmed
+
+## Evidence Log
+
+Use:
+- `docs/release-health/launch-log-template.md`
+
+Capture:
+- channel
+- UTC timestamp
+- URL or command evidence
+- action taken
+- observed result (`success|partial|blocked`)

package/docs/RELEASE-HEALTH.md

@@ -13,6 +13,30 @@ Outputs:
 - `docs/release-health/YYYY-MM-DD.md`
 - `docs/release-health/automation-delta.md` (when delta script is run)
 
+## Version parity report
+
+```bash
+npm run verify:version-parity
+```
+
+Output:
+- `docs/release-health/version-parity.md`
+
+If external registries are still propagating immediately after publish:
+
+```bash
+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/lib/handlers.js

@@ -95,17 +95,25 @@ export async function handleTokenStatus() {
   const dmCache = loadDMCache();
   const tokenStatus = health.reason === 'no_tokens'
     ? "missing"
-    : health.critical
-      ? "critical"
-      : health.warning
-        ? "warning"
-        : "healthy";
+    : health.age_state === "unknown"
+      ? "unknown_age"
+      : health.critical
+        ? "critical"
+        : health.warning
+          ? "warning"
+          : "healthy";
 
   return asMcpJson({
     status: tokenStatus,
-    code: health.reason || (health.critical ? "token_critical" : health.warning ? "token_warning" : "ok"),
+    code: health.reason
+      || (health.age_state === "unknown" ? "unknown_age" : null)
+      || (health.critical ? "token_critical" : health.warning ? "token_warning" : "ok"),
     message: health.message,
     next_action: health.reason === 'no_tokens' ? "Run npx -y @jtalk22/slack-mcp --setup" : null,
+    details: {
+      age_known: health.age_known,
+      age_state: health.age_state
+    },
     token: {
       status: tokenStatus,
       age_hours: health.age_hours,

package/lib/slack-client.js

@@ -97,7 +97,13 @@ export async function checkTokenHealth(logger = console) {
   const creds = loadTokens(false, silentLogger, { autoExtract: false });
 
   if (!creds) {
-    return { healthy: false, reason: 'no_tokens', message: 'No credentials found' };
+    return {
+      healthy: false,
+      reason: 'no_tokens',
+      age_known: false,
+      age_state: 'missing',
+      message: 'No credentials found'
+    };
   }
 
   const updatedAtMs = creds.updatedAt ? new Date(creds.updatedAt).getTime() : Number.NaN;
@@ -120,6 +126,8 @@ export async function checkTokenHealth(logger = console) {
         healthy: true,
         refreshed: true,
         age_hours: 0,
+        age_known: true,
+        age_state: 'fresh',
         source: 'chrome-auto',
         message: 'Tokens refreshed successfully'
       };
@@ -131,6 +139,14 @@ export async function checkTokenHealth(logger = console) {
   return {
     healthy: !hasKnownAge || tokenAge < TOKEN_CRITICAL_AGE,
     age_hours: ageHours,
+    age_known: hasKnownAge,
+    age_state: !hasKnownAge
+      ? 'unknown'
+      : tokenAge > TOKEN_CRITICAL_AGE
+        ? 'critical'
+        : tokenAge > TOKEN_WARNING_AGE
+          ? 'warning'
+          : 'healthy',
     warning: hasKnownAge && tokenAge > TOKEN_WARNING_AGE,
     critical: hasKnownAge && tokenAge > TOKEN_CRITICAL_AGE,
     source: creds.source,

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@jtalk22/slack-mcp",
   "mcpName": "io.github.jtalk22/slack-mcp-server",
-  "version": "1.2.4",
+  "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",
   "bin": {
-    "slack-mcp": "./src/cli.js",
-    "slack-mcp-server": "./src/server.js",
-    "slack-mcp-http": "./src/server-http.js",
-    "slack-mcp-web": "./src/web-server.js",
-    "slack-mcp-setup": "./scripts/setup-wizard.js"
+    "slack-mcp": "src/cli.js",
+    "slack-mcp-server": "src/server.js",
+    "slack-mcp-http": "src/server-http.js",
+    "slack-mcp-web": "src/web-server.js",
+    "slack-mcp-setup": "scripts/setup-wizard.js"
   },
   "scripts": {
     "start": "node src/server.js",
@@ -25,8 +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"
+    "metrics:release-health:delta": "node scripts/build-release-health-delta.js",
+    "verify:version-parity": "node scripts/check-version-parity.js",
+    "verify:release-dry-run": "node scripts/release-preflight.js"
   },
   "keywords": [
     "mcp",
@@ -39,10 +42,10 @@
     "claude",
     "claude-desktop",
     "claude-code",
+    "claude-connectors",
+    "anthropic",
     "cursor",
     "llm",
-    "ai",
-    "ai-assistant",
     "automation",
     "workflow-automation",
     "developer-tools",
@@ -54,13 +57,21 @@
     "channels",
     "workspace",
     "session-based",
+    "session-mirroring",
+    "slack-dm",
+    "slack-threads",
+    "workspace-search",
+    "mcp-tools",
+    "mcp-stdio",
+    "mcp-http",
+    "remote-mcp",
     "open-source"
   ],
   "author": "jtalk22",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jtalk22/slack-mcp-server.git"
+    "url": "git+https://github.com/jtalk22/slack-mcp-server.git"
   },
   "homepage": "https://jtalk22.github.io/slack-mcp-server/public/demo.html",
   "bugs": {
@@ -78,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 v1.2.4</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">v1.2.4 • @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>