Smithery Setup Guide
Smithery is the MCP (Model Context Protocol) server host that powers all integrations in Benny Chat. This guide will help you create and configure your Smithery account, which is required before setting up any MCP integrations.
What is Smithery?
Smithery provides hosted MCP servers that allow Benny Chat to securely connect to external services like Todoist, GitHub, Perplexity, and more. It handles authentication, API key management, and server hosting so you can focus on using the integrations.
Prerequisites
Before you begin, you'll need:
- A GitHub account (required for Smithery authentication)
Step 1: Create Your Smithery Account
- Visit smithery.ai
- Click "Sign in with GitHub"
- Authorize Smithery to access your GitHub account
Step 2: Create Your Smithery Profile
- Click on your avatar in the top right
- Select "Profiles & API Keys"
- Click "Create a Profile"
- Enter a Name for your profile (e.g., "Benny Chat Profile")
- Add a Description (e.g., "Profile for Benny Chat integrations")
- Click "Create"
- Important: Copy your Profile ID - you'll need this for Benny Chat
Step 3: Generate Your API Key
- Still in "Profiles & API Keys", navigate to the "API Keys" section
- Click "Create API Key"
- Give your key a Name (e.g., "Benny Chat Key")
- Click "Add"
- Click "Copy API Key" to copy your key
- Important: Save this key securely - you won't be able to see it again!
Step 4: Configure Smithery in Benny Chat
- Open Benny Chat and click on your profile icon
- Select "Settings" from the dropdown menu
- At the top of Settings, find "Smithery API Key"
- Paste your API key from Step 3
- Below that, find "Smithery Profile"
- Enter your Profile ID from Step 2
- Click "Save" or close the settings
Step 5: Test Your Configuration
To verify everything is working:
- Go to Smithery and add an MCP server to your profile
- In Benny Chat Settings, scroll down to "MCP Tool Settings"
- Find the integration you added and toggle it on
- Click "Test Connection"
- If you see "Connection successful", your setup is complete!
Adding MCP Integrations in Smithery
For each service you want to use with Benny Chat:
- Visit the MCP server page on Smithery (e.g., Todoist MCP)
- Click "Add to Profile"
- Select your profile
- Configure any required settings (like API keys for that service)
- Save the configuration
Troubleshooting
"Invalid API Key" Error
- Ensure you copied the entire API key without spaces
- Check that the API key is in the correct field (top of Settings)
- Generate a new API key if needed
"Profile Not Found" Error
- Verify you entered the Profile ID (not the profile name)
- The Profile ID is shown when you create or view your profile
- Make sure there are no typos or extra spaces
Connection Test Failed
- Confirm the MCP server is added to your Smithery profile
- Check that any required configuration (like service API keys) is set in Smithery
- Try disabling and re-enabling the integration in Benny Chat
Security Best Practices
- Never share your Smithery API key - treat it like a password
- Use one profile for Benny Chat - keeps configurations organized
- Store service API keys in Smithery - not in Benny Chat directly
- Rotate keys periodically - delete old keys you're no longer using
Next Steps
Now that Smithery is configured, you can set up individual integrations:
- Todoist Integration Guide
- GitHub Integration Guide
- Perplexity Integration Guide
- Limitless Integration Guide
- Weather Integration Guide
Need Help?
- Smithery Documentation
- MCP Documentation
- Ask Benny Chat for help with specific setup steps