Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BeeBoo MCP Serverrequest approval to deploy the new database schema"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BeeBoo MCP Server
Model Context Protocol (MCP) server for BeeBoo — Human-in-the-Loop Infrastructure for AI Agents.
This server enables AI agents like Claude, Cursor, and Windsurf to natively interact with BeeBoo's capabilities:
Knowledge Base — Search, add, and list knowledge entries
Approvals — Request and check human approval status
Work Requests — Create and track work requests
Quick Start
1. Get your API Key
Get your BeeBoo API key from beeboo.ai/settings/api-keys.
Your key will look like: bb_sk_xxxxxxxxxxxx
2. Install & Configure
Choose your AI tool:
Claude Desktop
Add to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Then restart Claude Desktop.
Cursor
Add to your Cursor settings (~/.cursor/mcp.json or via Settings > MCP):
Windsurf
Add to your Windsurf MCP configuration:
Alternative: Local Install
Then use beeboo-mcp-server instead of npx @beeboo/mcp-server.
Available Tools
Tool | Description |
| Search the knowledge base using semantic search |
| Add a new entry to the knowledge base |
| List all knowledge base entries |
| Request human approval for an action |
| Check status of an approval request |
| List all approval requests (with optional filter) |
| Create a work request for the team |
| List all work requests (with optional filter) |
Usage Examples
Once configured, you can ask your AI assistant:
Knowledge Base:
"Search the knowledge base for deployment procedures"
"Add to the knowledge base: our AWS account ID is 123456789"
"List all knowledge entries"
Approvals:
"I need approval to delete the staging database"
"Check if approval abc123 has been approved"
"Show me all pending approvals"
Work Requests:
"Create a high-priority request to update the SSL certificate"
"List all open work requests"
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your BeeBoo API key |
| No |
| API endpoint |
Testing
Test the server locally:
Troubleshooting
"BEEBOO_API_KEY environment variable is required"
Make sure you've set the BEEBOO_API_KEY in your MCP configuration.
Server not appearing in tools list
Restart your AI tool (Claude Desktop, Cursor, etc.)
Check the configuration file path is correct
Verify the JSON syntax is valid
API errors
Check your API key is valid
Ensure you have network connectivity
Check the BeeBoo status at status.beeboo.ai
Development
License
MIT