Docs / MCP Server

MCP Server

Connect your AI assistant to Nitrozen and manage your changelog with natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external services. Once connected, your assistant can read and manage your Nitrozen projects and entries on your behalf — no copy-pasting, no manual API calls.

The Nitrozen MCP server is hosted at https://mcp.nitrozen.io/mcp and works with Claude.ai, Claude Code, Cursor, Windsurf, VS Code, Zed, and any MCP-compatible client.

Connect to Claude.ai

Claude.ai supports full OAuth — no API token needed. Just add the server URL and authorize.

1 Go to claude.ai → Settings → Integrations
2 Click Add Integration and enter the server URL:

https://mcp.nitrozen.io/mcp

3 Claude will redirect you to nitrozen.io to sign in and authorize access
4 Click Authorize — you're connected

Connect from other clients

Other MCP clients use an API token instead of OAuth. Get yours from the API Tokens page and use it as the Bearer token in the configurations below.

Claude Code

Run this command in your terminal:

bash

claude mcp add --transport http nitrozen https://mcp.nitrozen.io/mcp \
  --header "Authorization: Bearer <your-api-token>"

Or add it manually to your project's .mcp.json:

.mcp.json

{
  "mcpServers": {
    "nitrozen": {
      "type": "http",
      "url": "https://mcp.nitrozen.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

~/.cursor/mcp.json

{
  "mcpServers": {
    "nitrozen": {
      "url": "https://mcp.nitrozen.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_settings.json:

~/.codeium/windsurf/mcp_settings.json

{
  "mcpServers": {
    "nitrozen": {
      "url": "https://mcp.nitrozen.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

VS Code

Requires GitHub Copilot with agent mode enabled. Add to .vscode/mcp.json in your workspace:

.vscode/mcp.json

{
  "servers": {
    "nitrozen": {
      "type": "http",
      "url": "https://mcp.nitrozen.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Zed

Add to your Zed settings.json:

settings.json

{
  "context_servers": {
    "nitrozen": {
      "url": "https://mcp.nitrozen.io/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Custom apps (MCP SDK)

Use the official MCP TypeScript SDK to connect programmatically:

typescript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-app", version: "1.0.0" });

await client.connect(
  new StreamableHTTPClientTransport(
    new URL("https://mcp.nitrozen.io/mcp"),
    { headers: { Authorization: "Bearer <your-api-token>" } }
  )
);

const result = await client.callTool({ name: "list_projects", arguments: {} });
console.log(result);

Available Tools

The server exposes 16 tools covering the full Nitrozen API:

Projects

list_projects	List all your changelog projects
create_project	Create a new project
get_project	Get a project by ID
update_project	Update a project's name or description
delete_project	Delete a project and all its entries

Entries

list_entries	List entries for a project (paginated)
create_entry	Create a new changelog entry
get_entry	Get an entry by ID
update_entry	Update an entry's content, category, or publish status
delete_entry	Delete an entry

Account

get_user	Get your profile and plan details
get_usage	Get usage statistics and plan limits
list_tokens	List your API tokens
create_token	Create a new API token
revoke_token	Revoke an API token by ID

Public

get_public_entries

List published entries by project slug (no auth required)

Example Prompts

Once connected, try asking your assistant:

› "List my Nitrozen projects"
› "Create a changelog entry for my app: we just shipped dark mode"
› "Show me the last 5 entries for my main project"
› "Publish the draft entry I created earlier"
› "How many entries have I created this month?"
› "Write and publish a new announcement for our v2.0 release"

Authentication

The Nitrozen MCP server supports two authentication methods:

OAuth 2.0 Used by Claude.ai. The client handles the login and authorization flow automatically — no tokens to manage.
API Token Used by all other clients. Generate a token from the API Tokens page and pass it as Authorization: Bearer <token>.

You can revoke access at any time from the API Tokens page.