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:
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:
{
"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:
{
"mcpServers": {
"nitrozen": {
"url": "https://mcp.nitrozen.io/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}Windsurf
Add to ~/.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:
{
"servers": {
"nitrozen": {
"type": "http",
"url": "https://mcp.nitrozen.io/mcp",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}Zed
Add to your Zed 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:
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.
