MCP (Model Context Protocol) Integration

Use ChangeCrab from Cursor, Claude Desktop, and other AI tools via the Model Context Protocol (MCP). List changelogs, create and update posts, and get product info—all from chat.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. The ChangeCrab MCP server exposes your changelog management capabilities to AI tools, so you can manage your changelog directly from your IDE or chat interface.

Prerequisites

• Node.js 18+ (for running the MCP server)
• ChangeCrab account with an active subscription or trial (API access is paid-only)
• API key from your ChangeCrab dashboard (see API Keys Management)

Getting an API Key

1. Log in to ChangeCrab
2. Go to Settings → API Keys (requires a paid or trial plan)
3. Create a new API key and copy it

Installation

Option 1: Run with npx (recommended)

Once the package is published, add the server to your MCP config. Cursor or Claude will run it via npx changecrab-mcp-server.

Option 2: Run from source

cd mcp-server
npm install
npm run build

Then use the full path to the built file in your MCP config.

Configuration

Cursor

Create or edit .cursor/mcp.json in your project, or ~/.cursor/mcp.json for global config:

{
  "mcpServers": {
    "changecrab": {
      "command": "npx",
      "args": ["-y", "changecrab-mcp-server"],
      "env": {
        "CHANGECRAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "changecrab": {
      "command": "npx",
      "args": ["-y", "changecrab-mcp-server"],
      "env": {
        "CHANGECRAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace your-api-key-here with your actual API key. Restart Cursor or Claude after changing the config.

Available Tools

API tools (require API key)

Tool	Description
list_changelogs	List all changelogs. Optional: filter by team_id.
get_changelog	Get details of a changelog by access ID.
list_categories	List categories for a changelog.
list_posts	List posts for a changelog (newest first).
create_post	Create a new post (summary, markdown, optional categories).
update_post	Update an existing post.
delete_post	Delete a post.

Info tools (static, no API key needed)

• get_changecrab_overview – What ChangeCrab is, features, workflows
• get_changecrab_api_info – API auth, availability, docs link
• get_changecrab_limits_summary – Free vs paid limits, API access

Example Prompts

• "List my ChangeCrab changelogs"
• "What are the latest posts in my main changelog?"
• "Create a changelog post for the new login feature: summary 'Improved login flow', markdown with bullet points"
• "What is ChangeCrab and how do I use it?"
• "Do I need a paid plan to use the ChangeCrab API?"

Changelog ID

Many tools require a changelog ID (also called access ID). You can find it by:

• Using list_changelogs to see all your changelogs and their IDs
• Checking your changelog URL (e.g. youraccount.changecrab.com or your custom domain)—the ID is in your changelog settings

Troubleshooting

"CHANGECRAB_API_KEY is required"

Set CHANGECRAB_API_KEY in the env section of your MCP config. Cursor/Claude pass this to the server when they start it.

"Invalid or missing API key" (401)

• Check that the key is correct and has no extra spaces
• Ensure your account has an active subscription or trial
• Create a new key in the dashboard if needed

"Subscription required" (403)

The API is only available on paid and trial plans. Upgrade or start a trial in your ChangeCrab billing settings.

Tools don't appear in Cursor

1. Restart Cursor after editing mcp.json
2. Confirm the config path (project .cursor/mcp.json or global ~/.cursor/mcp.json)
3. Check Cursor's MCP settings to see if the server is listed and has errors

Next Steps

• ChangeCrab API Overview – REST API reference
• API Authentication – Detailed auth guide
• Manage Posts via API – Working with entries
• API Keys Management – Managing your keys