Quick Start

Prerequisites

• macOS or Linux
• Claude Code CLI installed and logged in (npm install -g @anthropic-ai/claude-code)
• claude.ai Pro or Max subscription
• Slack workspace with admin access

Install the plugin

In your Claude Code terminal:

/plugin marketplace add es-ua/y0mcp
/plugin install y0slack@y0mcp

This will:

1. Add the y0mcp marketplace to Claude Code
2. Install the Slack channel plugin with all dependencies
3. Set up automatic token refresh

Create your first agent

After installing the plugin, scripts are located at ~/.claude/plugins/marketplaces/y0mcp/scripts/.

For convenience, set up an alias (add to your ~/.zshrc or ~/.bashrc):

alias y0mcp='bash ~/.claude/plugins/marketplaces/y0mcp/scripts'

Then create an agent from your project directory:

cd ~/projects/my-project
y0mcp/new-agent.sh

Or run directly without the alias:

bash ~/.claude/plugins/marketplaces/y0mcp/scripts/new-agent.sh

You’ll be prompted for:

• Agent name — defaults to current folder name
• Slack channel ID — starts with C, find it in channel details
• Slack channel name — defaults to agent name
• Project path — defaults to current directory
• Dozzle URL — optional, for container logs

Add Slack tokens

Edit the generated env file:

nano agents/my-project.env

Add your SLACK_BOT_TOKEN and SLACK_APP_TOKEN. See Setup Slack App for how to get them.

Start the agent

macOS:

launchctl load ~/Library/LaunchAgents/dev.y0mcp.my-project.plist

Linux:

systemctl --user enable --now y0mcp-my-project

Pair with Slack

1. Send any message in the Slack channel
2. The bot will respond with a pairing code
3. Enter the code in your Claude Code terminal: /pair CODE
4. You’re connected!