Skip to main content
Set up Model Context Protocol (MCP) servers to connect your AI models to external data sources and tools through Comput3 Network.

Prerequisites

  • Comput3 Network account with API access
  • Data sources or tools you want to connect
  • Basic understanding of JSON configuration

Quick Setup

1

Access MCP Configuration

Navigate to the MCP section in your Comput3 dashboard.
https://app.comput3.ai/mcp
MCP configuration is available for Standard tier and above stakers.
2

Choose Integration Type

Select from pre-built integrations or create custom configurations.
Ready-to-use connectors for popular services
  • GitHub repositories and issues
  • Google Workspace (Drive, Docs, Sheets)
  • Slack workspaces and channels
  • Database connections (PostgreSQL, MySQL)
  • File system access
3

Configure Authentication

Set up secure authentication for your data sources.
For services like GitHub, Google, Slack
{
  "authentication": {
    "type": "oauth",
    "client_id": "your-app-client-id",
    "client_secret": "your-app-secret",
    "scopes": ["read", "write"],
    "redirect_uri": "https://app.comput3.ai/mcp/callback"
  }
}
For services with API key authentication
{
  "authentication": {
    "type": "api_key",
    "key": "your-api-key",
    "header": "Authorization",
    "prefix": "Bearer"
  }
}
For direct database connections
{
  "authentication": {
    "type": "credentials",
    "username": "readonly_user",
    "password_env": "DB_PASSWORD",
    "ssl_required": true
  }
}
4

Test Connection

Verify your MCP server configuration works correctly.
# Test MCP connection
curl -X POST "https://api.comput3.ai/v1/mcp/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"server_id": "your-mcp-server-id"}'
Successful test returns available resources and tools from your MCP server.

Configuration Examples

GitHub Repository Access

{
  "name": "company-repos",
  "description": "Access to company GitHub repositories",
  "server_type": "github",
  "config": {
    "base_url": "https://api.github.com",
    "authentication": {
      "type": "oauth",
      "client_id": "your-github-app-id",
      "scopes": ["repo", "issues", "pull_requests"]
    },
    "resources": {
      "repositories": ["company/frontend", "company/backend", "company/docs"],
      "include_issues": true,
      "include_prs": true,
      "include_commits": true
    },
    "permissions": {
      "read_only": true,
      "max_results": 100
    }
  }
}

Database Integration

{
  "name": "analytics-db",
  "description": "Analytics database for business intelligence",
  "server_type": "postgresql",
  "config": {
    "connection": {
      "host": "analytics.company.com",
      "port": 5432,
      "database": "analytics",
      "ssl_mode": "require"
    },
    "authentication": {
      "type": "credentials",
      "username": "ai_readonly",
      "password_env": "ANALYTICS_DB_PASSWORD"
    },
    "permissions": {
      "read_only": true,
      "allowed_schemas": ["public", "analytics"],
      "allowed_tables": ["users", "events", "metrics"],
      "row_limit": 10000,
      "query_timeout": 30
    }
  }
}

Slack Workspace Integration

{
  "name": "team-slack",
  "description": "Team Slack workspace for communication",
  "server_type": "slack",
  "config": {
    "workspace": "your-team.slack.com",
    "authentication": {
      "type": "oauth",
      "bot_token_env": "SLACK_BOT_TOKEN",
      "scopes": ["channels:read", "chat:write", "files:read"]
    },
    "resources": {
      "channels": ["#general", "#development", "#support"],
      "include_dms": false,
      "include_files": true,
      "history_limit": 1000
    },
    "tools": [
      "send_message",
      "upload_file",
      "search_messages"
    ]
  }
}

Advanced Configuration

Custom MCP Servers

Connect to any REST API as an MCP server
{
  "name": "custom-api",
  "server_type": "rest_api",
  "config": {
    "base_url": "https://api.yourcompany.com",
    "authentication": {
      "type": "api_key",
      "key_env": "CUSTOM_API_KEY",
      "header": "X-API-Key"
    },
    "endpoints": [
      {
        "name": "get_users",
        "method": "GET",
        "path": "/users",
        "description": "Retrieve user list"
      },
      {
        "name": "create_ticket",
        "method": "POST", 
        "path": "/tickets",
        "description": "Create support ticket"
      }
    ]
  }
}
Connect to local or network file systems
{
  "name": "document-storage",
  "server_type": "filesystem",
  "config": {
    "root_path": "/data/documents",
    "permissions": {
      "read_only": true,
      "allowed_extensions": [".txt", ".md", ".pdf", ".docx"],
      "max_file_size": "10MB"
    },
    "indexing": {
      "enable_search": true,
      "index_content": true,
      "update_interval": "1h"
    }
  }
}
Real-time data streaming
{
  "name": "live-data-feed",
  "server_type": "websocket",
  "config": {
    "url": "wss://data.yourcompany.com/stream",
    "authentication": {
      "type": "token",
      "token_env": "STREAM_TOKEN"
    },
    "subscription": {
      "topics": ["user_events", "system_metrics"],
      "buffer_size": 1000,
      "max_age": "5m"
    }
  }
}

Environment Variables

Secure credential management using environment variables:
Set up environment variables for development
# Create .env file
cat > .env << EOF
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_secret
DB_PASSWORD=your_database_password
SLACK_BOT_TOKEN=xoxb-your-slack-token
CUSTOM_API_KEY=your_custom_api_key
EOF

# Load environment variables
source .env

Monitoring and Debugging

Connection Health

Health Checks

Automatic health monitoring for all MCP connections with alerts.

Performance Metrics

Track response times, success rates, and resource utilization.

Error Logging

Comprehensive error logging and debugging information.

Usage Analytics

Detailed analytics on MCP resource usage and optimization opportunities.

Troubleshooting

Common connection issues and solutionsSymptoms: MCP server not responding or timing outSolutions:
  • Verify network connectivity to target services
  • Check authentication credentials and permissions
  • Validate JSON configuration syntax
  • Review firewall and security group settings
  • Test credentials independently outside MCP
Authentication and authorization problemsSymptoms: “Unauthorized” or “Forbidden” errorsSolutions:
  • Verify API keys or OAuth tokens are current
  • Check required scopes and permissions
  • Ensure environment variables are set correctly
  • Test authentication with provider’s API directly
  • Review rate limiting and quota restrictions
Slow response times or timeoutsSymptoms: Long delays or timeout errorsSolutions:
  • Optimize database queries and add indexes
  • Implement caching for frequently accessed data
  • Reduce result set sizes with filters
  • Use connection pooling for database connections
  • Configure appropriate timeout values

Best Practices

Security First

Always use least-privilege access and secure credential storage.

Performance Optimization

Implement caching, connection pooling, and result limiting for better performance.

Error Handling

Design robust error handling and fallback mechanisms for production use.

Monitoring

Set up comprehensive monitoring and alerting for all MCP connections.

Next Steps