Commons
Documentation

Integrations

Commons connects to the tools your team already uses. Set up integrations from your organization settings.

Claude (MCP)

Connect Commons to Claude Desktop, Claude Code, Cursor, or any AI assistant that supports the Model Context Protocol (MCP).

What it does

Once connected, you can ask Claude questions about your organization in natural language:

  • "What's the status of the Platform team's active projects?"
  • "Summarize yesterday's standup for the Mobile team"
  • "What action items are still pending?"
  • "Give me a weekly status report"

Claude accesses 26 tools covering teams, projects, updates, comments, standups, retros, design critiques, rollups, members, action items, and more.

Setup

  1. Go to Settings > API Keys and create an API key with the "MCP Server" permission preset:
    • User Key (dc_) — for personal use with Claude Desktop or Claude Code. Actions are attributed to you.
    • Service Key (dc_svc_) — for shared automations or bots. Actions show as "Service Bot."
  2. Add the connector to your MCP client config:
{
  "mcpServers": {
    "designcommons": {
      "url": "https://trycommons.com/api/mcp/http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
  1. Start asking Claude about your teams and projects

For the full setup guide, see the Claude integration page.

Permissions

The MCP server respects your API key permissions. The "MCP Server" preset includes read access to teams, projects, updates, and users, plus write access for creating updates and comments.

Slack

Get real-time notifications in Slack when your team shares updates, comments, or completes standups.

What it does

  • Automatic notifications when updates are posted
  • Standup submission and summary alerts
  • Comment and reaction notifications
  • Rollup and project update alerts
  • Configurable per-channel routing

Setup

  1. Click Add to Slack from Settings > Integrations or the Slack integration page
  2. Authorize Commons in your Slack workspace
  3. Configure which channels receive which notification types

You can route different notification types to different channels (e.g., standups to #standups, project updates to #design-updates).

Figma

Share designs directly from Figma to Commons using the Figma plugin.

What it does

  • Post design screenshots from Figma to your Commons feed
  • Include frames, components, or full pages
  • Add context and notes alongside your designs
  • Embed live Figma previews in project updates

Setup

  1. Install the Commons plugin from Figma Community
  2. Create an API key in Settings > API Keys
  3. Authorize the plugin with your key
  4. Select frames in Figma and share them to your team

API Keys

All integrations authenticate using API keys, created in Settings > API Keys.

Key types

| Type | Prefix | Best for | |------|--------|----------| | Service Key | dc_svc_ | Integrations (MCP, bots, CI/CD). Shows as "Service Bot." | | User Key | dc_ | Personal tools. Actions attributed to you. |

Permission presets

  • MCP Server — Read teams, projects, updates, users. Write updates and comments.
  • Custom — Select individual permissions for specific use cases.

Keys can be rotated or revoked at any time from organization settings.