Hexabot Slack + GitHub Integration

🎯 What's Been Set Up

Your Hexabot instance now has:

1. ✅ GitHub MCP Server - Connects AI to GitHub APIs
2. ✅ GitHub Assistant Bot Workflow - Conversational AI with GitHub tools
3. ✅ Slack Channel Package - [email protected] installed
4. 📝 Setup Guides - Complete documentation for Slack integration

---

📁 Project Files

File	Purpose
WORKFLOW_SUMMARY.md	Details of the GitHub Assistant Bot workflow
SLACK_SETUP_GUIDE.md	Complete step-by-step Slack integration guide
SLACK_QUICK_START.md	5-minute quick start guide for Slack
setup-slack.sh	Interactive setup script (helper tool)
README_INTEGRATION.md	This file - overview of everything

---

🏗️ Current Architecture

┌─────────────────────────────────────────────────────────────┐
│                      Hexabot System                         │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐ │
│  │  Workflows                                           │ │
│  │  ├─ GitHub Assistant Bot (published)                │ │
│  │  │  └─ AI Agent with GitHub MCP binding            │ │
│  │  └─ Hello Workflow (for testing)                    │ │
│  └──────────────────────────────────────────────────────┘ │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐ │
│  │  MCP Servers                                         │ │
│  │  └─ GitHub MCP (enabled)                            │ │
│  │     └─ Command: npx @modelcontextprotocol/...       │ │
│  └──────────────────────────────────────────────────────┘ │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐ │
│  │  Channels (Ready to Configure)                      │ │
│  │  └─ Slack (hexabot-channel-slack installed)        │ │
│  │     └─ Waiting for: credentials + source setup     │ │
│  └──────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

---

🚀 What You Can Do Now

1. Test the GitHub Workflow (Already Working)

The workflow is ready to use, but needs a channel to receive messages:

# Via Hexabot Console (if available)
# Or via API/UI when Slack is connected

2. Connect Slack (Next Step)

Follow one of these guides:

• Quick: SLACK_QUICK_START.md (5 minutes)
• Detailed: SLACK_SETUP_GUIDE.md (complete walkthrough)
• Interactive: Run ./setup-slack.sh

3. Use the Integration

Once Slack is connected, users can:

Ask about GitHub:

User: @Hexabot what are the latest releases of hexastack/hexabot?
Bot: [Uses GitHub MCP] Here are the latest releases...

Get Repository Info:

User: Show me the README for anthropics/anthropic-sdk-python
Bot: [Fetches from GitHub] Here's the repository information...

Search Issues/PRs:

User: Find open issues labeled "bug" in microsoft/vscode
Bot: [Searches GitHub] Found 23 open issues with bug label...

---

🔧 Configuration Status

✅ Completed

Component	Status	ID
GitHub MCP Server	✅ Active	78665d40-7447-4612-aa03-74534221ecd1
GitHub Assistant Bot	✅ Published	1116f5c2-f901-4a98-8868-4cbc7cdf9851
Slack Package	✅ Installed	[email protected]

📋 Pending (Slack Setup)

• Create Slack App
• Get Slack Bot Token
• Get Slack Signing Secret
• Create Hexabot Credentials
• Create Hexabot Slack Source
• Configure Slack Event URLs
• Link Workflow to Slack
• Test Integration

---

📊 Workflow Details

GitHub Assistant Bot

Type: Conversational
Status: Published
Trigger: User messages in connected channels

Flow:

1. User sends message → Slack → Hexabot
2. AI Agent receives message with conversation history
3. Agent uses GitHub MCP tools if needed
4. Agent generates response
5. Response sent back to user

Capabilities:

• Access GitHub repositories
• Search issues and PRs
• Get release information
• Read repository files
• Search GitHub content
• Maintain conversation context (10 messages)

---

🎨 Customization Options

Modify AI Agent System Prompt

Edit workflow YAML in Hexabot Admin:

system: ="You are a helpful GitHub assistant specialized in [YOUR SPECIALTY]..."

Add More MCP Servers

You can add other MCP servers:

• Filesystem MCP
• Database MCP
• Web search MCP
• Custom MCP servers

Create Specialized Workflows

Examples:

• PR Reviewer Bot - Reviews pull requests
• Issue Triager - Automatically labels and routes issues
• Release Manager - Manages releases and changelogs
• Code Search - Deep code searching across repos

---

🐛 Debugging

Check Hexabot Server Status

# Check if running
ps aux | grep hexabot

# Check logs
hexabot logs
# or
npm run dev

Test MCP Connection

# Via browser
curl http://localhost:3000/api/mcp

# Should return 401 (auth required) - means it's running

View Workflow Runs

In Hexabot Admin:

• Go to Workflows → GitHub Assistant Bot
• Click Runs tab
• View execution logs and debug info

---

🔐 Security Notes

Current Setup

• MCP API requires Bearer token authentication
• Slack webhook will require signature verification
• Credentials stored encrypted in Hexabot

Production Recommendations

1. Use environment variables for secrets
2. Enable HTTPS for production
3. Rotate tokens regularly
4. Limit MCP server permissions
5. Monitor API usage

---

📈 Next Steps

Immediate (Connect Slack)

1. Follow SLACK_QUICK_START.md
2. Test basic conversation
3. Test GitHub queries

Short Term

1. Customize AI agent prompts
2. Add more workflows for specific use cases
3. Configure App Home in Slack
4. Add Hexabot menu buttons

Long Term

1. Add more MCP integrations (Jira, Confluence, etc.)
2. Create workflow templates
3. Set up production deployment
4. Add monitoring and analytics
5. Train team on bot usage

---

📚 Documentation

Local Files

• WORKFLOW_SUMMARY.md - Workflow architecture
• SLACK_SETUP_GUIDE.md - Complete Slack guide
• SLACK_QUICK_START.md - Quick start
• setup-slack.sh - Setup helper script

External Resources

• Hexabot Docs
• Slack API Docs
• MCP Documentation
• Hexabot Discord

Package Documentation

• Slack Channel: node_modules/hexabot-channel-slack/README.md
• Hexabot API: node_modules/@hexabot-ai/api/

---

🆘 Getting Help

Common Issues

"Workflow not receiving messages" → Check channel source is linked to workflow

"GitHub tools not working" → Verify GitHub MCP server is enabled and running

"Slack URL verification fails" → Check signing secret in Hexabot credentials

"Bot not responding in Slack" → Ensure bot events are subscribed and bot is in channel

Support Channels

• Check documentation files in this directory
• Hexabot Discord community
• GitHub issues for package-specific problems

---

✅ Quick Checklist

Current Status:

• Hexabot installed and running
• GitHub MCP server configured
• GitHub Assistant Bot workflow created and published
• Slack package installed
• Slack app created
• Slack credentials configured
• Slack source created
• Workflow linked to Slack
• Integration tested

Next Action: Follow SLACK_QUICK_START.md to complete Slack setup!

---

🎉 Success Criteria

You'll know everything is working when:

1. ✅ Bot responds to direct messages in Slack
2. ✅ Bot responds to @mentions in channels
3. ✅ Bot can fetch GitHub data when asked
4. ✅ Conversation history is maintained
5. ✅ App Home tab works in Slack

---

Ready to connect Slack? Start with: SLACK_QUICK_START.md 🚀