Back to Help Center
AI & MCP

MCP Authentication

How to authenticate AI agents with Statly

MCP Authentication

Authenticate your AI assistant to access your organization's data.

Without Authentication

Documentation tools work immediately without any API key:

  • Search docs
  • Get SDK references
  • Find code examples

Rate limit: 100 requests per minute per IP.

With API Key

For accessing monitors, incidents, and other organization data:

Step 1: Create an API Key

  1. Go to Settings > API Keys
  2. Click Create API Key
  3. Choose permissions (Full Access or Read Only)
  4. Copy the key (shown only once)

Step 2: Add to Configuration

{ "mcpServers": { "statly": { "url": "https://mcp.statly.live/mcp", "transport": "streamable-http", "headers": { "Authorization": "Bearer sk_live_your_api_key" } } } }

Device Authorization Flow

For interactive setup without manual key copying:

  1. Your AI client requests a device code
  2. Visit statly.live/mcp/authorize
  3. Enter the displayed code
  4. Select permissions to grant
  5. The AI client automatically receives authorization

Permission Scopes

API keys can have granular permissions:

  • Full Access - Read and write all resources
  • Read Only - View data, no modifications
  • Custom - Per-resource permissions (monitors, incidents, etc.)

Security Tips

  • Never commit API keys to version control
  • Use environment variables when possible
  • Rotate keys periodically
  • Use minimum required permissions

Related Topics

Was this helpful?

Help us improve our documentation