Managing Apps

The Apps page is your central hub for discovering, connecting, and managing MCP server integrations. Storm MCP Gateway provides 30+ pre-configured servers with more being added regularly.

Understanding Apps

Each app represents an MCP server that provides specific functionality:

Tools/Functions - Actions the AI can perform
Authentication - How to connect securely
Configuration - Settings and customization
Status - Connection health and usage

App Categories

Apps are organized into categories for easy discovery:

Developer Tools

GitHub - Repository management, issues, pull requests
GitLab - Alternative Git platform
Bitbucket - Atlassian's Git solution
Sentry - Error tracking and monitoring

Communication

Slack - Team messaging
Discord - Community communication
Microsoft Teams - Enterprise chat
Email - SMTP/IMAP integration

Project Management

Jira - Issue tracking
Trello - Kanban boards
Asana - Task management
Linear - Modern issue tracking

Cloud & Infrastructure

AWS - Amazon Web Services
Google Cloud - GCP resources
Azure - Microsoft cloud
Terraform - Infrastructure as code

Business Tools

HubSpot - CRM and marketing
Salesforce - Enterprise CRM
Notion - Workspace and notes
Airtable - Database/spreadsheet hybrid

Browsing Available Apps

Using the Apps Grid

The Apps page displays all available MCP servers in a card grid:

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│   📦 GitHub     │ │   💬 Slack      │ │   🗄️ MongoDB   │
│   Connected ✓   │ │   Connect →     │ │   Beta 🏷️       │
└─────────────────┘ └─────────────────┘ └─────────────────┘

Filtering and Search

Search Bar

Search by app name
Find by functionality
Filter by keywords

Category Filters

All Apps | Developer Tools | Communication | Databases | Cloud

Status Filters

Available - Ready to connect
Connected - Already configured
Beta - Early access features
Coming Soon - In development

App Status Indicators

Each app card shows its current status:

🟢 Connected - Authenticated and ready
🔵 Available - Can be connected
🟡 Beta - Testing phase, may have issues
⚫ Coming Soon - Not yet available
🔴 Error - Connection issue

Connecting Apps

OAuth Authentication

Many apps support OAuth for secure, easy connection:

Click Connect
- On the app card
- Opens connection modal
Choose OAuth
- Recommended method
- Click "Connect with [Service]"
Authorize Access
- Redirected to service
- Review permissions
- Click "Authorize"
Return to Storm MCP
- Automatically configured
- Shows "Connected" status

✅ Success

OAuth connections automatically handle token refresh, maintaining persistent access without manual intervention.

API Key Authentication

For services requiring API keys:

Generate API Key
- Go to the service's settings
- Create new API key/token
- Copy the key
Enter in Storm MCP
API Key: sk-abc123... API Secret: def456... (if required) Endpoint: https://api.service.com (if customizable)
Test Connection
- Click "Test Connection"
- Verify successful response
- Save configuration

Service-Specific Setup

GitHub Setup

Personal Access Token
- Go to GitHub → Settings → Developer settings
- Generate new token
- Select scopes: ✅ repo (Full repository access) ✅ workflow (GitHub Actions) ✅ read:org (Organization data)
OAuth App (Alternative)
- Register OAuth application
- Callback URL: https://auth.stormmcp.ai/callback
- Get Client ID and Secret

Slack Setup

Create Slack App
- Visit api.slack.com
- Create new app
- Add OAuth scopes: channels:read chat:write files:read users:read
Install to Workspace
- Click "Install to Workspace"
- Authorize permissions
- Copy Bot User OAuth Token

MongoDB Setup

Connection String
mongodb+srv://username:password@cluster.mongodb.net/database
Network Access
- Add Storm MCP IPs to whitelist
- Or use VPC peering (Enterprise)

Managing Connected Apps

Viewing App Details

Click on any connected app to see:

Connection Status - Health and last activity
Available Functions - List of capabilities
Usage Statistics - Requests and errors
Configuration - Current settings
Logs - Recent activity

Updating Configuration

Click Settings Icon
- On connected app card
- Opens configuration modal
Modify Settings
- Update credentials
- Change endpoints
- Adjust permissions
Save and Test
- Save changes
- Run connection test
- Verify functionality

Disconnecting Apps

To remove an app connection:

Click Disconnect button
Confirm disconnection
App returns to "Available" status

ℹ️ Info

Disconnecting an app removes it from all gateways. You'll need to reconfigure gateways after reconnecting.

App Permissions and Scopes

Understanding Permissions

Each app requests specific permissions:

Read Permissions

View data
List resources
Get configurations

Write Permissions

Create resources
Update data
Delete items

Admin Permissions

Manage users
Configure settings
Access sensitive data

Managing Scopes

Control what each app can access:

{
  "github": {
    "scopes": ["repo:read", "issues:write"],
    "repositories": ["my-org/my-repo"],
    "blocked_actions": ["delete", "force_push"]
  }
}

Multi-Instance Apps

Some apps support multiple connections:

Use Cases

Multiple Accounts - Personal and work
Different Environments - Dev, staging, production
Team Isolation - Separate team resources

Creating Multiple Instances

Connect First Instance
- Standard connection process
- Name it descriptively (e.g., "GitHub-Personal")
Add Another Instance
- Click "Add Another Connection"
- Use different credentials
- Name uniquely (e.g., "GitHub-Work")
Select in Gateways
- Choose which instance to include
- Can use multiple in same gateway

Troubleshooting App Connections

Common Issues

"Authentication Failed"

Verify credentials are correct
Check API key hasn't expired
Ensure proper permissions/scopes

"Connection Timeout"

Check network connectivity
Verify service is operational
Try different endpoint/region

"Permission Denied"

Review required scopes
Check user has necessary access
Verify organization settings

"Rate Limited"

Wait for limit reset
Upgrade service plan if needed
Distribute load across instances

Testing Connections

Use the test feature to diagnose issues:

# Manual test via API
curl -X POST https://api.stormmcp.ai/v1/apps/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"app": "github", "config": {...}}'

Debug Mode

Enable debug logging for detailed information:

Go to app settings
Toggle "Debug Mode"
View detailed logs in Observability

App Marketplace

Requesting New Apps

Don't see an app you need?

Submit Request
- Click "Request an App"
- Provide app details
- Explain use case
Vote on Requests
- Browse pending requests
- Upvote apps you need
- Add comments
Track Progress
- Follow development status
- Get notified when ready
- Beta test new apps

Custom App Development

For proprietary or internal services:

Use Generic MCP Server
- Configure custom endpoints
- Define functions manually
- Full flexibility
Build Custom Server
- Follow MCP specification
- Host your server
- Register with Storm MCP
Enterprise Support
- We build it for you
- Full integration support
- Ongoing maintenance

Best Practices

App Organization

Connect Only What You Need
- Reduces complexity
- Improves security
- Easier to manage
Use Descriptive Names
- For multi-instance apps
- Include environment/purpose
- Help team members understand
Regular Audits
- Review connected apps monthly
- Remove unused connections
- Update credentials regularly

Security Recommendations

Principle of Least Privilege
- Grant minimum required permissions
- Use read-only where possible
- Restrict sensitive operations
Credential Rotation
- Change API keys quarterly
- Use short-lived tokens
- Automate rotation where possible
Monitor Usage
- Track unusual activity
- Set up alerts
- Review logs regularly

Next Steps

With your apps connected: