Documentation
Home Getting Started MCP Integration Security Detection Subscription & Billing API Reference Troubleshooting

MCP Server Integration

Connect your Model Context Protocol servers for comprehensive monitoring and security analysis.

Integration Methods

Webhook Integration

Real-time event streaming from your MCP server to Sentinel.

  • Instant threat detection
  • Low latency monitoring
  • Automatic retry handling
Setup Guide
Log Upload

Batch processing of MCP log files for analysis.

  • Historical data analysis
  • Forensic investigation
  • Bulk threat assessment
Upload Logs

Webhook Setup

Step 1: Add Server

Register your MCP server in the Sentinel dashboard:

  1. Go to My Servers
  2. Click "Add New Server"
  3. Provide server details and endpoint URL
  4. Configure authentication if required

Step 2: Configure Webhook

Once added, you'll receive a unique webhook URL:

Webhook URL Format:
https://your-domain.replit.app/api/mcp/webhook/[SERVER_ID]

Step 3: Server Configuration

Configure your MCP server to send events to the webhook URL. The expected JSON format:

{
  "timestamp": "2023-12-01T10:30:00Z",
  "user": "user@example.com",
  "agent": "claude-3",
  "tool": "filesystem",
  "prompt": "Read the configuration file",
  "response": "File contents: {...}",
  "metadata": {
    "file_path": "/etc/config.json",
    "operation": "read"
  }
}

Server Types

File System

Monitor file operations, directory traversal, and data access patterns.

Database

Track SQL queries, data modifications, and access control violations.

Web API

Monitor HTTP requests, API calls, and external service interactions.

Authentication & Security

Webhook Authentication

Secure your webhook endpoints with optional authentication:

  • API Key: Include in Authorization header
  • HMAC Signature: Verify payload integrity
  • IP Allowlist: Restrict source addresses

Data Privacy

Control what data is sent to Sentinel:

  • Filter sensitive information before transmission
  • Encrypt payloads for additional security
  • Configure data retention policies

Testing & Validation

Use our built-in tools to test your integration:

Connection Test

Verify webhook connectivity and authentication.

Test Connection
Demo Environment

Explore with pre-configured sample servers.

Setup Demo

Best Practices

Performance Optimization

  • Batch multiple events when possible
  • Implement proper retry logic with exponential backoff
  • Monitor webhook response times and success rates
  • Use compression for large payloads

Error Handling

  • Log failed webhook attempts locally
  • Implement dead letter queues for failed events
  • Set up monitoring for webhook health
  • Have fallback procedures for extended outages

Troubleshooting

Common Issues
  • Webhook timeouts: Check network connectivity and response times
  • Authentication failures: Verify API keys and signatures
  • Missing events: Ensure proper error handling and retry logic
  • Format errors: Validate JSON payload structure

For additional help, see our troubleshooting guide or contact support.