Developer Overview
Connect AI assistants, build integrations, and automate workflows with the Shocking Energy developer platform.
Shocking Energy provides a developer platform for connecting AI assistants and building integrations with your team data. The platform offers three access methods depending on your use case.
Access methods
MCP Integration
Connect AI assistants like Claude, Cursor, and other MCP-compatible tools to query and manage your team data through tools, resources, and prompts.
REST API
A versioned HTTP API for building custom integrations, dashboards, and automation workflows.
OAuth Applications
Register OAuth 2.1 applications to let third-party services access your team data with user-approved permissions.
Authentication
All API access requires authentication. Two methods are supported:
API keys
API keys are the simplest way to authenticate. Create them from Settings > Developer > API Keys.
- Keys use the
se_*prefix - Pass via the
Authorization: Bearer se_...header - Each key is scoped to a team
- Keys can be assigned specific permission scopes or default to full access
OAuth tokens
OAuth 2.1 tokens are issued through the authorization code flow. They are ideal for third-party integrations where a user approves access.
- Claude.ai uses OAuth automatically (no API key needed)
- Tokens include a refresh token for long-lived access
- Scopes are approved by the user during the consent flow
See Permissions and Scopes for a full reference of available scopes and how they control access.
Getting started
Enable MCP (optional)
Go to Settings > MCP and toggle MCP on. This is required for AI assistant connections but not for REST API usage.
Create an API key
Go to Settings > Developer > API Keys and create a new key. Choose the scopes your integration needs. Copy the key immediately — it is only shown once.
Connect or integrate
Follow the MCP setup guide to connect an AI assistant, or use the REST API to build a custom integration.