Setup tips & tricks — Slack × CMA webhook bridge

Bridge Slack @mentions to Claude Managed Agent sessions and reply in-thread.

28|5|Updated Jun 24, 2025
One-click install
npx skills add https://github.com/thevibeworks/claude-code-docs --skill setup-tips-tricks-slack-cma-webhook-bridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Setup tips & tricks — Slack × CMA webhook bridge
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-cookbooks/managed_agents/slack
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill setup-tips-tricks-slack-cma-webhook-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up and debug a Slack-to-Anthropic Claude Managed Agents bridge where Slack mentions trigger a CMA session and the agent’s reply is posted back into the correct Slack thread.

Core Features & Use Cases

  • Reliable end-to-end bridging between Slack event webhooks and Anthropic CMA session-idle webhooks using stateless routing metadata.
  • Practical gotchas & debugging for the most common failure points, including Slack event subscription setup, token mix-ups, webhook workspace scoping, and webhook signature verification.
  • Correct webhook flow: treat the CMA webhook as a doorbell signal that requires follow-up API calls (retrieve metadata, then fetch outcomes) and use idempotency keys to avoid duplicate handling.

Quick Start

Ask Claude Code to walk you through setting up the Slack app, Anthropic Managed Agent, webhooks, environment variables, and local server flow for the Slack @mention bridge inside this project.

Frequently Asked Questions about Setup tips & tricks — Slack × CMA webhook bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Slack mentions to trigger a Claude Managed Agent session?

Slack mentions trigger a Claude Managed Agent session by configuring a webhook bridge that captures Slack @mention events and routes the final CMA reply back into the originating Slack thread using stateless routing metadata.

Why am I receiving duplicate replies from my Slack to Managed Agent webhook bridge?

Duplicate replies in a Slack to Managed Agent webhook bridge happen when event handling lacks idempotency. Deduplicate incoming triggers using Slack event_id and Anthropic event.id keys to prevent processing the same request multiple times.

How does the Anthropic CMA webhook signal work for fetching session outcomes?

The Anthropic CMA webhook acts as a doorbell signal rather than delivering the payload directly. Upon receiving the session-idle signal, make follow-up API calls to retrieve metadata and fetch final outcomes to post back to Slack.

What are the common debugging steps for Slack event subscription and CMA webhook verification failures?

Debugging Slack event subscription and CMA webhook verification failures involves checking for token mix-ups, verifying correct webhook workspace scoping, and validating webhook signature verification for both Slack events and Anthropic session-idle signals.

Do I need a stateful server to route Anthropic Managed Agent replies to Slack threads?

You do not need a stateful server to route Anthropic Managed Agent replies to Slack threads. The bridge uses stateless routing metadata extracted from the initial mention to map the CMA session back to the correct Slack thread.