Installation
Using uvx (Recommended)
Using pip
From Source
git clone https://github.com/CorrData/corrdata-mcp
cd corrdata-mcp
pip install -e .
Configuration
Environment Variables
| Variable | Required | Description |
|---|
CORRDATA_API_URL | Yes | GraphQL API endpoint |
CORRDATA_API_KEY | Yes | Your API key |
CORRDATA_TENANT_ID | No | Specific tenant (for multi-tenant) |
CORRDATA_LOG_LEVEL | No | Logging level (DEBUG, INFO, WARN) |
Claude Desktop Configuration
Add to ~/.config/claude/claude_desktop_config.json (Linux/Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"corrdata": {
"command": "uvx",
"args": ["corrdata-mcp"],
"env": {
"CORRDATA_API_URL": "https://api.corrdata.com/graphql",
"CORRDATA_API_KEY": "sk_live_xxxxx"
}
}
}
}
Claude Code Configuration
For Claude Code (CLI), add to your project’s .mcp.json:
{
"servers": {
"corrdata": {
"command": "uvx",
"args": ["corrdata-mcp"],
"env": {
"CORRDATA_API_URL": "https://api.corrdata.com/graphql",
"CORRDATA_API_KEY": "${CORRDATA_API_KEY}"
}
}
}
}
Never commit API keys to version control. Use environment variables or secrets management.
Security
API Key Scopes
CorrData API keys can be scoped to specific permissions:
| Scope | Description |
|---|
assets:read | Read asset data |
assets:write | Create/update assets |
measurements:read | Read measurement data |
compliance:read | Read compliance status |
admin:* | Full administrative access |
Rate Limits
| Tier | Requests/minute | Requests/day |
|---|
| Free | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | Unlimited | Unlimited |
Troubleshooting
Connection Issues
# Test the connection
curl -H "Authorization: Bearer $CORRDATA_API_KEY" \
https://api.corrdata.com/graphql \
-d '{"query": "{ __typename }"}'
Debug Mode
Enable debug logging:
{
"mcpServers": {
"corrdata": {
"command": "uvx",
"args": ["corrdata-mcp"],
"env": {
"CORRDATA_API_URL": "https://api.corrdata.com/graphql",
"CORRDATA_API_KEY": "your-key",
"CORRDATA_LOG_LEVEL": "DEBUG"
}
}
}
}
Common Errors
| Error | Cause | Solution |
|---|
401 Unauthorized | Invalid API key | Check API key in dashboard |
403 Forbidden | Insufficient permissions | Request additional scopes |
429 Too Many Requests | Rate limited | Reduce request frequency |
Connection refused | Server unreachable | Check network/firewall |
